10. django模型层

一、django ORM一些说明

- 表myapp-person的名称是自动生成的，如果想要自定义表名，需要在model的Meta类中指定db_table参数,建议使用小写表名，特别是使用Mysql作为后端数据库时
- id字段是自动添加的，如果想要指定自定义主键，只需要在其中的一个字段中指定primary_key=True，这样django就不会自动添加id列
- django会根据配置文件中指定的数据库后端类型来生成相应的SQL语句
- Django支持Mysql5.5及更高的版本

二、创建模型

class Book(models.Model):
    # 如果不写id，会默认一个id，并且自增
    #primary_key=True  表示该字段是主键，一个表中只能由一个主键
    # id = models.AutoField(primary_key=True)
    # varchar类型，长度,
    # 字段是否可以为空:null=True,可以为空
    # 默认值：default='未知书名'，如果没传，默认是它
    # 设置索引:db_index=True 表示该字段是辅助索引
    # 是否唯一:unique=True 表示唯一
    name=models.CharField(max_length=32,null=True,default='未知书名',db_index=True,unique=True)
    # float类型
    # max_digits 最大长度是5  如：4567.5
    # decimal_places=2 小数点后两位   23.56     999.99
    price=models.DecimalField(max_digits=5,decimal_places=2)
	
    # DateField 年月日
    # DateTimeField 年月日时分秒
    # auto_now=True  新增，默认使用当前时间
    # auto_now_add=True 修改，设置当前时间
    publish_date=models.DateTimeField(auto_now=True)

    publish=models.CharField(max_length=32)

三、单表增加

两种方式：

# 第一种：
models.Book.object.create(name="xxx", price=19.99, publish='南京大学出版社')

# 第二种：
book = models.Book(name='yyy',price=29.99,publish='南京大学出版社')
book.save()

四、单表查询

# 查询名字叫xxx的书
from django.shortcuts import render,HttpResponse
from app01 import models

def books(request):
    models.Book.objects.create(name='xxx',price=19.99, publiish='南京大学出版社')
    
    # 查询所有
    res = models.Book.objects.all()
    print(res)
    # 查询名字叫做xxx的书（查询结果是个列表: QuerySet）
    res1 = models.Book.object.filter(name="xxx")
    res2 = models.Book.object.filter(name="xxx")[0]
    res3 = models.Book.object.filter(name="xxx").first()
    
    # 直接查询名字叫做xxx的书（就是book对象）
    # 查询结果必须有且只有一个，如果没有或者有多个，都会报错
    
    res4 = models.Book.get(name='yyy')  # 得到一个book对象
    print(res4.name)
    
    return HttpResponse("两本书保存成功！")

五、字段与参数

1、常用字段

• AutoField

int自增列，必须填入 primary_key=True，当model中如果没有自增列，则自动会创建一个列名为id的列

• IntegerField

一个整数类型，在-2147483648 to 2147483647

• CharField

字符类型，必须提供max_length参数（表示字符长度）

• DateField

日期字段，日期格式 YYYY-MM-DD，相当于Python中的datetime.date()实例。

• DataTimeField

日期时间字段，格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]，相当于Python中的datetime.datetime()实例。

• BooleanField

布尔值类型

• DecimalField

- 十进制小数
- 参数：max_digits:小数总长度
       decimal_places:小数位长度

• FileField

- 字符串，路径保存在数据库，文件上传到指定的目录
- 参数：
	upload_to = ""   上传文件的保存路径
    storage = None   存储组件，默认django.core.files.storage.FileSystemStorage

• ImageField

- 字符串，路径保存在数据库，文件上传到指定的目录
- 参数：
	upload_to = ""   上传文件的保存路径
    storage = None   存储组件，默认django.core.files.storage.FileSystemStorage
    width_field=None  上传图片的高度保存的数据库字段名（字符串）
    height_field=None 上传 图片的高度保存的数据库字段名（字符串） 

• TextField

文本类型

• EmailField

字符串类型，Django Admin以及ModelForm汇总提供验证机制

• BinaryField

二进制类型

非常用字段

-BigAutoField
-SmallIntegerField   
-PositiveSmallIntegerField
-PositiveIntegerField
-BigIntegerField

2、字段参数

• null

用于表示某个字段可以为空

• unique

如果设置成unique=True，则该字段的值在此表中必须是唯一的

• max_length

字符串的最大长度

• primary_key

primary_key=True，为字段设置主键
如果没有指定任何一个字段的primary_key=True，Django 就会自动添加一个IntegerField字段做为主键，所以除非你想覆盖默认的主键行为，
否则没必要设置任何一个字段的primary_key=True。

• db_index

db_index=True, 代表为此字段设置索引

• default

为该字段设置默认值

• auto_now_add

DateField和DateTimeField中配置，
auto_now_add=True，创建数据记录的时候会把当前时间添加到数据库

• auto_now

DateField和DateTimeField中配置，
auto_now=True， 每次更新数据记录的时候会更新该字段

• blank

django admin里面提交数据时的限制。默认为False
blank=True，则在前端提交数据的时候字段可以为空

• choices

