django入门 -- 简单流程

时间:2022-04-14 08:46:22

django入门 -- 简单流程

简介

  • 通过简单示例,使用django完成基本流程的开发,学习django的主要的知识点,在后续课程中会逐个知识点进行深入讲解
  • 以“图书-英雄”管理为示例

主要知识点介绍

  • 环境搭建
  • 定义模型
  • 使用后台管理
  • 编写视图
  • 定义模板

这里简单的演示完成一个 django 大概流程,后面会有详细解释

搭建开发环境

以下使用的是 ubuntu 系统

在生产环境中,有的时候,我们开发的项目可能用的是几个不同的 环境,所以通常我们会创建虚拟环境,在虚拟环境中安装我们需要的 配置,这里从配置虚拟环境开始

创建虚拟环境

  • 创建:mkvirtualenv [虚拟环境名称]
  • 删除:rmvirtualenv [虚拟环境名称]
  • 进入:workon [虚拟环境名称]
  • 退出:deactivate
  • 所有的虚拟环境,都位于/home/.virtualenvs目录下
  • 进入虚拟环境前的提示:

django入门 -- 简单流程

  • 进入虚拟环境后的提示:

django入门 -- 简单流程

  • 查看当前的所有虚拟环境:workon [两次tab键]
  • 查看虚拟环境中已经安装的包
pip list
pip freeze

  

安装django

  • 建议安装1.8.2版本,这是一个稳定性高、使用广、文档多的版本
pip install django==1.8.2
  • 查看版本:进入python shell,运行如下代码
import django
django.get_version()
  • 说明:使用pip install django命令进行安装时,会自动删除旧版本,再安装新版本

创建项目

  • 命令django-admin startproject test1
  • 进入test1目录,目录结构如下图:

django入门 -- 简单流程

目录说明

  • manage.py:一个命令行工具,可以使你用多种方式对Django项目进行交互
  • 内层的目录:项目的真正的Python包
  • _init _.py:一个空文件,它告诉Python这个目录应该被看做一个Python包
  • settings.py:项目的配置
  • urls.py:项目的URL声明
  • wsgi.py:项目与WSGI兼容的Web服务器入口

设计模型

表格需求:略

  • 本示例完成“图书-英雄”信息的维护,需要存储两种数据:图书、英雄
  • 图书表结构设计:
    • 表名:BookInfo
    • 图书名称:btitle
    • 图书发布时间:bpub_date
  • 英雄表结构设计:
    • 表名:HeroInfo
    • 英雄姓名:hname
    • 英雄性别:hgender
    • 英雄简介:hcontent
    • 所属图书:hbook
  • 图书-英雄的关系为一对多

数据库配置

  • 在settings.py文件中,通过DATABASES项进行数据库设置
  • django支持的数据库包括:sqlite、mysql等主流数据库
  • Django默认使用SQLite数据库
python manage.py startapp booktest
  • 应用的目录结构如下图

django入门 -- 简单流程

定义模型类

  • 有一个数据表,就有一个模型类与之对应
  • 打开models.py文件,定义模型类
  • 引入包from django.db import models
  • 模型类继承自models.Model类
  • 说明:不需要定义主键列,在生成时会自动添加,并且值为自动增长
  • 当输出对象时,会调用对象的str方法(也就是说,你可以定义一个 str 方法,在里面写入自己想要输出的内容)
from django.db import models

class BookInfo(models.Model):
btitle = models.CharField(max_length=20)
bpub_date = models.DateTimeField()
def _ _str_ _(self):
return "%d" % self.pk class HeroInfo(models.Model):
hname = models.CharField(max_length=20)
hgender = models.BooleanField()
hcontent = models.CharField(max_length=100)
hBook = models.ForeignKey('BookInfo')
# 上面创建了管理,外键 默认为对方的 主键
def _ _str_ _(self):
return "%d" % self.pk # 这里创建了两个类,分别继承了 django.db 中的 models.Model 类,表示需要生成表头
# 定义 str 方法,表示默认输出

生成数据表

  • 激活模型:编辑settings.py文件,将booktest应用加入到installed_apps中

django入门 -- 简单流程

  • 生成迁移文件:根据模型类生成sql语句
python manage.py makemigrations
# 表的字段(表头)无论是增加删除还是类型改变后,都应该重新迁移
  • 迁移文件被生成到应用的migrations目录

django入门 -- 简单流程

  • 执行迁移:执行sql语句生成数据表
python manage.py migrate

