【03】Django框架：模型定义

一、模型

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.字段类型

　　1) AutoField

　　　　一个根据实际ID自动增长的IntegerField，通常不指定。

　　2) BooleanField

　　　　true/false 字段，此字段的默认表单控制是CheckboxInput。

　　3) NullBooleanField

　　　　支持null、true、false三种值。

　　4) CharField(max_length=字符长度)

　　　　字符串，默认的表单样式是 TextInput。
　　5) TextField

　　　　大文本字段，一般超过4000使用，默认的表单控件是Textarea。

　　6) IntegerField

　　　　整数。
　　7) DecimalField(max_digits=None, decimal_places=None)

　　　　使用python的Decimal实例表示的十进制浮点数。
　　　　①DecimalField.max_digits：位数总数。
　　　　②DecimalField.decimal_places：小数点后的数字位数。

　　8) FloatField

　　　　用Python的float实例来表示的浮点数。

　　9) 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 这些设置是相互排斥的，他们之间的任何组合将会发生错误的结果。

　　10) TimeField

　　　　使用Python的datetime.time实例表示的时间，参数同DateField。

　　11) DateTimeField

　　　　使用Python的datetime.datetime实例表示的日期和时间，参数同DateField。

　　12) FileField

　　　　一个上传文件的字段。

　　13) 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.关系

　　1) 关系的类型

　　　　①ForeignKey：一对多，将字段定义在多的端中。
　　　　②ManyToManyField：多对多，将字段定义在两端中。
　　　　③OneToOneField：一对一，将字段定义在任意一端中。
　　2) 维护递归的关联关系

　　　　使用'self'指定，详见关联。
　　3) 用一访问多

　　　　对象.模型类小写_set。

bookinfo.heroinfo_set

　　4) 用一访问一

　　　　对象.模型类小写。

heroinfo.bookinfo

　　5) 访问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()：将模型对象从数据表中删除。