Skip to content

Commit acaf60a

Browse files
jackfruedjackfrued
committed
更新了Django部分的文档
1 parent f3ec671 commit acaf60a

File tree

4 files changed

+86
-35
lines changed

4 files changed

+86
-35
lines changed

‎Day41-55/Django2实战01.md

+53-29
Original file line numberDiff line numberDiff line change
@@ -214,6 +214,7 @@ Django诞生于2003年，它是一个在真正的应用中成长起来的项目
214214
- `models.py`：存放应用的数据模型，即实体类及其之间的关系（MVC/MVT中的M）。
215215
- `tests.py`：包含测试应用各项功能的测试类和测试函数。
216216
- `views.py`：处理请求并返回响应的函数（MVC中的C，MVT中的V）。
217+
217218
2. 进入应用目录修改视图文件views.py。
218219

219220
```Shell
@@ -294,12 +295,15 @@ Django诞生于2003年，它是一个在真正的应用中成长起来的项目
294295

295296
```Python
296297

297-
from django.http import HttpResponse
298-
299298
from io import StringIO
300-
from random import randrange
301299

302-
fruits = ['苹果', '草莓', '榴莲', '香蕉', '葡萄', '山竹', '蓝莓', '西瓜']
300+
from django.http import HttpResponse
301+
302+
depts_list = [
303+
{'no': 10, 'name': '财务部', 'location': '北京'},
304+
{'no': 20, 'name': '研发部', 'location': '成都'},
305+
{'no': 30, 'name': '销售部', 'location': '上海'},
306+
]
303307

304308

305309
def index(request):
@@ -310,19 +314,35 @@ Django诞生于2003年，它是一个在真正的应用中成长起来的项目
310314
output.write('\t<title>首页</title>')
311315
output.write('</head>\n')
312316
output.write('<body>\n')
313-
output.write('\t<h1>Hello, world!</h1>\n')
317+
output.write('\t<h1>部门信息</h1>\n')
314318
output.write('\t<hr>\n')
315-
output.write('\t<ol>\n')
316-
for _ in range(3):
317-
rindex = randrange(0, len(fruits))
318-
output.write('\t\t<li>' + fruits[rindex] + '</li>\n')
319-
output.write('\t</ol>\n')
319+
output.write('\t<table>\n')
320+
output.write('\t\t<tr>\n')
321+
output.write('\t\t\t<th>部门编号</th>\n')
322+
output.write('\t\t\t<th>部门名称</th>\n')
323+
output.write('\t\t\t<th>所在地</th>\n')
324+
output.write('\t\t</tr>\n')
325+
for dept in depts_list:
326+
output.write('\t\t<tr>\n')
327+
output.write(f'\t\t\t<td>{dept["no"]}</td>\n')
328+
output.write(f'\t\t\t<td>{dept["name"]}</td>\n')
329+
output.write(f'\t\t\t<td>{dept["location"]}</td>\n')
330+
output.write('\t\t</tr>\n')
331+
output.write('\t</table>\n')
320332
output.write('</body>\n')
321333
output.write('</html>\n')
322334
return HttpResponse(output.getvalue())
323-
324335
```
325336

337+
7. 再次使用下面的命令来启动服务器并查看程序的运行结果。
338+
339+
```Shell
340+
341+
(venv)$ cd ..
342+
(venv)$ python manage.py runserver
343+
```
344+
![](./res/runserver.png)
345+
326346
#### 使用视图模板
327347

328348
上面通过拼接HTML代码的方式生成动态视图的做法在实际开发中是无能接受的，这一点我相信是不言而喻的。为了解决这个问题，我们可以提前准备一个模板页，所谓模板页就是一个带占位符的HTML页面，当我们将程序中获得的数据替换掉页面中的占位符时，一个动态页面就产生了。
@@ -354,14 +374,22 @@ Django诞生于2003年，它是一个在真正的应用中成长起来的项目
354374
<title>首页</title>
355375
</head>
356376
<body>
357-
<h1>{{ greeting }}</h1>
377+
<h1>部门信息</h1>
358378
<hr>
359-
<h3>今天推荐{{ num }}种水果是:</h3>
360-
<ul>
361-
{% for fruit in fruits %}
362-
<li>{{ fruit }}</li>
363-
{% endfor %}
364-
</ul>
379+
<table>
380+
<tr>
381+
<th>部门编号</th>
382+
<th>部门名称</th>
383+
<th>所在地</th>
384+
</tr>
385+
{% for dept in depts_list %}
386+
<tr>
387+
<td>{{ dept.no }}</td>
388+
<td>{{ dept.name }}</td>
389+
<td>{{ dept.location }}</td>
390+
<tr>
391+
{% endfor %}
392+
</table>
365393
</body>
366394
</html>
367395
```
@@ -379,19 +407,16 @@ Django诞生于2003年，它是一个在真正的应用中成长起来的项目
379407
```Python
380408
381409
from django.shortcuts import render
382-
from random import randrange
383410
411+
depts_list = [
412+
{'no': 10, 'name': '财务部', 'location': '北京'},
413+
{'no': 20, 'name': '研发部', 'location': '成都'},
414+
{'no': 30, 'name': '销售部', 'location': '上海'},
415+
]
384416
385-
def index(request):
386-
fruits = ['苹果', '香蕉', '草莓', '葡萄', '山竹', '杨梅', '西瓜', '榴莲']
387-
start, end = 0, randrange(len(fruits))
388-
ctx = {
389-
'greeting': 'Hello, Django!',
390-
'num': end + 1,
391-
'fruits': fruits[start:end + 1]
392-
}
393-
return render(request, 'index.html', ctx)
394417
418+
def index(request):
419+
return render(request, 'index.html', {'depts_list': depts_list})
395420
```
396421
397422
到此为止，我们还没有办法让views.py中的render函数找到模板文件index.html，为此我们需要修改settings.py文件，配置模板文件所在的路径。
@@ -436,7 +461,6 @@ Django诞生于2003年，它是一个在真正的应用中成长起来的项目
436461
(venv)$ python manage.py runserver
437462
```
438463
439-
![](./res/runserver.png)
440464
441465
### 总结
442466

‎Day41-55/Django2实战02.md

+8-6
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
## Django 2.x实战(02) - 深入模型
22

3-
在上一个章节中，我们提到了Django是基于MVC架构的Web框架，MVC架构追求的是“模型”和“视图的解耦合。所谓“模型”说得更直白一些就是数据，所以通常也被称作“数据模型”。在实际的项目中，数据模型通常通过数据库实现持久化操作，而关系型数据库在很长一段时间都是持久化的首选方案（当然NoSQL的方案在今天普遍被认为是关系型数据库的一个很好的补充），在下面演示的项目中，我们选择使用MySQL来实现数据持久化。
3+
在上一个章节中，我们提到了Django是基于MVC架构的Web框架，MVC架构追求的是“模型”和“视图的解耦合。所谓“模型”说得更直白一些就是数据，所以通常也被称作“数据模型”。在实际的项目中，数据模型通常通过数据库实现持久化操作，而关系型数据库在很长一段时间都是持久化的首选方案，下面我们以MySQL为例来说明如何使用关系型数据库来实现持久化操作。
44

55
### 配置关系型数据库MySQL
66

7+
我们继续来完善上一个章节中的OA项目，首先从配置项目使用的数据库开始。
8+
79
1. 进入oa文件夹，修改项目的settings.py文件，首先将我们之前创建的应用hrs添加已安装的项目中，然后配置MySQL作为持久化方案。
810

911
```Shell
@@ -49,7 +51,7 @@
4951