测试数据操作

  • 引入需要的包:
from booktest.models import BookInfo,HeroInfo
from django.utils import timezone
from datetime import *
  • 查询所有图书信息:
BookInfo.objects.all()
  • 新建图书信息:
b = BookInfo()
b.btitle="射雕英雄传"
b.bpub_date=datetime(year=1990,month=1,day=10)
b.save()
# 其它方式后面介绍
  • 查找图书信息:
b=BookInfo.objects.get(pk=1)
# pk 代表的是 主键 的意思,这里代指 id
  • 修改图书信息:
b.btitle=u"天龙八部"
b.save()
  • 删除图书信息:
b.delete()

关联对象的操作

  • 对于HeroInfo可以按照上面的操作方式进行
  • 添加,注意添加关联对象
h=HeroInfo()
h.htitle=u'郭靖'
h.hgender=True
h.hcontent=u'降龙十八掌'
h.hBook=b
h.save()

 

管理站点

服务器

  • 运行如下命令可以开启服务器
python manage.py runserver ip:port
  • 可以不写ip,默认端口为8000
  • 这是一个纯python编写的轻量级web服务器,仅在开发阶段使用
  • 服务器成功启动后,提示如下信息

django入门 -- 简单流程

  • 默认端口是8000,可以修改端口
python manage.py runserver 8080
  • 打开浏览器,输入网址“127.0.0.1:8000”可以打开默认页面
  • 如果修改文件不需要重启服务器,如果增删文件需要重启服务器
  • 通过ctrl+c停止服务器

管理操作

  • 站点分为“内容发布”和“公共访问”两部分
  • “内容发布”的部分负责添加、修改、删除内容,开发这些重复的功能是一件单调乏味、缺乏创造力的工作。为此,Django会根据定义的模型类完全自动地生成管理模块

使用django的管理

  • 创建一个管理员用户
python manage.py createsuperuser,按提示输入用户名、邮箱、密码
  • 启动服务器,通过“127.0.0.1:8000/admin”访问,输入上面创建的用户名、密码完成登录
  • 进入管理站点,默认可以对groups、users进行管理

管理界面本地化

  • 编辑settings.py文件,设置编码、时区
LANGUAGE_CODE = 'zh-Hans'
TIME_ZONE = 'Asia/Shanghai'

向admin注册booktest的模型

  • 打开booktest/admin.py文件,注册模型
from django.contrib import admin
from models import BookInfo
admin.site.register(BookInfo)
  • 刷新管理页面,可以对BookInfo的数据进行增删改查操作
  • 问题:如果在str方法中返回中文,在修改和添加时会报ascii的错误
  • 解决:在str()方法中,将字符串末尾添加“.encode('utf-8')”

自定义管理页面

  • Django提供了admin.ModelAdmin类
  • 通过定义ModelAdmin的子类,来定义模型在Admin界面的显示方式
class QuestionAdmin(admin.ModelAdmin):
...
admin.site.register(Question, QuestionAdmin)
列表页属性
  • list_display:显示字段,可以点击列头进行排序
list_display = ['pk', 'btitle', 'bpub_date']
  • list_filter:过滤字段,过滤框会出现在右侧
list_filter = ['btitle']
  • search_fields:搜索字段,搜索框会出现在上侧
search_fields = ['btitle']
  • list_per_page:分页,分页框会出现在下侧
list_per_page = 10
添加、修改页属性
  • fields:属性的先后顺序
fields = ['bpub_date', 'btitle']
  • fieldsets:属性分组
fieldsets = [
('basic',{'fields': ['btitle']}),
('more', {'fields': ['bpub_date']}),
]

关联对象

  • 对于HeroInfo模型类,有两种注册方式

    • 方式一:与BookInfo模型类相同
    • 方式二:关联注册
  • 按照BookInfor的注册方式完成HeroInfo的注册

  • 接下来实现关联注册
from django.contrib import admin
from models import BookInfo,HeroInfo class HeroInfoInline(admin.StackedInline):
model = HeroInfo
extra = 2 class BookInfoAdmin(admin.ModelAdmin):
inlines = [HeroInfoInline] admin.site.register(BookInfo, BookInfoAdmin)
  • 可以将内嵌的方式改为表格
class HeroInfoInline(admin.TabularInline)

布尔值的显示

  • 发布性别的显示不是一个直观的结果,可以使用方法进行封装
def gender(self):
if self.hgender:
return '男'
else:
return '女'
gender.short_description = '性别'
  • 在admin注册中使用gender代替hgender
