更新了Django部分的文档

pull/14/merge
jackfrued 2018-07-08 22:43:08 +08:00
parent f3ec671456
commit acaf60ab5b
4 changed files with 86 additions and 35 deletions

View File

@ -214,6 +214,7 @@ Django诞生于2003年它是一个在真正的应用中成长起来的项目
- `models.py`存放应用的数据模型即实体类及其之间的关系MVC/MVT中的M - `models.py`存放应用的数据模型即实体类及其之间的关系MVC/MVT中的M
- `tests.py`:包含测试应用各项功能的测试类和测试函数。 - `tests.py`:包含测试应用各项功能的测试类和测试函数。
- `views.py`处理请求并返回响应的函数MVC中的CMVT中的V - `views.py`处理请求并返回响应的函数MVC中的CMVT中的V
2. 进入应用目录修改视图文件views.py。 2. 进入应用目录修改视图文件views.py。
```Shell ```Shell
@ -294,12 +295,15 @@ Django诞生于2003年它是一个在真正的应用中成长起来的项目
```Python ```Python
from io import StringIO
from django.http import HttpResponse from django.http import HttpResponse
from io import StringIO depts_list = [
from random import randrange {'no': 10, 'name': '财务部', 'location': '北京'},
{'no': 20, 'name': '研发部', 'location': '成都'},
fruits = ['苹果', '草莓', '榴莲', '香蕉', '葡萄', '山竹', '蓝莓', '西瓜'] {'no': 30, 'name': '销售部', 'location': '上海'},
]
def index(request): def index(request):
@ -310,19 +314,35 @@ Django诞生于2003年它是一个在真正的应用中成长起来的项目
output.write('\t<title>首页</title>') output.write('\t<title>首页</title>')
output.write('</head>\n') output.write('</head>\n')
output.write('<body>\n') output.write('<body>\n')
output.write('\t<h1>Hello, world!</h1>\n') output.write('\t<h1>部门信息</h1>\n')
output.write('\t<hr>\n') output.write('\t<hr>\n')
output.write('\t<ol>\n') output.write('\t<table>\n')
for _ in range(3): output.write('\t\t<tr>\n')
rindex = randrange(0, len(fruits)) output.write('\t\t\t<th>部门编号</th>\n')
output.write('\t\t<li>' + fruits[rindex] + '</li>\n') output.write('\t\t\t<th>部门名称</th>\n')
output.write('\t</ol>\n') output.write('\t\t\t<th>所在地</th>\n')
output.write('\t\t</tr>\n')
for dept in depts_list:
output.write('\t\t<tr>\n')
output.write(f'\t\t\t<td>{dept["no"]}</td>\n')
output.write(f'\t\t\t<td>{dept["name"]}</td>\n')
output.write(f'\t\t\t<td>{dept["location"]}</td>\n')
output.write('\t\t</tr>\n')
output.write('\t</table>\n')
output.write('</body>\n') output.write('</body>\n')
output.write('</html>\n') output.write('</html>\n')
return HttpResponse(output.getvalue()) return HttpResponse(output.getvalue())
``` ```
7. 再次使用下面的命令来启动服务器并查看程序的运行结果。
```Shell
(venv)$ cd ..
(venv)$ python manage.py runserver
```
![](./res/runserver.png)
#### 使用视图模板 #### 使用视图模板
上面通过拼接HTML代码的方式生成动态视图的做法在实际开发中是无能接受的这一点我相信是不言而喻的。为了解决这个问题我们可以提前准备一个模板页所谓模板页就是一个带占位符的HTML页面当我们将程序中获得的数据替换掉页面中的占位符时一个动态页面就产生了。 上面通过拼接HTML代码的方式生成动态视图的做法在实际开发中是无能接受的这一点我相信是不言而喻的。为了解决这个问题我们可以提前准备一个模板页所谓模板页就是一个带占位符的HTML页面当我们将程序中获得的数据替换掉页面中的占位符时一个动态页面就产生了。
@ -354,14 +374,22 @@ Django诞生于2003年它是一个在真正的应用中成长起来的项目
<title>首页</title> <title>首页</title>
</head> </head>
<body> <body>
<h1>{{ greeting }}</h1> <h1>部门信息</h1>
<hr> <hr>
<h3>今天推荐{{ num }}种水果是:</h3> <table>
<ul> <tr>
{% for fruit in fruits %} <th>部门编号</th>
<li>{{ fruit }}</li> <th>部门名称</th>
<th>所在地</th>
</tr>
{% for dept in depts_list %}
<tr>
<td>{{ dept.no }}</td>
<td>{{ dept.name }}</td>
<td>{{ dept.location }}</td>
<tr>
{% endfor %} {% endfor %}
</ul> </table>
</body> </body>
</html> </html>
``` ```
@ -379,19 +407,16 @@ Django诞生于2003年它是一个在真正的应用中成长起来的项目
```Python ```Python
from django.shortcuts import render from django.shortcuts import render
from random import randrange
depts_list = [
{'no': 10, 'name': '财务部', 'location': '北京'},
{'no': 20, 'name': '研发部', 'location': '成都'},
{'no': 30, 'name': '销售部', 'location': '上海'},
]
def index(request): def index(request):
fruits = ['苹果', '香蕉', '草莓', '葡萄', '山竹', '杨梅', '西瓜', '榴莲'] return render(request, 'index.html', {'depts_list': depts_list})
start, end = 0, randrange(len(fruits))
ctx = {
'greeting': 'Hello, Django!',
'num': end + 1,
'fruits': fruits[start:end + 1]
}
return render(request, 'index.html', ctx)
``` ```
到此为止我们还没有办法让views.py中的render函数找到模板文件index.html为此我们需要修改settings.py文件配置模板文件所在的路径。 到此为止我们还没有办法让views.py中的render函数找到模板文件index.html为此我们需要修改settings.py文件配置模板文件所在的路径。
@ -436,7 +461,6 @@ Django诞生于2003年它是一个在真正的应用中成长起来的项目
(venv)$ python manage.py runserver (venv)$ python manage.py runserver
``` ```
![](./res/runserver.png)
### 总结 ### 总结