由二次元组成的一个可迭代对象（如：列表、元组），用来给字段提供选择项
如果设置了choices，默认的表单将是一个选择框而不是标准的文本框
而且这个选择框的选项就是choices中的选项

3、元数据

class Meta:
    # 设置表名
    db_table = "book"
    # 联合索引
    index_together = [
        ("name", "publish"),
    ]
    # 联合唯一索引
    unique_together = (("name", "publish"),)
    
    # 了解：
    # admin中显示的表名称（会在名字后面默认加上s）
    verbose_name = '图书'
    # 默认不加s
    verbose_name_plural = '图书'

六、打印原生SQL

在settings.py中粘贴如下代码：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console':{
            'level':'DEBUG',
            'class':'logging.StreamHandler',
        },
    },
    'loggers': {
        'django.db.backends': {
            'handlers': ['console'],
            'propagate': True,
            'level':'DEBUG',
        },
    }
}

小小的补充一下：除了配置以外，还可以通过 .query 查询SQL语句，具体操作如下：

七、查询表记录API（需要重点掌握）

查询API	描述
all()	查询所有结果
filter(**kwargs)	包含了与所给筛选条件相匹配的对象
get(**kwargs)	返回与所给筛选条件相匹配的对象 返回结果有且只有一个 如果符合筛选条件的对象超过一个或者没有都会抛异常
exclude(**kwargs)	包含了与所给筛选条件不匹配的对象
order_by(*field_name)	- 对查询结果进行排序（排序是在执行SQL语句的时候就已经排好的） - 倒序排就写order_by(-field_name) - 可以传多个参数
reverse()	对查询结果反向排序（没有参数，需要配合order_by一起使用） 类似于order_by(-field_name)
count()	返回数据库中匹配查询（QuerySet）的对象数量
first()	返回第一条记录
last()	返回最后一条数据
exists()	如果QuerySet包含数据，就返回True，否则返回False
values(*field_name)	返回一个valueQuerySet——一个特殊的QuerySet 运行后得到的不是一系列model的实例化对象，而是一个可迭代的字典序列 相当于是查找某一字段的所有值
values_list(*field_name)	它与value()很相似，返回的是一个元组序列
distinct()	从返回的结果中剔除重复记录

• 按返回值的种类进行分类：

# 返回值是QuerySet对象的：
	all()
    filter(**kwargs) 
    exclude(**kwargs)
    order_by(*field_name)
    reverse()
    distinct()
    
# 返回值是特殊的QuerySet的：
	values(*field_name)	返回的是一个valueQuerySet
    values_list(*field_name)  返回一个可迭代的字典序列
# 返回值是具体的对象的：
	get(**kwargs)
    first()
    last()
# 返回值是布尔值的：
	exsits()
# 返回值是数字的：
	count()

八、基于双下划线的模糊查询

#（1）列表范围
models.Book.object.filter(id__in=[1,2,3,10])  # 查询id在列表范围的值
models.Book.object.exclude(id__in=[1,2,3,10])  # 查询id不在列表范围的值
#（2） <、>、>=、<=
models.Book.object.filter(id__lt=10, id__gt=1)  # 查询1
models.Book.object.filter(id__gte=10)  # 查询id>=10的值
models.Book.object.filter(id__lte=10)  # 查询id<=10的值
#（3）范围
models.Book.object.filter(id__range=[10,20])  # 查询id为10-20的值
#（4）包含
models.Book.object.filter(name__contains='大')  # 查询name字段包含“大”的值
models.Book.object.filter(name__icontains='python')  # 查询name字段包含“python”的值(忽略大小写)
#（5）以...开头/结尾
models.Book.object.filter(name__startswith='大')  # 查询name字段以“大”开头的值
models.Book.object.filter(name__endswith='大')  # 查询name字段以“大”结尾的值
#（6）时间类型
models.Book.objects.filter(pub_date__year=2012)  # 查询pub_date字段为2012的值

九、删除表记录

删除表记录的两种方式:

# 第一种：request的delete方法（危险系数高，不建议使用）
	res = models.Book.objeccts.all().delete()
    print(res)  # 返回：(4, {'app01.Book':4}) 元组，记录删除操作 影响的记录条数
    
# 第二种：对象自己的delete的方法
book = models.Book.objects.all().filter(name='西游记').first()
print(type(book))  # 
res = book.delete()

十、修改表记录

两种方式：

# 第一种：QuerySet的update方法
	# 示例：将出版社为“东台”的记录 的name字段改成“红楼梦”
	res = models.Book.objects.filter(publish='东台').update(name='红楼梦')
    print(res)  # 1   影响了1行
    
# 第二种：对象自己的
	book = models.Book.objects.filter(name='xxx').last()
    book.name = 'bbb'
    book.save()  # 修改完毕需要保存（提交）一下

十一、python脚本中调用django环境

在项目跟路径下创建一个脚本文件 如：ss.py

# 在脚本中调用django服务
import os 
if __name__ == '__main__':
    # 1、引入django配置文件
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'aaa.settings')
    
    # 2、让django启动
    import django
    django.setup()
    
    # 3、使用表模型
    from app01 import models
    models.Book.objects.create(name='测试'，publish='翰林院')

