Django - 模型(Models)

模型（Model）

• 模型是提供数据信息的数据库接口。
• 模型是数据的惟一的，肯定的信息源。它包含你所储存数据的必要字段和行为。
• 一般，每一个模型对应数据库中惟一的一张表。每一个模型的实例对应数据表中的一条记录
• 模型说明：

• • 每一个模型都是一个Python的类，每一个模型都是django.db.models.Model的子类。
  • 每个模型属性都表明数据库中的一个表。
  • 经过全部这一切，Django的为你提供一个自动生成的数据库访问API;

1.ORM框架

• ORM（对象关系映射）即对象关系映射，它容许你使用类和对象对数据库进行交互（使用类和对象和使用SQL同样且更方便各类操做）。
• ORM

Object Relationship Mapping
  对象    关系         映射

• 三大特征:

1. 表到类的映射
2. 数据类型的映射
3. 关系映射

2.模型示例(操做步骤)

(1)添加一个应用程序　　$ python3 manage.py startapp 应用程序名

(2)添加模型类并注册应用程序(假设建立一个bookstore的应用程序) 

# file : bookstore/models.py
from django.db import models

class Book(models.Model):
    title = models.CharField("书名", max_length=50, default='')
    price = models.DecimalField('订价', max_digits=7, decimal_places=2, default=0.0)

############

# file : setting.py
INSTALLED_APPS = [
    ...
    'bookstore',
]

(3)迁移生成脚本文件bookstore/migrations/0001_initial.py并进行迁移

$ python3 manage.py makemigrations

$ python3 manage.py migrate 

#终端操做
$ python3 manage.py makemigrations
Migrations for 'bookstore':
bookstore/migrations/0001_initial.py
    - Create model Book
$ python3 manage.py migrate
Operations to perform:
Apply all migrations: admin, auth, bookstore, contenttypes, sessions
Running migrations:
Applying bookstore.0001_initial... OK

(4)查看数据表(是否迁移成功)

$ mysql -u root -p
mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mygoods            |
| mysql              |
| mywebdb            |
| onlybuyp           |
| performance_schema |
| sys                |
| test_db            |
+--------------------+
8 rows in set (0.00 sec)

mysql> use mywebdb
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Database changed
mysql> show tables;
+----------------------------+
| Tables_in_mywebdb          |
+----------------------------+
| auth_group                 |
| auth_group_permissions     |
| auth_permission            |
| auth_user                  |
| auth_user_groups           |
| auth_user_user_permissions |
| bookstore_book             |  <<== 新加表
| django_admin_log           |
| django_content_type        |
| django_migrations          |
| django_session             |
+----------------------------+
11 rows in set (0.00 sec)

mysql> desc bookstore_book;
+-------+--------------+------+-----+---------+----------------+
| Field | Type         | Null | Key | Default | Extra          |
+-------+--------------+------+-----+---------+----------------+
| id    | int(11)      | NO   | PRI | NULL    | auto_increment |
| title | varchar(50)  | NO   |     | NULL    |                |
| price | decimal(7,2) | NO   |     | NULL    |                |
+-------+--------------+------+-----+---------+----------------+
3 rows in set (0.00 sec)

查看数据库 

(5)表bookstore_book即为模型Book类对应的数据表

• d为主键，当设定主键时会自动添加id字段为主键
• 若是更新模型类models.py中的内容时须要运行makemigrations和迁移子命名来更新和同步数据库
• 在开发阶段若是同步数据库出错。用sql> drop database 数据库名删除数据库后从新迁移数据库
• 在xxx_app / migrations / *。py下的文件是自动生成的迁移脚本文件，能够手动删除且在下一次迁移时自动生成

3.编写模型类模型

模型类需继承自django.db.models.Model

(1)模型的语法规范

from django.db import models
class CLASSNAME(models.Model):
    NAME = models.FIELD_TYPE(FIELD_OPTIONS)

(2)班级名称

• 实体类名，表名组成一部分，建议类名首字母大写
• 默认表名组成规范：
  • 应用名称_className