View File

@ -1,9 +1,11 @@
## Django 2.x实战(02) - 深入模型 ## Django 2.x实战(02) - 深入模型
在上一个章节中我们提到了Django是基于MVC架构的Web框架MVC架构追求的是“模型”和“视图的解耦合。所谓“模型”说得更直白一些就是数据所以通常也被称作“数据模型”。在实际的项目中数据模型通常通过数据库实现持久化操作而关系型数据库在很长一段时间都是持久化的首选方案当然NoSQL的方案在今天普遍被认为是关系型数据库的一个很好的补充在下面演示的项目中我们选择使用MySQL来实现数据持久化 在上一个章节中我们提到了Django是基于MVC架构的Web框架MVC架构追求的是“模型”和“视图的解耦合。所谓“模型”说得更直白一些就是数据所以通常也被称作“数据模型”。在实际的项目中数据模型通常通过数据库实现持久化操作而关系型数据库在很长一段时间都是持久化的首选方案下面我们以MySQL为例来说明如何使用关系型数据库来实现持久化操作
### 配置关系型数据库MySQL ### 配置关系型数据库MySQL
我们继续来完善上一个章节中的OA项目首先从配置项目使用的数据库开始。
1. 进入oa文件夹修改项目的settings.py文件首先将我们之前创建的应用hrs添加已安装的项目中然后配置MySQL作为持久化方案。 1. 进入oa文件夹修改项目的settings.py文件首先将我们之前创建的应用hrs添加已安装的项目中然后配置MySQL作为持久化方案。
```Shell ```Shell
@ -49,7 +51,7 @@
其他的配置可以参考官方文档中[数据库配置](https://docs.djangoproject.com/zh-hans/2.0/ref/databases/#third-party-notes)的部分。 其他的配置可以参考官方文档中[数据库配置](https://docs.djangoproject.com/zh-hans/2.0/ref/databases/#third-party-notes)的部分。
NAME属性代表数据库的名称如果使用SQLite它对应着一个文件在这种情况下NAME的属性值应该是一个绝对路径。如果使用其他关系型数据库,还要配置对应的HOST主机、PORT端口、USER用户名、PASSWORD口令等属性。 NAME属性代表数据库的名称如果使用SQLite它对应着一个文件在这种情况下NAME的属性值应该是一个绝对路径;使用其他关系型数据库,则要配置对应的HOST主机、PORT端口、USER用户名、PASSWORD口令等属性。
2. 安装MySQL客户端工具Python 3中使用PyMySQLPython 2中用MySQLdb。 2. 安装MySQL客户端工具Python 3中使用PyMySQLPython 2中用MySQLdb。
@ -132,11 +134,11 @@
mgr = models.ForeignKey('self', on_delete=models.SET_NULL, null=True, blank=True, verbose_name='主管编号') mgr = models.ForeignKey('self', on_delete=models.SET_NULL, null=True, blank=True, verbose_name='主管编号')
sal = models.DecimalField(max_digits=7, decimal_places=2, verbose_name='月薪') sal = models.DecimalField(max_digits=7, decimal_places=2, verbose_name='月薪')
comm = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True, verbose_name='补贴') comm = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True, verbose_name='补贴')
# 多对一外键关联
dept = models.ForeignKey(Dept, db_column='dno', on_delete=models.PROTECT, verbose_name='所在部门') dept = models.ForeignKey(Dept, db_column='dno', on_delete=models.PROTECT, verbose_name='所在部门')
class Meta: class Meta:
db_table = 'tb_emp' db_table = 'tb_emp'
``` ```
> 说明上面定义模型时使用了字段类及其属性其中IntegerField对应数据库中的integer类型CharField对应数据库的varchar类型DecimalField对应数据库的decimal类型ForeignKey用来建立多对一外键关联。字段属性primary_key用于设置主键max_length用来设置字段的最大长度db_column用来设置数据库中与字段对应的列verbose_name则设置了Django后台管理系统中该字段显示的名称。如果对这些东西感到很困惑也不要紧文末提供了字段类、字段属性、元数据选项等设置的相关说明不清楚的读者可以稍后查看对应的参考指南。 > 说明上面定义模型时使用了字段类及其属性其中IntegerField对应数据库中的integer类型CharField对应数据库的varchar类型DecimalField对应数据库的decimal类型ForeignKey用来建立多对一外键关联。字段属性primary_key用于设置主键max_length用来设置字段的最大长度db_column用来设置数据库中与字段对应的列verbose_name则设置了Django后台管理系统中该字段显示的名称。如果对这些东西感到很困惑也不要紧文末提供了字段类、字段属性、元数据选项等设置的相关说明不清楚的读者可以稍后查看对应的参考指南。
@ -157,7 +159,7 @@
Applying hrs.0001_initial... OK Applying hrs.0001_initial... OK
``` ```
执行完数据迁移操作之后可以在通过图形化的MySQL客户端工具查看到E-R图实体关系图 执行完数据模型迁移操作之后可以在通过图形化的MySQL客户端工具查看到E-R图实体关系图
![](./res/er-graph.png) ![](./res/er-graph.png)
@ -435,7 +437,7 @@ Type "help", "copyright", "credits" or "license" for more information.
### Django模型最佳实践 ### Django模型最佳实践
1. 正确的模型命名和关系字段命名。 1. 正确的模型和关系字段命名。
2. 设置适当的`related_name`属性。 2. 设置适当的`related_name`属性。
3. 用`OneToOneField`代替`ForeignKeyField(unique=True)`。 3. 用`OneToOneField`代替`ForeignKeyField(unique=True)`。
4. 通过“迁移操作”migrate来添加模型。 4. 通过“迁移操作”migrate来添加模型。
@ -571,7 +573,7 @@ Q对象用于执行复杂查询的使用
>>> Emp.objects.filter( >>> Emp.objects.filter(
... Q(name__startswith='张'), ... Q(name__startswith='张'),
... Q(sal__gte=5000) | Q(comm__gte=1000) ... Q(sal__gte=5000) | Q(comm__gte=1000)
... ) # 查询名字以“张”开头 工资大于等于5000或补贴大于等于1000的员工 ... ) # 查询名字以“张”开头工资大于等于5000或补贴大于等于1000的员工
<QuerySet [<Emp: >]> <QuerySet [<Emp: >]>
``` ```

View File

@ -1,2 +1,27 @@
## Django 2.x实战(03) - 请求和响应详解 ## Django 2.x实战(03) - 请求和响应详解
基于前面两个章节讲解的知识我们已经可以使用Django框架来实现Web应用的开发了。接下来我们就尝试实现一个投票应用具体的需求是用户进入系统首先来到“登录页”登录成功后可以查看到“学科介绍”页面该页面显示了一个学校所开设的所有学科通过点击某个学科可以进入“讲师详情”页面该页面展示了该学科所有讲师的详细情况可以在该页面上给讲师点击“好评”或“差评”对于未注册的用户可以在登录页点击“新用户注册”进入“注册页”完成用户注册注册成功或失败都会获得相应的提示信息注册成功后会返回“登录页”。
由于之前已经详细的讲解了如何创建Django项目以及项目的相关配置因此我们略过这部分内容唯一需要说明的是我们将项目命名为`hellodjango`,在项目下创建了一个名为`demo`的应用。从“学科介绍”和“讲师详情”页面的需求,我们可以首先分析出两个业务实体,一个是学科,一个是讲师,二者之前是一对多关联。因此,我们首先修改应用`demo`下的models.py文件来定义数据模型。
```Python
```
再完成模型迁移之后我们可以通过下面的SQL语句来添加学科和讲师的数据。
```SQL
```
接下来我们就可以修改views.py文件通过编写视图函数先实现“学科介绍”页面。
```Python
```

Binary file not shown.

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 40 KiB