Skip to content

Commit 9eaf653

Browse files
jackfruedjackfrued
committed
更新了Django第二天的文档
1 parent 09a4ec0 commit 9eaf653

11 files changed

+405
-48
lines changed

‎.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
11
venv
22
.idea
33
*.pyc
4+

‎Day31/Django实战(01) - 快速上手.md renamed to ‎Day31/Django 2.x实战(01) - 快速上手.md

Lines changed: 102 additions & 38 deletions
Large diffs are not rendered by default.

‎Day31/res/django-index-1.png

154 KB
Loading

‎Day31/res/django-index-2.png

154 KB
Loading

‎Day31/res/django-version.png

-42.5 KB
Binary file not shown.

‎Day31/res/http-request.png

5.95 KB
Loading

‎Day31/res/http-response.png

6.4 KB
Loading

‎Day31/res/runserver-1.png renamed to ‎Day31/res/runserver.png

File renamed without changes.

‎Day32/Django实战(02).md

Lines changed: 302 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,302 @@
1+
## Django实战(02) - 深入模型
2+
3+
在上一个章节中，我们提到了Django是一个基于MVC架构的Web框架，MVC架构要追求的是模型和视图的解耦合，而其中的模型说得更直白一些就是数据，所以通常也被称作数据模型。在实际的项目中，数据模型通常通过数据库实现持久化操作，而关系型数据库在很长一段时间都是持久化的首选方案，在我们的OA项目中，我们选择使用MySQL来实现数据持久化。
4+
5+
### 配置关系型数据库MySQL
6+
7+
1. 进入oa文件夹，修改项目的settings.py文件，首先将我们之前创建的应用hrs添加已安装的项目中，然后配置MySQL作为持久化方案。
8+
9+
```Shell
10+
(venv)$ cd oa
11+
(venv)$ vim settings.py
12+
```
13+
14+
```Python
15+
# 此处省略上面的代码
16+
17+
INSTALLED_APPS = [
18+
'django.contrib.admin',
19+
'django.contrib.auth',
20+
'django.contrib.contenttypes',
21+
'django.contrib.sessions',
22+
'django.contrib.messages',
23+
'django.contrib.staticfiles',
24+
'hrs',
25+
]
26+
27+
DATABASES = {
28+
'default': {
29+
'ENGINE': 'django.db.backends.mysql',
30+
'NAME': 'oa',
31+
'HOST': 'localhost',
32+
'PORT': 3306,
33+
'USER': 'root',
34+
'PASSWORD': '123456',
35+
}
36+
}
37+
38+
# 此处省略下面的代码
39+
```
40+
41+
在配置ENGINE属性时，常用的可选值包括：
42+
43+
- `'django.db.backends.sqlite3'`：SQLite嵌入式数据库
44+
- `'django.db.backends.postgresql'`：BSD许可证下发行的开源关系型数据库产品
45+
- `'django.db.backends.mysql'`：转手多次目前属于甲骨文公司的经济高效的数据库产品
46+
- `'django.db.backends.oracle'`：甲骨文公司的旗舰关系型数据库产品
47+
48+
其他的配置可以参考官方文档中[数据库配置](https://docs.djangoproject.com/zh-hans/2.0/ref/databases/#third-party-notes)的部分。
49+
50+
NAME属性代表数据库的名称，如果使用SQLite它对应着一个文件，在这种情况下NAME的属性值应该是一个绝对路径。如果使用其他关系型数据库，还要配置对应的USER、PASSWORD、HOST、PORT等属性。
51+
52+
2. 安装MySQL客户端工具，Python 3中使用PyMySQL，Python 2中用MySQLdb。
53+
54+
```Shell
55+
(venv)$ pip install pymysql
56+
```
57+
58+
如果使用Python 3需要修改**项目**的`__init__.py`文件并加入如下所示的代码，这段代码的作用是将PyMySQL视为MySQLdb来使用，从而避免Django找不到连接MySQL的客户端工具而询问你：“Did you install mysqlclient? ”（你安装了mysqlclient吗？）。
59+
60+
```Python
61+
import pymysql
62+
63+
pymysql.install_as_MySQLdb()
64+
```
65+
66+
3. 运行manage.py并指定migrate参数实现数据库迁移，为应用程序创建对应的数据表，当然在此之前需要先启动MySQL数据库服务器并创建名为oa的数据库，在MySQL中创建数据库的语句如下所示。
67+
68+
```SQL
69+
drop database if exists oa;
70+
create database oa default charset utf8;
71+
```
72+
73+
```Shell
74+
(venv)$ cd ..
75+
(venv)$ python manage.py migrate
76+
Operations to perform:
77+
Apply all migrations: admin, auth, contenttypes, sessions
78+
Running migrations:
79+
Applying contenttypes.0001_initial... OK
80+
Applying auth.0001_initial... OK
81+
Applying admin.0001_initial... OK
82+
Applying admin.0002_logentry_remove_auto_add... OK
83+
Applying contenttypes.0002_remove_content_type_name... OK
84+
Applying auth.0002_alter_permission_name_max_length... OK
85+
Applying auth.0003_alter_user_email_max_length... OK
86+
Applying auth.0004_alter_user_username_opts... OK
87+
Applying auth.0005_alter_user_last_login_null... OK
88+
Applying auth.0006_require_contenttypes_0002... OK
89+
Applying auth.0007_alter_validators_add_error_messages... OK
90+
Applying auth.0008_alter_user_username_max_length... OK
91+
Applying auth.0009_alter_user_last_name_max_length... OK
92+
Applying sessions.0001_initial... OK
93+
```
94+
95+
4. 可以看到，Django帮助我们创建了10张二维表，这些都是使用Django框架需要的东西，除了这些之外，我们还应该为我们自己的应用创建数据模型。如果要在hrs应用中实现对部门和员工的管理，我们可以创建如下所示的数据模型。
96+
97+
```Shell
98+
(venv)$ cd hrs
99+
(venv)$ vim models.py
100+
```
101+
102+
```Python
103+
from django.db import models
104+
105+
106+
class Dept(models.Model):
107+
"""部门类"""
108+
109+
no = models.IntegerField(primary_key=True, verbose_name='部门编号')
110+
name = models.CharField(max_length=20, verbose_name='部门名称')
111+
location = models.CharField(max_length=10, verbose_name='部门所在地')
112+
113+
class Meta:
114+
db_table = 'tb_dept'
115+
116+
117+
class Emp(models.Model):
118+
"""员工类"""
119+
120+
no = models.IntegerField(primary_key=True, verbose_name='员工编号')
121+
name = models.CharField(max_length=20, verbose_name='员工姓名')
122+
job = models.CharField(max_length=10, verbose_name='职位')
123+
mgr = models.IntegerField(null=True, blank=True, verbose_name='主管编号')
124+
sal = models.DecimalField(max_digits=7, decimal_places=2, verbose_name='月薪')
125+
comm = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True, verbose_name='补贴')
126+
dept = models.ForeignKey(Dept, on_delete=models.PROTECT, verbose_name='所在部门')
127+
128+
class Meta:
129+
db_table = 'tb_emp'
130+
131+
```
132+
133+
5. 通过模型创建数据表。
134+
135+
```Shell
136+
(venv)$ cd ..
137+
(venv)$ python manage.py makemigrations hrs
138+
Migrations for 'hrs':
139+
hrs/migrations/0001_initial.py
140+
- Create model Dept
141+
- Create model Emp
142+
(venv)$ python manage.py migrate
143+
Operations to perform:
144+
Apply all migrations: admin, auth, contenttypes, hrs, sessions
145+
Running migrations:
146+
Applying hrs.0001_initial... OK
147+
```
148+
149+
执行完数据迁移操作之后，可以在通过图形化的MySQL客户端工具查看到E-R图（实体关系图）。
150+
151+
![](./res/er-graph.png)
152+
153+
### 在后台管理模型
154+
155+
156+
157+
### 使用ORM完成模型的CRUD操作
158+
159+
#### 新增
160+
161+
#### 删除
162+
163+
#### 更新
164+
165+
#### 查询
166+
167+
168+
169+
最后，我们通过上面掌握的知识来实现部门展示以及根据获取部门对应员工信息的功能。
170+
171+
172+
173+
### Django模型最佳实践
174+
175+
1. 正确的模型命名和关系字段命名。
176+
2. 设置适当的related_name属性。
177+
3. 用OneToOneField代替ForeignKeyField(unique=True)。
178+
4. 通过迁移操作来添加模型。
179+
5. 用NoSQL来应对需要降低范式级别的场景。
180+
6. 如果布尔类型可以为空要使用NullBooleanField。
181+
7. 在模型中放置业务逻辑。
182+
8. 用ModelName.DoesNotExists取代ObjectDoesNotExists。
183+
9. 在数据库中不要出现无效数据。
184+
10. 不要对QuerySet调用len函数。
185+
11. 将QuerySet的exists()方法的返回值用于if条件。
186+
12. 用DecimalField来存储货币相关数据而不是FloatField。
187+
13. 定义\_\_str\_\_方法。
188+
14. 不要将数据文件放在同一个目录中。
189+
190+
### 模型定义参考
191+
192+
#### 字段
193+
194+
对字段名称的限制
195+
196+
- 字段名不能是Python的保留字，否则会导致语法错误
197+
- 字段名不能有多个连续下划线，否则影响ORM查询操作
198+
199+
Django模型字段类
200+
201+
| 字段类 | 默认小组件 | 说明 |
202+
| --------------------- | ------------------ | ------------------------------------------------------------ |
203+
| AutoField | 无 | 自增ID字段 |
204+
| BigIntegerField | NumberInput | 64位有符号整数 |
205+
| BinaryField | 无 | 存储二进制数据的字段，对应Python的bytes类型 |
206+
| BooleanField | CheckboxInput | 存储True或False |
207+
| CharField | TextInput | 长度较小的字符串 |
208+
| DateField | DateInput | 存储日期，有auto_now和auto_now_add属性 |
209+
| DateTimeField | DateTimeInput | 存储日期和日期，两个附加属性同上 |
210+
| DecimalField | TextInput | 存储固定精度小数，有max_digits（有效位数）和decimal_places（小数点后面）两个必要的参数 |
211+
| DurationField | TextInput | 存储时间跨度 |
212+
| EmailField | TextInput | 与CharField相同，可以用EmailValidator验证 |
213+
| FileField | ClearableFileInput | 文件上传字段 |
214+
| FloatField | TextInput | 存储浮点数 |
215+
| ImageField | ClearableFileInput | 其他同FileFiled，要验证上传的是不是有效图像 |
216+
| IntegerField | NumberInput | 存储32位有符号整数。 |
217+
| GenericIPAddressField | TextInput | 存储IPv4或IPv6地址 |
218+
| NullBooleanField | NullBooleanSelect | 存储True、False或null值 |
219+
| PositiveIntegerField | NumberInput | 存储无符号整数（只能存储正数） |
220+
| SlugField | TextInput | 存储slug（简短标注） |
221+
| SmallIntegerField | NumberInput | 存储16位有符号整数 |
222+
| TextField | Textarea | 存储数据量较大的文本 |
223+
| TimeField | TextInput | 存储时间 |
224+
| URLField | URLInput | 存储URL的CharField |
225+
| UUIDField | TextInput | 存储全局唯一标识符 |
226+
227+
#### 字段属性
228+
229+
通用字段属性
230+
231+
| 选项 | 说明 |
232+
| -------------- | ------------------------------------------------------------ |
233+
| null | 数据库中对应的字段是否允许为NULL，默认为False |
234+
| blank | 后台模型管理验证数据时，是否允许为NULL，默认为False |
235+
| choices | 设定字段的选项，各元组中的第一个值是设置在模型上的值，第二值是人类可读的值 |
236+
| db_column | 字段对应到数据库表中的列名，未指定时直接使用字段的名称 |
237+
| db_index | 设置为True时将在该字段创建索引 |
238+
| db_tablespace | 为有索引的字段设置使用的表空间，默认为DEFAULT_INDEX_TABLESPACE |
239+
| default | 字段的默认值 |
240+
| editable | 字段在后台模型管理或ModelForm中是否显示，默认为True |
241+
| error_messages | 设定字段抛出异常时的默认消息的字典，其中的键包括null、blank、invalid、invalid_choice、unique和unique_for_date |
242+
| help_text | 表单小组件旁边显示的额外的帮助文本。 |
243+
| primary_key | 将字段指定为模型的主键，未指定时会自动添加AutoField用于主键，只读。 |
244+
| unique | 设置为True时，表中字段的值必须是唯一的 |
245+
| verbose_name | 字段在后台模型管理显示的名称，未指定时使用字段的名称 |
246+
247+
ForeignKey属性
248+
249+
1. limit_choices_to
250+
2. related_name
251+
3. relate_query_name
252+
4. to_field
253+
5. db_constraint
254+
6. on_delete
255+
256+
ManyToManyField属性
257+
258+
1. symmetrical
259+
2. through
260+
3. throughfields
261+
4. db_table
262+
263+
#### 模型元数据选项
264+
265+
| 选项 | 说明 |
266+
| --------------------- | ------------------------------------------------------------ |
267+
| abstract | |
268+
| app_label | 如果定义模型的应用不在INSTALLED_APPS中可以用该属性指定 |
269+
| db_table | 模型使用的数据表名称 |
270+
| db_tablespace | |
271+
| default_related_name | 关联对象回指这个模型时默认使用的名称，默认为<model_name>_set |
272+
| get_latest_by | |
273+
| managed | 设置为True时，Django在迁移中创建数据表并在执行flush管理命令时把表移除 |
274+
| order_with_respect_to | |
275+
| ordering | 对象的默认排序 |
276+
| permissions | |
277+
| default_permissions | 默认为`('add', 'change', 'delete')` |
278+
| proxy | |
279+
| unique_together | |
280+
| index_together | |
281+
| verbose_name | |
282+
| verbose_name_plural | |
283+
284+
### 数据库API参考
285+
286+
287+
288+
按字段查找可以用的条件：
289+
290+
1. exact / iexact
291+
2. contains / icontains
292+
3. in
293+
4. gt / gte / lt / lte
294+
5. startswith / istartswith / endswith / iendswith
295+
6. range
296+
7. year / month / day / week_day / hour / minute / second
297+
8. isnull
298+
9. search
299+
10. regex / iregex
300+
301+
跨关系查找
302+

‎Day32/oa/hrs/models.py

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,10 @@
11
from django.db import models
22

3-
# ORM - 对象关系映射
4-
# 对象模型 <---> 关系模型
5-
# 实体类 <---> 二维表
6-
# 属性 <---> 列
7-
# 对象 <---> 记录
8-
93

104
class Dept(models.Model):
115
no = models.IntegerField(primary_key=True, verbose_name='部门编号')
126
name = models.CharField(max_length=20, verbose_name='部门名称')
137
location = models.CharField(max_length=10, verbose_name='部门所在地')
14-
# excellent = models.BooleanField(default=0, verbose_name='是否优秀')
15-
16-
def __str__(self):
17-
return self.name
188

199
class Meta:
2010
db_table = 'tb_dept'

‎Day32/res/er-graph.png

165 KB
Loading

0 commit comments

Comments
 (0)