Model

1、Django model 經常使用字段和參數

1.1 經常使用字段

AutoField       int自增列，必須填入參數 primary_key=True。當model中若是沒有自增列，則自動會建立一個列名爲id的列
IntegerField    一個整數類型,範圍在 -2147483648 to 2147483647
CharField    　　字符類型，必須提供max_length參數， max_length表示字符長度
DateField    　　日期字段，日期格式  YYYY-MM-DD，至關於Python中的datetime.date()實例
DateTimeField   日期時間字段，格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]，至關於Python中的datetime.datetime()實例

# DateField 和 DateTimeField 字段的參數
auto_now_add=True   # 建立數據記錄的時候會把當前時間添加到數據庫
auto_now=True       # 每次更新數據記錄的時候會更新該字段

1.2 字段合集

AutoField(Field)
    int自增列，必須填入參數 primary_key=True

BigAutoField(AutoField)
    bigint自增列，必須填入參數 primary_key=True

注：當model中若是沒有自增列，則自動會建立一個列名爲id的列

 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)
    二進制類型

View Code

1.3 自定義字段

自定義char類型字段：

class FixedCharField(models.Field):
    """
    自定義的char類型的字段類
    """
    def __init__(self, max_length, *args, **kwargs):
        self.max_length = max_length
        super(FixedCharField, self).__init__(max_length=max_length, *args, **kwargs)

    def db_type(self, connection):
        """
        限定生成數據庫表的字段類型爲char，長度爲max_length指定的值
        """
        return 'char(%s)' % self.max_length


class Book(models.Model):
    id = models.AutoField(primary_key=True)
    name = models.CharField(max_length=16)
    # 使用自定義的char類型的字段
    publisher = FixedCharField(max_length=16)

View Code

1.4 ORM字段與數據庫實際字段的對應關係

'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)',

View Code

1.5 字段參數

null                數據庫中字段是否能夠爲空
db_column           數據庫中字段的列名
default             數據庫中字段的默認值
primary_key         數據庫中字段是否爲主鍵
db_index            數據庫中字段是否能夠創建索引
unique              數據庫中字段是否能夠創建惟一索引
unique_for_date     數據庫中字段【日期】部分是否能夠創建惟一索引
unique_for_month    數據庫中字段【月】部分是否能夠創建惟一索引
unique_for_year     數據庫中字段【年】部分是否能夠創建惟一索引

verbose_name        Admin中顯示的字段名稱
blank               Admin中是否容許用戶輸入爲空
editable            Admin中是否能夠編輯
help_text           Admin中該字段的提示信息
choices             Admin中顯示選擇框的內容，用不變更的數據放在內存中從而避免跨表操做
                    如：gender = models.IntegerField(choices=[(0, '女'), (1, '男')], default=1)

error_messages      自定義錯誤信息（字典類型），從而定製想要顯示的錯誤信息；
                    字典健：null, blank, invalid, invalid_choice, unique, and unique_for_date
                    如：
                    {'null': "不能爲空.", 'invalid': '格式錯誤'}

validators          自定義錯誤驗證（列表類型），從而定製想要的驗證規則
                    from django.core.validators import RegexValidator
                    from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\
                    MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator
                    如：
                    test = models.CharField(
                        max_length=32,
                        error_messages={
                            'c1': '優先錯信息1',
                            'c2': '優先錯信息2',
                            'c3': '優先錯信息3',
                        },
                        validators=[
                            RegexValidator(regex='root_\d+', message='錯誤了', code='c1'),
                            RegexValidator(regex='root_112233\d+', message='又錯誤了', code='c2'),
                            EmailValidator(message='又錯誤了', code='c3'), ]
                    )

View Code

1.6 元信息

 class UserInfo(models.Model):
    username = models.CharField(max_length=16)
    password = models.CharField(max_length=32)
    class Meta:
        # 數據庫中生成的表名稱，默認：app名稱 + 下劃線 + 類名
        db_table = "table_name"
        # 聯合索引
        index_together = [
            ("pub_date", "deadline"),
        ]
        # 聯合惟一索引
        unique_together = [
            ("driver", "restaurant"),
        ]
        # admin中顯示的表名稱
        verbose_name
        # verbose_name加s
        verbose_name_plural

View Code

2、Django ORM 關係字段

2.1 ForeignKey

外鍵類型在ORM中用來表示外鍵關聯關係，通常把 ForeignKey 字段設置在 "一對多"中"多"的一方；ForeignKey能夠和其餘表作關聯關係，同時也能夠和自身作關聯關係。

