Django 框架03: 模型定义

模型

1.定义模型
    ①在模型中定义属性，会生成表中的字段
    ②django根据属性的类型确定以下信息：
        当前选择的数据库支持字段的类型
        渲染管理表单时使用的默认html控件
        在管理站点最低限度的验证
    ③django会为表增加自动增长的主键列，每个模型只能有一个主键列，如果使用选项设置某属性为主键列后，则django不会再生成默认的主键列
    ④属性命名限制
        不能是python的保留关键字
        由于django的查询方式，不允许使用连续的下划线

2.定义属性
    ①定义属性时，需要字段类型
    ②字段类型被定义在django.db.models.fields目录下，为了方便使用，被导入到django.db.models中
    ③使用方式
        导入from django.db import models
        通过models.Field创建字段类型的对象，赋值给属性
    ④对于重要数据都做逻辑删除，不做物理删除，实现方法是定义isDelete属性，类型为BooleanField，默认值为False

3.字段类型
    ①AutoField：一个根据实际ID自动增长的IntegerField，通常不指定
    ②BooleanField：true/false 字段，此字段的默认表单控制是CheckboxInput
    ③NullBooleanField：支持null、true、false三种值
    ④CharField(max_length=字符长度)：字符串，默认的表单样式是 TextInput
    ⑤TextField：大文本字段，一般超过4000使用，默认的表单控件是Textarea
    ⑥IntegerField：整数
    ⑦DecimalField(max_digits=None, decimal_places=None)：使用python的Decimal实例表示的十进制浮点数
        DecimalField.max_digits：位数总数
        DecimalField.decimal_places：小数点后的数字位数
    ⑧FloatField：用Python的float实例来表示的浮点数
    ⑨DateField[auto_now=False, auto_now_add=False])：使用Python的datetime.date实例表示的日期
       参数DateField.auto_now：每次保存对象时，自动设置该字段为当前时间，用于"最后一次修改"的时间戳，它总是使用当前日期，默认为false
       参数DateField.auto_now_add：当对象第一次被创建时自动设置当前时间，用于创建的时间戳，它总是使用当前日期，默认为false
       该字段默认对应的表单控件是一个TextInput. 在管理员站点添加了一个JavaScript写的日历控件，和一个“Today"的快捷按钮，包含了一个额外的invalid_date错误消息键
       auto_now_add, auto_now, and default 这些设置是相互排斥的，他们之间的任何组合将会发生错误的结果
    ⑩TimeField：使用Python的datetime.time实例表示的时间，参数同DateField
    ①①DateTimeField：使用Python的datetime.datetime实例表示的日期和时间，参数同DateField
    ①②FileField：一个上传文件的字段
    ①③ImageField：继承了FileField的所有属性和方法，但对上传的对象进行校验，确保它是个有效的image

4.字段选项
    通过字段选项，可以实现对字段的约束
    ①null：如果为True，Django 将空值以NULL 存储到数据库中，默认值是 False
    ②blank：如果为True，则该字段允许为空白，默认值是 False
        对比：null是数据库范畴的概念，blank是表单验证范畴的
    ③db_column：字段的名称，如果未指定，则使用属性的名称
    ④db_index：若值为 True, 则在表中会为此字段创建索引
    ⑤default：默认值
    ⑥primary_key：若为 True, 则该字段会成为模型的主键字段
    ⑦unique：如果为 True, 这个字段在表中必须有唯一值

5.关系
    ①关系的类型包括
        ForeignKey：一对多，将字段定义在多的端中
        ManyToManyField：多对多，将字段定义在两端中
        OneToOneField：一对一，将字段定义在任意一端中
    ②可以维护递归的关联关系，使用'self'指定，详见“自关联”
    ③用一访问多：对象.模型类小写_set

bookinfo.heroinfo_set

    ④用一访问一：对象.模型类小写

heroinfo.bookinfo

    ⑤访问id：对象.属性_id

heroinfo.book_id

6.元选项
    在模型类中定义类Meta，用于设置元信息
    元信息db_table：定义数据表名称，推荐使用小写字母，数据表的默认名称

class Meta():
    ordering = ['id']

    字符串前加-表示倒序，不加-表示正序

class Meta():
    ordering = ['-id']

    排序会增加数据库的开销

模型成员

1.类的属性
    ①objects：是Manager类型的对象，用于与数据库进行交互
    ②当定义模型类时没有指定管理器，则Django会为模型类提供一个名为objects的管理器
    ③支持明确指定模型类的管理器

books = models.Manager()

     ④当为模型类指定管理器后，django不再为模型类生成名为objects的默认管理器

2.管理器Manager
    管理器是Django的模型进行数据库的查询操作的接口，Django应用的每个模型都拥有至少一个管理器
    自定义管理器类主要用于两种情况
    情况一：向管理器类中添加额外的方法：见下面“创建对象”中的方式二
    情况二：修改管理器返回的原始查询集：重写get_queryset()方法

class BookInfoManager(models.Manager):
    def get_queryset(self):
        return super(BookInfoManager, self).get_queryset().filter(isDelete=False)
class BookInfo(models.Model):
    ...
books = BookInfoManager()

3.创建对象
    ①当创建对象时，django不会对数据库进行读写操作
    ②调用save()方法才与数据库交互，将对象保存到数据库中
    ③使用关键字参数构造模型对象很麻烦，推荐使用下面的两种之式
    说明： _init _方法已经在基类models.Model中使用，在自定义模型中无法使用，
    方式一：在模型类中增加一个类方法

class BookInfo(models.Model):
    ...
    @classmethod
    def create(cls, title, pub_date):
        book = cls(btitle=title, bpub_date=pub_date)
        book.bread=0
        book.bcommet=0
        book.isDelete = False
        return book

# 引入时间包
from datetime import *
# 调用
book=BookInfo.create("hello",datetime(1980,10,11));
# 保存
book.save()

    方式二：在自定义管理器中添加一个方法
    在管理器的方法中，可以通过self.model来得到它所属的模型类

class BookInfoManager(models.Manager):
    def create_book(self, title, pub_date):
        book = self.model()
        book.btitle = title
        book.bpub_date = pub_date
        book.bread=0
        book.bcommet=0
        book.isDelete = False
        return book
class BookInfo(models.Model):
    ...
    books = BookInfoManager()

# 调用
book=BookInfo.books.create_book("abc",datetime(1980,1,1))
# 保存
book.save()

     在方式二中，可以调用self.create()创建并保存对象，不需要再手动save()

class BookInfoManager(models.Manager):
    def create_book(self, title, pub_date):
        book = self.create(btitle = title,bpub_date = pub_date,bread=0,bcommet=0,isDelete = False)
        return book

class BookInfo(models.Model):
    ...
    books = BookInfoManager()

# 调用
book=Book.books.create_book("abc",datetime(1980,1,1))
# 查看
book.pk

4.实例的属性
    DoesNotExist：在进行单个查询时，模型的对象不存在时会引发此异常，结合try/except使用

5.实例的方法
    str (self)：重写object方法，此方法在将对象转换成字符串时会被调用
    save()：将模型对象保存到数据表中
    delete()：将模型对象从数据表中删除