十二、补充

• 时区和国际化问题

settings.py中修改配置
1、后台管理汉语问题
	LANGUAGE_CODE = 'zh-hans'  # 管理后台看到的就是中文
    
2、时区问题
	TIME_ZONE = 'Asia/Shanghai'
    USE_TZ = False

• django admin（管理后台的简单使用）

1、后台管理就是django提供的可以快速进行增删改查操作

• 字段合集：

AutoField(Field)
        - int自增列，必须填入参数 primary_key=True

    BigAutoField(AutoField)
        - bigint自增列，必须填入参数 primary_key=True

        注：当model中如果没有自增列，则自动会创建一个列名为id的列
        from django.db import models

        class UserInfo(models.Model):
            # 自动创建一个列名为id的且为自增的整数列
            username = models.CharField(max_length=32)

        class Group(models.Model):
            # 自定义自增列
            nid = models.AutoField(primary_key=True)
            name = models.CharField(max_length=32)

    SmallIntegerField(IntegerField):
        - 小整数 -32768 ～ 32767

    PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正小整数 0 ～ 32767
    IntegerField(Field)
        - 整数列(有符号的) -2147483648 ～ 2147483647

    PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正整数 0 ～ 2147483647

    BigIntegerField(IntegerField):
        - 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807

    BooleanField(Field)
        - 布尔值类型

    NullBooleanField(Field):
        - 可以为空的布尔值

    CharField(Field)
        - 字符类型
        - 必须提供max_length参数， max_length表示字符长度

    TextField(Field)
        - 文本类型

    EmailField(CharField)：
        - 字符串类型，Django Admin以及ModelForm中提供验证机制

    IPAddressField(Field)
        - 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制

    GenericIPAddressField(Field)
        - 字符串类型，Django Admin以及ModelForm中提供验证 Ipv4和Ipv6
        - 参数：
            protocol，用于指定Ipv4或Ipv6， 'both',"ipv4","ipv6"
            unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启此功能，需要protocol="both"

    URLField(CharField)
        - 字符串类型，Django Admin以及ModelForm中提供验证 URL

    SlugField(CharField)
        - 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号）

    CommaSeparatedIntegerField(CharField)
        - 字符串类型，格式必须为逗号分割的数字

    UUIDField(Field)
        - 字符串类型，Django Admin以及ModelForm中提供对UUID格式的验证

    FilePathField(Field)
        - 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
        - 参数：
                path,                      文件夹路径
                match=None,                正则匹配
                recursive=False,           递归下面的文件夹
                allow_files=True,          允许文件
                allow_folders=False,       允许文件夹

    FileField(Field)
        - 字符串，路径保存在数据库，文件上传到指定目录
        - 参数：
            upload_to = ""      上传文件的保存路径
            storage = None      存储组件，默认django.core.files.storage.FileSystemStorage

    ImageField(FileField)
        - 字符串，路径保存在数据库，文件上传到指定目录
        - 参数：
            upload_to = ""      上传文件的保存路径
            storage = None      存储组件，默认django.core.files.storage.FileSystemStorage
            width_field=None,   上传图片的高度保存的数据库字段名（字符串）
            height_field=None   上传图片的宽度保存的数据库字段名（字符串）

    DateTimeField(DateField)
        - 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]

    DateField(DateTimeCheckMixin, Field)
        - 日期格式      YYYY-MM-DD

    TimeField(DateTimeCheckMixin, Field)
        - 时间格式      HH:MM[:ss[.uuuuuu]]

    DurationField(Field)
        - 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型

    FloatField(Field)
        - 浮点型

    DecimalField(Field)
        - 10进制小数
        - 参数：
            max_digits，小数总长度
            decimal_places，小数位长度

    BinaryField(Field)
        - 二进制类型

• ORM字段与mysql字段对应关系

对应关系：
    'AutoField': 'integer AUTO_INCREMENT',
    'BigAutoField': 'bigint AUTO_INCREMENT',
    'BinaryField': 'longblob',
    'BooleanField': 'bool',
    'CharField': 'varchar(%(max_length)s)',
    'CommaSeparatedIntegerField': 'varchar(%(max_length)s)',
    'DateField': 'date',
    'DateTimeField': 'datetime',
    'DecimalField': 'numeric(%(max_digits)s, %(decimal_places)s)',
    'DurationField': 'bigint',
    'FileField': 'varchar(%(max_length)s)',
    'FilePathField': 'varchar(%(max_length)s)',
    'FloatField': 'double precision',
    'IntegerField': 'integer',
    'BigIntegerField': 'bigint',
    'IPAddressField': 'char(15)',
    'GenericIPAddressField': 'char(39)',
    'NullBooleanField': 'bool',
    'OneToOneField': 'integer',
    'PositiveIntegerField': 'integer UNSIGNED',
    'PositiveSmallIntegerField': 'smallint UNSIGNED',
    'SlugField': 'varchar(%(max_length)s)',
    'SmallIntegerField': 'smallint',
    'TextField': 'longtext',
    'TimeField': 'time',
    'UUIDField': 'char(32)',

ORM字段与MySQL字段对应关系