字段的參數：

to  設置要關聯的表

to_field  設置要關聯的表的字段

related_name  反向操做時，使用的字段名，用於代替原反向查詢時的"表名_set"

示例：

class Classes(models.Model):
    name = models.CharField(max_length=32)

class Student(models.Model):
    name = models.CharField(max_length=32)
    theclass = models.ForeignKey(to="Classes")

當要查詢某個班級關聯的全部學生（反向查詢）時，這麼寫：

models.Classes.objects.first().student_set.all()

當在ForeignKey字段中添加了參數 related_name 後：

class Student(models.Model):
    name = models.CharField(max_length=32)
    theclass = models.ForeignKey(to="Classes", related_name="students")

當要查詢某個班級關聯的全部學生（反向查詢）時，這麼寫：

models.Classes.objects.first().students.all()

related_query_name  反向查詢操做時，使用的鏈接前綴，用於替換表名；如：

models.UserGroup.objects.filter(表名__字段名=1).values("表名__字段名")

on_delete  當刪除關聯表中的數據時，當前表與其關聯的行的行爲

models.CASCADE
刪除關聯數據，與之關聯也刪除

models.DO_NOTHING
刪除關聯數據，引起錯誤IntegrityError

models.PROTECT
刪除關聯數據，引起錯誤ProtectedError

models.SET_NULL
刪除關聯數據，與之關聯的值設置爲null（前提FK字段須要設置爲可空）

models.SET_DEFAULT
刪除關聯數據，與之關聯的值設置爲默認值（前提FK字段須要設置默認值）

models.SET
刪除關聯數據
a. 與之關聯的值設置爲指定值，設置：models.SET(值)
b. 與之關聯的值設置爲可執行對象的返回值，設置：models.SET(可執行對象)

def func():
    return 10

class MyModel(models.Model):
    user = models.ForeignKey(
        to="User",
        to_field="id"，
        on_delete=models.SET(func)
      )

db_constraint  是否在數據庫中建立外鍵約束，默認爲True；若是設置爲False，至關於沒有創建約束（軟關聯）

2.2 OneToOneField

一對一字段；一般用來擴展已有字段。

示例：

一對一的關聯關係多用在當一張表的不一樣字段查詢頻次差距過大的狀況下，將本能夠存儲在一張表的字段拆開放置在兩張表中，而後將兩張表創建一對一的關聯關係。

# 字段參數同ForeignKey字段
to
to_field
on_delete

2.3 ManyToManyField

用於表示多對多的關聯關係；在數據庫中經過第三張表來創建關聯關係；ManyToManyField() 一般設置在正向查詢多的那一邊，好比：經過做者查書比經過書查做者多，那麼就設置在做者這邊。

2.3.1 字段的參數：

# 如下字段參數同ForeignKey字段
to
related_name
related_query_name
db_constraint

symmetrical  僅用於多對多自關聯時，指定內部是否建立反向操做的字段，默認爲True

示例：

class Person(models.Model):
    name = models.CharField(max_length=16)
    friends = models.ManyToManyField("self")

此時，person對象就沒有person_set屬性；

class Person(models.Model):
    name = models.CharField(max_length=16)
    friends = models.ManyToManyField("self", symmetrical=False)

此時，person對象如今就可使用 person_set 屬性進行反向查詢。

through

在使用ManyToManyField字段時，Django將自動生成一張表來管理多對多的關聯關係；但咱們也能夠手動建立第三張表來管理多對多關係，此時就須要經過 through 來指定第三張表的表名。

through_fields  自定義第三張表時，用於指定關係表中哪些字段創建多對多關係

db_table  默認建立第三張表時，數據庫中表的名稱

2.3.2 多對多關聯關係的三種建立方式

①經過ManyToManyField自動建立第三張表

②自行建立第三張表，利用外鍵分別關聯

③設置ManyToManyField並指定自行建立第三張表

注意：

當咱們須要在第三張關係表中存儲額外的字段時，就要使用第③種方式；可是當咱們使用這種方式建立多對多關聯關係時，就沒法使用 set、add、remove、clear 方法來管理多對多的關係了，須要經過第三張表的 model 來管理多對多關係（即直接在第三種表操做）。

models.Author2Book.objects.get(author_id=1, book_id=1).delete()

PS：

相親網站，男女約會是多對多的關係，第三張表中除了ORM自動建立的 id、boy_id、girl_id 以外，還要有約會日期，這個日期就是額外字段，就用第③種方式。