(3)名称

• 类属性名，映射回数据库就是字段名

(4)FIELD_TYPE

• 字段类型：映射到表中的字段的类型

4.FIELD_TYPE类型及含义

(1)BooleanField（）

• 数据库类型：TINYINT（1）
• 编程语言中：使用真或假来表示值
• 在数据库中：使用1或0来表示具体的值

(2)CharField（）

• 数据库类型：V​​ARCHAR
• 注意：必需要指定MAX_LENGTH参数值 

(3)DateField（）

• 数据库类型：日期
• 做用：表示日期
• 编程语言中：使用字符串来表示具体值
• 参数：
  • DateField.auto_now：每次保存对象时，自动设置该字段为当前时间（取值：是/否）。
  • DateField.auto_now_add：当对象第一次被建立时自动设置当前时间（取值：真/假）。
  • DateField.default：设置当前时间（取值：字符串格式时间如：'2019-6-1'）。
  • 以上三个参数只能多选一

(4)DateTimeField字段（）

• 数据库类型：日期时间（6）
• 做用：表示日期和时间
• auto_now_add =真

(5)DecimalField（）

• 数据库类型：十进制（X，Y） 
• 编程语言中：使用小数表示该列的值
• 在数据库中：使用小数
• 参数：
  • DecimalField.max_digits：位数总数，包括小数点后的位数。该值必须大于等于decimal_places。
  • DecimalField.decimal_places：小数点后的数字数量

money=models.DecimalField(
    max_digits=7,
    decimal_places=2,
    default=0.0
)

(6)FloatField（）

• 数据库类型：双
• 编程语言中和数据库中都使用小数表示值

(7)EmailField（）

• 数据库类型：V​​ARCHAR
• 编程语言和数据库中使用字符串

(8)IntegerField（） 

• 数据库类型：INT
• 编程语言和数据库中使用整数 

(9)URLField（）

• 数据库类型：V​​ARCHAR（200）
• 编程语言和数据库中使用字符串

(10)ImageField的（）

• 数据库类型：V​​ARCHAR（100）
• 做用：在数据库中为了保存图片的路径
• 编程语言和数据库中使用字符串
• upload_to：指定图片的上传路径在后台上传时会自动的将文件保存在指定的目录下

image=models.ImageField(
    upload_to="static/images"
)

(11)文本域（）

• 数据库类型：LONGTEXT
• 做用：表示不定长的字符数据

文档参考https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-types

5.字段选项

FIELD_OPTIONS

　　字段选项，指定建立的列的额外的信息field_options

　　容许出现多个字段选项，多个选项之间使用，隔开 

(1)首要的关键:primary_key=True

　　若是设置为True，则表示该列为主键，若是指定一个字段为主键，则此数库表不会建立ID字段

(2)空白:blank=Flase

　　设置为真时，字段能够为空。设置为False时，字段是必须填写的。字符型字段CharField和TextField是用空字符串来存储空值的。默认值是False。

(3)空值:null=Ture

　　若是设置为True，则表示该列值容许为空。日期型，时间型和数字型字段不接受空字符串。因此设置IntegerField，DateTimeField字段型字段能够为空时，须要将空(blank)，空(null)均设为真(True)。

　　默认为False，若是此选项为false,建议加入默认(default)选项来设置默认值

(4)默认:delault=''

　　设置所在列的默认值，若是字段选项空=假建议添加此项

(5)db_index

　　若是设置为True，则表示为该列增长索引

(6)独特unique

　　若是设置为True，则表示该字段在数据库中的值必须是惟一（不能重复出现的）

(7)db_column

　　指定列的名称，若是不指定的话则采用属性名做为列名

(8)verbose_name

　　设置此字段在管理界面上的显示名称。

# 建立一个属性,表示用户名称,长度30个字符,必须是惟一的,不能为空,添加索引

name = models.CharField(max_length=30, unique=True, 
null=False, db_index=True)

文档参见：https://docs.djangoproject.com/en/1.11/ref/models/fields/#field-options