class HeroInfoAdmin(admin.ModelAdmin):
list_display = ['id', 'hname', 'gender', 'hcontent']

  

视图

  • 在django中,视图对WEB请求进行回应
  • 视图接收reqeust对象作为第一个参数,包含了请求的信息
  • 视图就是一个Python函数,被定义在views.py中
#coding:utf-8
from django.http import HttpResponse def index(request):
return HttpResponse("index")
def detail(request,id):
return HttpResponse("detail %s" % id)
  • 定义完成视图后,需要配置urlconf,否则无法处理请求

URLconf

  • 在Django中,定义URLconf包括正则表达式、视图两部分
  • Django使用正则表达式匹配请求的URL,一旦匹配成功,则调用应用的视图
  • 注意:只匹配路径部分,即除去域名、参数后的字符串
  • 在test1/urls.py插入booktest,使主urlconf连接到booktest.urls模块
url(r'^', include('booktest.urls')),
  • 在booktest中的urls.py中添加urlconf
from django.conf.urls import url
from . import views
urlpatterns = [
url(r'^$', views.index),
url(r'^([0-9]+)/$', views.detail),
]

  

模板

  • 模板是html页面,可以根据视图中传递的数据填充值
  • 创建模板的目录如下图:

django入门 -- 简单流程

  • 修改settings.py文件,设置TEMPLATES的DIRS值
'DIRS': [os.path.join(BASE_DIR, 'templates')],
  • 在模板中访问视图传递的数据
{{输出值,可以是变量,也可以是对象.属性}}
{%执行代码段%}

定义index.html模板

<!DOCTYPE html>
<html>
<head>
<title>首页</title>
</head>
<body>
<h1>图书列表</h1>
<ul>
{%for book in booklist%}
<li>
<a href="{{book.id}}">
{{book.btitle}}
</a>
</li>
{%endfor%}
</ul>
</body>
</html>

定义detail.html模板

  • 在模板中访问对象成员时,都以属性的方式访问,即方法也不能加括号
<!DOCTYPE html>
<html>
<head>
<title>详细页</title>
</head>
<body>
<h1>{{book.btitle}}</h1>
<ul>
{%for hero in book.heroinfo_set.all%}
<li>{{hero.hname}}---{{hero.hcontent}}</li>
{%endfor%}
</ul>
</body>
</html>

使用模板

  • 编辑views.py文件,在方法中调用模板
from django.http import HttpResponse
from django.template import RequestContext, loader
from models import BookInfo def index(request):
booklist = BookInfo.objects.all()
template = loader.get_template('booktest/index.html')
context = RequestContext(request, {'booklist': booklist})
return HttpResponse(template.render(context)) def detail(reqeust, id):
book = BookInfo.objects.get(pk=id)
template = loader.get_template('booktest/detail.html')
context = RequestContext(reqeust, {'book': book})
return HttpResponse(template.render(context))

去除模板的硬编码

  • 在index.html模板中,超链接是硬编码的,此时的请求地址为“127.0.0.1/1/”
<a href="{{book.id}}">
  • 看如下情况:将urlconf中详细页改为如下,链接就找不到了
url(r'^book/([0-9]+)/$', views.detail),
  • 此时的请求地址应该为“127.0.0.1/book/1/”
  • 问题总结:如果在模板中地址硬编码,将来urlconf修改后,地址将失效
  • 解决:使用命名的url设置超链接
  • 修改test1/urls.py文件,在include中设置namespace
url(r'^admin/', include(admin.site.urls, namespace='booktest')),
  • 修改booktest/urls.py文件,设置name
url(r'^book/([0-9]+)/$', views.detail, name="detail"),
  • 修改index.html模板中的链接
<a href="{%url 'booktest:detail' book.id%}">

Render简写

  • Django提供了函数Render()简化视图调用模板、构造上下文
from django.shortcuts import render
from models import BookInfo def index(reqeust):
booklist = BookInfo.objects.all()
return render(reqeust, 'booktest/index.html', {'booklist': booklist}) def detail(reqeust, id):
book = BookInfo.objects.get(pk=id)
return render(reqeust, 'booktest/detail.html', {'book': book})

  

总结

  1. 安装配置django运行的环境
  2. 编写模型,使用简单API与数据库交互
  3. 使用django的后台管理中维护数据
  4. 通过视图接收请求,通过模型获取数据,展示出来
  5. 调用模板完成展示