5052
其他的配置可以参考官方文档中[数据库配置](https://docs.djangoproject.com/zh-hans/2.0/ref/databases/#third-party-notes)的部分。
5153

52-
NAME属性代表数据库的名称，如果使用SQLite它对应着一个文件，在这种情况下NAME的属性值应该是一个绝对路径。如果使用其他关系型数据库，还要配置对应的HOST（主机）、PORT（端口）、USER（用户名）、PASSWORD（口令）等属性。
54+
NAME属性代表数据库的名称，如果使用SQLite它对应着一个文件，在这种情况下NAME的属性值应该是一个绝对路径；使用其他关系型数据库，则要配置对应的HOST（主机）、PORT（端口）、USER（用户名）、PASSWORD（口令）等属性。
5355

5456
2. 安装MySQL客户端工具，Python 3中使用PyMySQL，Python 2中用MySQLdb。
5557

@@ -132,11 +134,11 @@
132134
mgr = models.ForeignKey('self', on_delete=models.SET_NULL, null=True, blank=True, verbose_name='主管编号')
133135
sal = models.DecimalField(max_digits=7, decimal_places=2, verbose_name='月薪')
134136
comm = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True, verbose_name='补贴')
137+
# 多对一外键关联
135138
dept = models.ForeignKey(Dept, db_column='dno', on_delete=models.PROTECT, verbose_name='所在部门')
136139

137140
class Meta:
138141
db_table = 'tb_emp'
139-
140142
```
141143
> 说明：上面定义模型时使用了字段类及其属性，其中IntegerField对应数据库中的integer类型，CharField对应数据库的varchar类型，DecimalField对应数据库的decimal类型，ForeignKey用来建立多对一外键关联。字段属性primary_key用于设置主键，max_length用来设置字段的最大长度，db_column用来设置数据库中与字段对应的列，verbose_name则设置了Django后台管理系统中该字段显示的名称。如果对这些东西感到很困惑也不要紧，文末提供了字段类、字段属性、元数据选项等设置的相关说明，不清楚的读者可以稍后查看对应的参考指南。
142144
@@ -157,7 +159,7 @@
157159
Applying hrs.0001_initial... OK
158160
```
159161

160-
执行完数据迁移操作之后，可以在通过图形化的MySQL客户端工具查看到E-R图（实体关系图）。
162+
执行完数据模型迁移操作之后，可以在通过图形化的MySQL客户端工具查看到E-R图（实体关系图）。
161163

162164
![](./res/er-graph.png)
163165

@@ -435,7 +437,7 @@ Type "help", "copyright", "credits" or "license" for more information.
435437

436438
### Django模型最佳实践
437439

438-
1. 正确的模型命名和关系字段命名。
440+
1. 正确的为模型和关系字段命名。
439441
2. 设置适当的`related_name`属性。
440442
3. 用`OneToOneField`代替`ForeignKeyField(unique=True)`。
441443
4. 通过“迁移操作”（migrate）来添加模型。
@@ -571,7 +573,7 @@ Q对象（用于执行复杂查询）的使用：
571573
>>> Emp.objects.filter(
572574
... Q(name__startswith='张'),
573575
... Q(sal__gte=5000) | Q(comm__gte=1000)
574-
... ) # 查询名字以“张”开头 工资大于等于5000或补贴大于等于1000的员工
576+
... ) # 查询名字以“张”开头且工资大于等于5000或补贴大于等于1000的员工
575577
<QuerySet [<Emp: 张三丰>]>
576578
```
577579

‎Day41-55/Django2实战03.md

+25
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,27 @@
11
## Django 2.x实战(03) - 请求和响应详解
22

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

‎Day41-55/res/runserver.png

2.87 KB
Loading

0 commit comments

Comments
 (0)