Django 模型

簡(jiǎn)介

模型是有關(guān)數(shù)據(jù)的唯一確定的信息源。它包含要存儲(chǔ)數(shù)據(jù)的基本字段和行為。通常，每個(gè)模型都映射到單個(gè)數(shù)據(jù)庫(kù)表。

• 每一個(gè)模型是django.db.models.Model的子類(lèi)
• 每一個(gè)模型屬性代表數(shù)據(jù)表的一個(gè)字段。
• Django提供了自動(dòng)生成的數(shù)據(jù)庫(kù)訪問(wèn)API，使用模型操作數(shù)據(jù)庫(kù)很方便

快速示例

此示例模型定義了一個(gè)Person，其中包含first_name和 last_name：

from django.db import models

class Person(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)

first_name并且last_name是場(chǎng)模型。每個(gè)字段都指定為類(lèi)屬性，并且每個(gè)屬性都映射到數(shù)據(jù)庫(kù)列。

上面的Person模型將創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)表，如下所示：

CREATE TABLE myapp_person (
    "id" serial NOT NULL PRIMARY KEY,
    "first_name" varchar(30) NOT NULL,
    "last_name" varchar(30) NOT NULL
);

一些技術(shù)說(shuō)明：

• 表的名稱myapp_person是自動(dòng)從某些模型元數(shù)據(jù)派生而來(lái)的，但是可以被覆蓋。
• 一個(gè)id字段被自動(dòng)添加，但這種行為可以被覆蓋。
• 在此示例中，SQL是使用PostgreSQL語(yǔ)法格式化的，但是值得注意的是Django使用了針對(duì)設(shè)置文件中指定的數(shù)據(jù)庫(kù)后端定制的SQL 。CREATE TABLE

詳情參考官網(wǎng)： https://docs.djangoproject.com/en/3.0/topics/db/models/

定義模型

Django根據(jù)屬性的類(lèi)型確定以下信息：

• 當(dāng)前選擇的數(shù)據(jù)庫(kù)支持字段的類(lèi)型
• 渲染管理表單時(shí)使用的默認(rèn)html控件
• 在管理站點(diǎn)最低限度的驗(yàn)證

django會(huì)為表創(chuàng)建自動(dòng)增長(zhǎng)的主鍵列，每個(gè)模型只能有一個(gè)主鍵列，如果使用選項(xiàng)設(shè)置某屬性為主鍵列后django不會(huì)再創(chuàng)建自動(dòng)增長(zhǎng)的主鍵列。

默認(rèn)創(chuàng)建的主鍵列屬性為id，可以使用pk代替，pk全拼為primary key。

pk是主鍵的別名，若主鍵名為id2，那么pk是id2的別名。

屬性命名限制：

• 不能是python的保留關(guān)鍵字。
• 不允許使用連續(xù)的下劃線，這是由django的查詢方式?jīng)Q定的，在第4節(jié)會(huì)詳細(xì)講解查詢。
• 定義屬性時(shí)需要指定字段類(lèi)型，通過(guò)字段類(lèi)型的參數(shù)指定選項(xiàng)。

       具體語(yǔ)法如下：

       屬性=models.字段類(lèi)型(選項(xiàng))

模型字段類(lèi)表

字段選項(xiàng)

• 通過(guò)字段選項(xiàng)，可以實(shí)現(xiàn)對(duì)字段的約束
• 在字段對(duì)象時(shí)通過(guò)關(guān)鍵字參數(shù)指定
• null：如果為T(mén)rue，Django 將空值以NULL 存儲(chǔ)到數(shù)據(jù)庫(kù)中，默認(rèn)值是 False
• blank：如果為T(mén)rue，則該字段允許為空白，默認(rèn)值是 False
• 對(duì)比：null是數(shù)據(jù)庫(kù)范疇的概念，blank是表單驗(yàn)證證范疇的
• db_column：字段的名稱，如果未指定，則使用屬性的名稱
• db_index：若值為 True, 則在表中會(huì)為此字段創(chuàng)建索引
• default：默認(rèn)值
• primary_key：若為 True, 則該字段會(huì)成為模型的主鍵字段
• unique：如果為 True, 這個(gè)字段在表中必須有唯一值

關(guān)聯(lián)關(guān)系

多對(duì)一 (ForeignKey)

Django提供了定義了幾種最常見(jiàn)的數(shù)據(jù)庫(kù)關(guān)聯(lián)關(guān)系的方法：多對(duì)一，多對(duì)多，一對(duì)一。

多對(duì)一關(guān)系，需要兩個(gè)位置參數(shù)，一個(gè)是關(guān)聯(lián)的模型，另一個(gè)是 on_delete 選項(xiàng)，外鍵要定義在多的一方，如一個(gè)汽車(chē)廠生產(chǎn)多種汽車(chē)，一輛汽車(chē)只有一個(gè)生產(chǎn)廠家

from django.db import models
class Manufacturer(models.Model):
    # ...
    pass
class Car(models.Model):
    manufacturer = models.ForeignKey(Manufacturer, on_delete=models.CASCADE)

多對(duì)多關(guān)系的額外字段：throuth

例如：這樣一個(gè)應(yīng)用，它記錄音樂(lè)家所屬的音樂(lè)小組。 我們可以用一個(gè)ManyToManyField 表示小組和成員之間的多對(duì)多關(guān)系。 但是，有時(shí)你可能想知道更多成員關(guān)系的細(xì)節(jié)，比如成員是何時(shí)加入小組的。

對(duì)于這些情況，Django 允許你指定一個(gè)中介模型來(lái)定義多對(duì)多關(guān)系。 你可以將其他字段放在中介模型里面。 源模型的ManyToManyField 字段將使用through 參數(shù)指向中介模型。 對(duì)于上面的音樂(lè)小組的例子，代碼如下：

from django.db import models

class Person(models.Model):
    name = models.CharField(max_length=128)

    def __str__(self):              # __unicode__ on Python 2
        return self.name

class Group(models.Model):
    name = models.CharField(max_length=128)
    members = models.ManyToManyField(Person, through='Membership')

    def __str__(self):              # __unicode__ on Python 2
        return self.name

class Membership(models.Model):
    person = models.ForeignKey(Person, on_delete=models.CASCADE)
    group = models.ForeignKey(Group, on_delete=models.CASCADE)
    date_joined = models.DateField()
    invite_reason = models.CharField(max_length=64)

您需要在設(shè)置中間模型的時(shí)候，顯式地為多對(duì)多關(guān)系中涉及的中間模型指定外鍵。這種顯式聲明定義了這兩個(gè)模型之間是如何關(guān)聯(lián)的。

在中間模型當(dāng)中有一些限制條件：

• 你的模型中間要么有且僅有一個(gè)指向源模型（我們例子當(dāng)中的Group）的外鍵，你要么必須通過(guò)ManyToManyField.through_fields參數(shù)在多個(gè)外鍵當(dāng)中手動(dòng)選擇一個(gè)外鍵，有如果外個(gè)多鍵盤(pán)沒(méi)有用through_fields 參數(shù)選擇一個(gè)的話，會(huì)出現(xiàn)驗(yàn)證錯(cuò)誤。對(duì)于某個(gè)目標(biāo)模型（我們示例當(dāng)中的Person）的外鍵也有同樣的限制。
• 在一個(gè)有用的描述模型當(dāng)中自己指向自己的多對(duì)多關(guān)系的中間模型當(dāng)中，可以有兩個(gè)指向同一個(gè)模型的外健，但這兩個(gè)外健分表代表多對(duì)多關(guān)系（不同）的兩端。如果外健的個(gè)數(shù)超過(guò)兩個(gè)，你必須和上面一樣的指定through_fields參數(shù)，要不然會(huì)出現(xiàn)驗(yàn)證錯(cuò)誤。

現(xiàn)在你已經(jīng)通過(guò)中間模型完成你的ManyToManyField（示例中的Membership），可以開(kāi)始創(chuàng)建一些多對(duì)多關(guān)系了。你通過(guò)實(shí)例化中間模型來(lái)創(chuàng)建關(guān)系：

>>> paul = Person.objects.create(name="Paul McCartney")
>>> beatles = Group.objects.create(name="The Beatles")
>>> m1 = Membership(person=ringo, group=beatles,
...     date_joined=date(1962, 8, 16),
...     invite_reason="Needed a new drummer.")
>>> m1.save()
>>> beatles.members.all()
<QuerySet [<Person: Ringo Starr>]>
>>> ringo.group_set.all()
<QuerySet [<Group: The Beatles>]>
>>> m2 = Membership.objects.create(person=paul, group=beatles,
...     date_joined=date(1960, 8, 1),
...     invite_reason="Wanted to form a band.")
>>> beatles.members.all()
<QuerySet [<Person: Ringo Starr>, <Person: Paul McCartney>]>

你也可以使用add()、、create()或set()創(chuàng)建關(guān)系，只要你為任何必需的細(xì)分指定 through_defaults：

>>> beatles.members.add(john, through_defaults={'date_joined': date(1960, 8, 1)})
>>> beatles.members.create(name="George Harrison", through_defaults={'date_joined': date(1960, 8, 1)})
>>> beatles.members.set([john, paul, ringo, george], through_defaults={'date_joined': date(1960, 8, 1)})

>>> Membership.objects.create(person=ringo, group=beatles,
...     date_joined=date(1968, 9, 4),
...     invite_reason="You've been gone for a month and we miss you.")
>>> beatles.members.all()
<QuerySet [<Person: Ringo Starr>, <Person: Paul McCartney>, <Person: Ringo Starr>]>
>>> # This deletes both of the intermediate model instances for Ringo Starr
>>> beatles.members.remove(ringo)
>>> beatles.members.all()
<QuerySet [<Person: Paul McCartney>]>

方法clear()用于實(shí)例的所有多對(duì)多關(guān)系：

>>> # Beatles have broken up
>>> beatles.members.clear()
>>> # Note that this deletes the intermediate model instances
>>> Membership.objects.all()
<QuerySet []>

一旦你建立了自定義多對(duì)多關(guān)聯(lián)關(guān)系，就可以執(zhí)行查詢操作。和一般的多對(duì)多關(guān)聯(lián)關(guān)系一樣，你可以使用多對(duì)多關(guān)聯(lián)模型的屬性來(lái)查詢：

# Find all the groups with a member whose name starts with 'Paul'
>>> Group.objects.filter(members__name__startswith='Paul')
<QuerySet [<Group: The Beatles>]>

# Find all the members of the Beatles that joined after 1 Jan 1961
>>> Person.objects.filter(
...     group__name='The Beatles',
...     membership__date_joined__gt=date(1961,1,1))
<QuerySet [<Person: Ringo Starr]>

>>> ringos_membership = Membership.objects.get(group=beatles, person=ringo)
>>> ringos_membership.date_joined
datetime.date(1962, 8, 16)
>>> ringos_membership.invite_reason
'Needed a new drummer.'

>>> ringos_membership = ringo.membership_set.get(group=beatles)
>>> ringos_membership.date_joined
datetime.date(1962, 8, 16)
>>> ringos_membership.invite_reason
'Needed a new drummer.'

一對(duì)一關(guān)聯(lián)

使用OneToOneField來(lái)定義一對(duì)一關(guān)系。就像使用其他類(lèi)型的Field一樣：在模型屬性中包含它。

當(dāng)一個(gè)對(duì)象以某種方式“繼承”另一個(gè)對(duì)象時(shí)，這那個(gè)對(duì)象的主鍵非常有用。

OneToOneField需要一個(gè)位置參數(shù)：與模型相關(guān)的類(lèi)。

例如，當(dāng)你要建立一個(gè)有關(guān)“位置”信息的數(shù)據(jù)庫(kù)時(shí)，你可能會(huì)包含通常的地址，電話等分支。然后，如果你想接著建立一個(gè)關(guān)于關(guān)于餐廳的數(shù)據(jù)庫(kù)，除了將位置數(shù)據(jù)庫(kù)當(dāng)中的一部分復(fù)制到Restaurant模型，你也可以將一個(gè)指向Place OneToOneField放到Restaurant當(dāng)中（因?yàn)椴蛷d“是一個(gè)”地點(diǎn)）；事實(shí)上，在處理這樣的情況時(shí)最好使用模型繼承，它隱含的包括了一個(gè)一對(duì)一關(guān)系。

和 ForeignKey一樣，可以創(chuàng)建自關(guān)聯(lián)關(guān)系也可以創(chuàng)建與尚未定義的模型的關(guān)系。

OneToOneField初步還接受一個(gè)可選的parent_link參數(shù)。

OneToOneField類(lèi)通常自動(dòng)的成為模型的主鍵，這條規(guī)則現(xiàn)在不再使用了（而你可以手動(dòng)指定primary_key參數(shù)）。因此，現(xiàn)在可以在其中的模型當(dāng)中指定多個(gè)OneToOneField分段。

詳情參考官網(wǎng):  https://www.khan.pub/django3.0/index.html