Commit acaf60ab authored by jackfrued's avatar jackfrued

更新了Django部分的文档

parent f3ec6714
......@@ -214,6 +214,7 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目
- `models.py`:存放应用的数据模型,即实体类及其之间的关系(MVC/MVT中的M)。
- `tests.py`:包含测试应用各项功能的测试类和测试函数。
- `views.py`:处理请求并返回响应的函数(MVC中的C,MVT中的V)。
2. 进入应用目录修改视图文件views.py。
```Shell
......@@ -294,12 +295,15 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目
```Python
from django.http import HttpResponse
from io import StringIO
from random import randrange
fruits = ['苹果', '草莓', '榴莲', '香蕉', '葡萄', '山竹', '蓝莓', '西瓜']
from django.http import HttpResponse
depts_list = [
{'no': 10, 'name': '财务部', 'location': '北京'},
{'no': 20, 'name': '研发部', 'location': '成都'},
{'no': 30, 'name': '销售部', 'location': '上海'},
]
def index(request):
......@@ -310,18 +314,34 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目
output.write('\t<title>首页</title>')
output.write('</head>\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<ol>\n')
for _ in range(3):
rindex = randrange(0, len(fruits))
output.write('\t\t<li>' + fruits[rindex] + '</li>\n')
output.write('\t</ol>\n')
output.write('\t<table>\n')
output.write('\t\t<tr>\n')
output.write('\t\t\t<th>部门编号</th>\n')
output.write('\t\t\t<th>部门名称</th>\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('</html>\n')
return HttpResponse(output.getvalue())
```
7. 再次使用下面的命令来启动服务器并查看程序的运行结果。
```Shell
(venv)$ cd ..
(venv)$ python manage.py runserver
```
![](./res/runserver.png)
#### 使用视图模板
......@@ -354,14 +374,22 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目
<title>首页</title>
</head>
<body>
<h1>{{ greeting }}</h1>
<h1>部门信息</h1>
<hr>
<h3>今天推荐{{ num }}种水果是:</h3>
<ul>
{% for fruit in fruits %}
<li>{{ fruit }}</li>
<table>
<tr>
<th>部门编号</th>
<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 %}
</ul>
</table>
</body>
</html>
```
......@@ -379,19 +407,16 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目
```Python
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):
fruits = ['苹果', '香蕉', '草莓', '葡萄', '山竹', '杨梅', '西瓜', '榴莲']
start, end = 0, randrange(len(fruits))
ctx = {
'greeting': 'Hello, Django!',
'num': end + 1,
'fruits': fruits[start:end + 1]
}
return render(request, 'index.html', ctx)
def index(request):
return render(request, 'index.html', {'depts_list': depts_list})
```
到此为止,我们还没有办法让views.py中的render函数找到模板文件index.html,为此我们需要修改settings.py文件,配置模板文件所在的路径。
......@@ -436,7 +461,6 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目
(venv)$ python manage.py runserver
```
![](./res/runserver.png)
### 总结
......
## Django 2.x实战(02) - 深入模型
在上一个章节中,我们提到了Django是基于MVC架构的Web框架,MVC架构追求的是“模型”和“视图的解耦合。所谓“模型”说得更直白一些就是数据,所以通常也被称作“数据模型”。在实际的项目中,数据模型通常通过数据库实现持久化操作,而关系型数据库在很长一段时间都是持久化的首选方案(当然NoSQL的方案在今天普遍被认为是关系型数据库的一个很好的补充),在下面演示的项目中,我们选择使用MySQL来实现数据持久化
在上一个章节中,我们提到了Django是基于MVC架构的Web框架,MVC架构追求的是“模型”和“视图的解耦合。所谓“模型”说得更直白一些就是数据,所以通常也被称作“数据模型”。在实际的项目中,数据模型通常通过数据库实现持久化操作,而关系型数据库在很长一段时间都是持久化的首选方案,下面我们以MySQL为例来说明如何使用关系型数据库来实现持久化操作
### 配置关系型数据库MySQL
我们继续来完善上一个章节中的OA项目,首先从配置项目使用的数据库开始。
1. 进入oa文件夹,修改项目的settings.py文件,首先将我们之前创建的应用hrs添加已安装的项目中,然后配置MySQL作为持久化方案。
```Shell
......@@ -49,7 +51,7 @@
其他的配置可以参考官方文档中[数据库配置](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中使用PyMySQL,Python 2中用MySQLdb。
......@@ -132,11 +134,11 @@
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='月薪')
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='所在部门')
class Meta:
db_table = 'tb_emp'
```
> 说明:上面定义模型时使用了字段类及其属性,其中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
```
执行完数据迁移操作之后,可以在通过图形化的MySQL客户端工具查看到E-R图(实体关系图)。
执行完数据模型迁移操作之后,可以在通过图形化的MySQL客户端工具查看到E-R图(实体关系图)。
![](./res/er-graph.png)
......@@ -435,7 +437,7 @@ Type "help", "copyright", "credits" or "license" for more information.
### Django模型最佳实践
1. 正确的模型命名和关系字段命名。
1. 正确的为模型和关系字段命名。
2. 设置适当的`related_name`属性。
3. 用`OneToOneField`代替`ForeignKeyField(unique=True)`。
4. 通过“迁移操作”(migrate)来添加模型。
......@@ -571,7 +573,7 @@ Q对象(用于执行复杂查询)的使用:
>>> Emp.objects.filter(
... Q(name__startswith='张'),
... Q(sal__gte=5000) | Q(comm__gte=1000)
... ) # 查询名字以“张”开头 工资大于等于5000或补贴大于等于1000的员工
... ) # 查询名字以“张”开头工资大于等于5000或补贴大于等于1000的员工
<QuerySet [<Emp: 张三丰>]>
```
......
## Django 2.x实战(03) - 请求和响应详解
基于前面两个章节讲解的知识,我们已经可以使用Django框架来实现Web应用的开发了。接下来我们就尝试实现一个投票应用,具体的需求是用户进入系统首先来到“登录页”;登录成功后可以查看到“学科介绍”页面,该页面显示了一个学校所开设的所有学科;通过点击某个学科,可以进入“讲师详情”页面,该页面展示了该学科所有讲师的详细情况,可以在该页面上给讲师点击“好评”或“差评”;对于未注册的用户,可以在登录页点击“新用户注册”进入“注册页”完成用户注册,注册成功或失败都会获得相应的提示信息,注册成功后会返回“登录页”。
由于之前已经详细的讲解了如何创建Django项目以及项目的相关配置,因此我们略过这部分内容,唯一需要说明的是,我们将项目命名为`hellodjango`,在项目下创建了一个名为`demo`的应用。从“学科介绍”和“讲师详情”页面的需求,我们可以首先分析出两个业务实体,一个是学科,一个是讲师,二者之前是一对多关联。因此,我们首先修改应用`demo`下的models.py文件来定义数据模型。
```Python
```
再完成模型迁移之后,我们可以通过下面的SQL语句来添加学科和讲师的数据。
```SQL
```
接下来,我们就可以修改views.py文件,通过编写视图函数先实现“学科介绍”页面。
```Python
```
Day41-55/res/runserver.png

37.5 KB | W: | H:

Day41-55/res/runserver.png

40.3 KB | W: | H:

Day41-55/res/runserver.png
Day41-55/res/runserver.png
Day41-55/res/runserver.png
Day41-55/res/runserver.png
  • 2-up
  • Swipe
  • Onion skin
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment