Django 模型(model)--2

學習教程來源:Django學習

1.多對一關係

多對一的關係,通常被稱爲外鍵。外鍵字段類的定義如下:

class ForeignKey(to, on_delete, **options)[source]

on_delete 級聯刪除

  • CASCADE:模擬SQL語言中的ON DELETE CASCADE約束,將定義有外鍵的模型對象同時刪除!(該操作爲當前Django版本的默認操作!)
  • PROTECT:阻止上面的刪除操作,但是彈出ProtectedError異常
  • SET_NULL:將外鍵字段設爲null,只有當字段設置了null=True時,方可使用該值。
  • SET_DEFAULT:將外鍵字段設爲默認值。只有當字段設置了default參數時,方可使用。
  • DO_NOTHING:什麼也不做。
  • SET():設置爲一個傳遞給SET()的值或者一個回調函數的返回值。注意大小寫。

 

外鍵需要兩個位置參數,一個是關聯的模型,另一個是on_delete選項。

from django.db import models

class Car(models.Model):
    manufacturer = models.ForeignKey(
        'Manufacturer',
        on_delete=models.CASCADE,
    )
    # ...

class Manufacturer(models.Model):
    # ...
    pass

上面的例子中,每輛車都會有一個生產工廠,一個工廠可以生產N輛車,於是用一個外鍵字段manufacturer表示,並放在Car模型中。注意,此manufacturer非彼Manufacturer模型類,它是一個字段的名稱。在Django的模型定義中,經常出現類似的英文單詞大小寫不同,一定要注意區分!

如果要關聯的對象在另外一個app中,可以顯式的指出。下例假設Manufacturer模型存在於production這個app中,則Car模型的定義如下(重要,這個應該會經常用到):

class Car(models.Model):
    manufacturer = models.ForeignKey(
        'production.Manufacturer',      # 關鍵在這裏!!
        on_delete=models.CASCADE,
    )

遞歸的外鍵,也就是自己關聯自己的的外鍵(相當於學生選課數據庫中課程表的前導課程):

models.ForeignKey('self', on_delete=models.CASCADE)

核心在於‘self’這個引用。什麼時候需要自己引用自己的外鍵呢?典型的例子就是評論系統!一條評論可以被很多人繼續評論,如下所示:

class Comment(models.Model):
    title = models.CharField(max_length=128)
    text = models.TextField()
    parent_comment = models.ForeignKey('self', on_delete=models.CASCADE)
    # .....

注意上面的外鍵字段定義的是父評論,而不是子評論。爲什麼呢?因爲外鍵要放在‘多’的一方!(一個評論可以有多個評論回覆之,被回覆的爲父評論,回覆的爲子評論,也就是子評論引用其父評論)

關係字段的定義還有個小坑。verbose_name參數用於設置字段的別名。很多情況下,爲了方便,我們都會設置這麼個值,並且作爲字段的第一位置參數。但是對於關係字段,其第一位置參數永遠是關係對象,不能是verbose_name,一定要注意!

常用屬性:

1)on_delete

當一個被外鍵關聯的對象被刪除時,Django將模仿on_delete參數定義的SQL約束執行相應操作。比如,你有一個可爲空的外鍵,並且你想讓它在關聯的對象被刪除時,自動設爲null,可以如下定義:

user = models.ForeignKey(
    User,
    models.SET_NULL,
    blank=True,
    null=True,
)

2)limit_choices_to

該參數用於限制外鍵所能關聯的對象,只能用於Django的ModelForm(Django的表單模塊)和admin後臺,對其它場合無限制功能。其值可以是一個字典、Q對象或者一個返回字典或Q對象的函數調用,如下例所示:

staff_member = models.ForeignKey(
    User,
    on_delete=models.CASCADE,
    limit_choices_to={'is_staff': True},
)

這樣定義,則ModelForm的staff_member字段列表中,只會出現那些is_staff=True的Users對象,這一功能對於admin後臺非常有用。

3)related_name

用於關聯對象反向引用模型的名稱。

4)related_query_name

反向關聯查詢名。用於從目標模型反向過濾模型對象的名稱。

5)to_field

默認情況下,外鍵都是關聯到被關聯對象的主鍵上(一般爲id)。如果指定這個參數,可以關聯到指定的字段上,但是該字段必須具有unique=True屬性,也就是具有唯一屬性。

6)db_constraint

默認情況下,這個參數被設爲True,表示遵循數據庫約束,這也是大多數情況下你的選擇。如果設爲False,那麼將無法保證數據的完整性和合法性。在下面的場景中,你可能需要將它設置爲False:

  • 有歷史遺留的不合法數據,沒辦法的選擇
  • 你正在分割數據表

當它爲False,並且你試圖訪問一個不存在的關係對象時,會拋出DoesNotExist 異常。

7)swappable

控制遷移框架的動作,如果當前外鍵指向一個可交換的模型。使用場景非常稀少,通常請將該參數保持默認的True。

 

2.多對多關係

多對多關係在數據庫中也是非常常見的關係類型。比如一本書可以有好幾個作者,一個作者也可以寫好幾本書。多對多的字段可以定義在任何的一方,請儘量定義在符合人們思維習慣的一方,但不要同時都定義。

class ManyToManyField(to, **options)[source]

多對多關係需要一個位置參數:關聯的對象模型。它的用法和外鍵多對一基本類似。

在數據庫後臺,Django實際上會額外創建一張用於體現多對多關係的中間表。默認情況下,該表的名稱是“多對多字段名+關聯對象模型名+一個獨一無二的哈希碼”,例如‘author_books_9cdf4’,當然你也可以通過db_table選項,自定義表名。

1)related_name

用於關聯對象反向引用模型的名稱。

2)related_query_name

反向關聯查詢名。用於從目標模型反向過濾模型對象的名稱。

3)limit_choices_to

該參數用於限制外鍵所能關聯的對象,只能用於Django的ModelForm(Django的表單模塊)和admin後臺,對其它場合無限制功能。但是對於使用through參數自定義中間表的多對多字段無效。

4)symmetrical

默認情況下,Django中的多對多關係是對稱的。

5)through(定義中間表)

如果你想自定義多對多關係的那張額外的關聯表,可以使用這個參數!參數的值爲一箇中間模型。

最常見的使用場景是你需要爲多對多關係添加額外的數據,比如兩個人建立QQ好友的時間。

通常情況下,這張表在數據庫內的結構是這個樣子的:

中間表的id列....模型對象的id列.....被關聯對象的id列
# 各行數據

如果自定義中間表並添加時間字段,則在數據庫內的表結構如下:

中間表的id列....模型對象的id列.....被關聯對象的id列.....時間對象列
# 各行數據

看下面的例子:

from django.db import models

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

class Group(models.Model):
    name = models.CharField(max_length=128)
    members = models.ManyToManyField(
        Person,
        through='Membership',       ## 自定義中間表
        through_fields=('group', 'person'),
    )

class Membership(models.Model):  # 這就是具體的中間表模型
    group = models.ForeignKey(Group, on_delete=models.CASCADE)
    person = models.ForeignKey(Person, on_delete=models.CASCADE)
    inviter = models.ForeignKey(
        Person,
        on_delete=models.CASCADE,
        related_name="membership_invites",
    )
    invite_reason = models.CharField(max_length=64)

上面的代碼中,通過class Membership(models.Model)定義了一個新的模型,用來保存Person和Group模型的多對多關係,並且同時增加了‘邀請人’和‘邀請原因’的字段。

through參數在某些使用場景中是必須的,至關重要,請務必掌握!

6)through_fields

through_fields參數接收一個二元元組('field1', 'field2'),field1是指向定義有多對多關係的模型的外鍵字段的名稱,這裏是Membership中的‘group’字段(注意大小寫),另外一個則是指向目標模型的外鍵字段的名稱,這裏是Membership中的‘person’,而不是‘inviter’。

再通俗的說,就是through_fields參數指定從中間表模型Membership中選擇哪兩個字段,作爲關係連接字段。

7)db_table

設置中間表的名稱。不指定的話,則使用默認值。

8)db_constraint

9)swappable

ManyToManyField多對多字段不支持Django內置的validators驗證功能。

null參數對ManyToManyField多對多字段無效!設置null=True毫無意義

3.一對一關係

 

一對一關係類型的定義如下:

class OneToOneField(to, on_delete, parent_link=False, **options)[source]

從概念上講,一對一關係非常類似具有unique=True屬性的外鍵關係,但是反向關聯對象只有一個。這種關係類型多數用於當一個模型需要從別的模型擴展而來的情況。比如,Django自帶auth模塊的User用戶表,如果你想在自己的項目裏創建用戶模型,又想方便的使用Django的認證功能,那麼一個比較好的方案就是在你的用戶模型裏,使用一對一關係,添加一個與auth模塊User模型的關聯字段。

該關係的第一位置參數爲關聯的模型,其用法和前面的多對一外鍵一樣。

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章