django第二次 （轉自劉江）

除了咱們前面說過的普通類型字段，Django還定義了一組關係類型字段，用來表示模型與模型之間的關係。

1、多對一（ForeignKey）

多對一的關係，一般被稱爲外鍵。外鍵字段類的定義以下：

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

外鍵須要兩個位置參數，一個是關聯的模型，另外一個是on_delete選項。實際上，在目前版本中，on_delete選項也能夠不設置，但Django極力反對如此，所以在Django2.0版本後，該選項會設置爲必填。

外鍵要定義在‘多’的一方！

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) # ..... 

注意上面的外鍵字段定義的是父評論，而不是子評論。爲何呢？由於外鍵要放在‘多’的一方！

在實際的數據庫後臺，Django會爲每個外鍵添加_id後綴，並以此建立數據表裏的一列。在上面的工廠與車的例子中，Car模型對應的數據表中，會有一列叫作manufacturer_id。但實際上，在Django代碼中你不須要使用這個列名，除非你書寫原生的SQL語句，通常咱們都直接使用字段名manufacturer。

關係字段的定義還有個小坑。在後面咱們會講到的verbose_name參數用於設置字段的別名。不少狀況下，爲了方便，咱們都會設置這麼個值，而且做爲字段的第一位置參數。可是對於關係字段，其第一位置參數永遠是關係對象，不能是verbose_name，必定要注意！

參數說明：

外鍵還有一些重要的參數，說明以下：

on_delete

注意：這個參數在Django2.0以後，不能夠省略了，須要顯式的指定！這也是除了路由編寫方式外，Django2和Django1.x最大的不一樣點之一！

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

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

該參數可選的值都內置在django.db.models中，包括：

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

from django.conf import settings from django.contrib.auth import get_user_model from django.db import models def get_sentinel_user(): return get_user_model().objects.get_or_create(username='deleted')[0] class MyModel(models.Model): user = models.ForeignKey( settings.AUTH_USER_MODEL, on_delete=models.SET(get_sentinel_user), ) 

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後臺很是有用。

能夠參考下面的方式，使用函數調用：

def limit_pub_date_choices(): return {'pub_date__lte': datetime.date.utcnow()} # ... limit_choices_to = limit_pub_date_choices # ... 

related_name

用於關聯對象反向引用模型的名稱。之前面車和工廠的例子解釋，就是從工廠反向關聯到車的關係名稱。

一般狀況下，這個參數咱們能夠不設置，Django會默認以模型的小寫做爲反向關聯名，好比對於工廠就是car，若是你以爲car還不夠直觀，能夠以下定義：

class Car(models.Model): manufacturer = models.ForeignKey( 'production.Manufacturer', on_delete=models.CASCADE, related_name='car_producted_by_this_manufacturer', # 看這裏！！ ) 

也許我定義了一個蹩腳的詞，但表達的意思很清楚。之後從工廠對象反向關聯到它所生產的汽車，就可使用maufacturer.car_producted_by_this_manufacturer了。

若是你不想爲外鍵設置一個反向關聯名稱，能夠將這個參數設置爲「+」或者以「+」結尾，以下所示：

user = models.ForeignKey( User, on_delete=models.CASCADE, related_name='+', ) 

related_query_name

反向關聯查詢名。用於從目標模型反向過濾模型對象的名稱。（過濾和查詢在後續章節會介紹）

class Tag(models.Model): article = models.ForeignKey( Article, on_delete=models.CASCADE, related_name="tags", related_query_name="tag", # 注意這一行 ) name = models.CharField(max_length=255) # 如今可使用‘tag’做爲查詢名了 Article.objects.filter(tag__name="important") 

to_field

默認狀況下，外鍵都是關聯到被關聯對象的主鍵上（通常爲id）。若是指定這個參數，能夠關聯到指定的字段上，可是該字段必須具備unique=True屬性，也就是具備惟一屬性。

db_constraint

默認狀況下，這個參數被設爲True，表示遵循數據庫約束，這也是大多數狀況下你的選擇。若是設爲False，那麼將沒法保證數據的完整性和合法性。在下面的場景中，你可能須要將它設置爲False：

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

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

swappable

控制遷移框架的動做，若是當前外鍵指向一個可交換的模型。使用場景很是稀少，一般請將該參數保持默認的True。

2、多對多（ManyToManyField）

多對多關係在數據庫中也是很是常見的關係類型。好比一本書能夠有好幾個做者，一個做者也能夠寫好幾本書。多對多的字段能夠定義在任何的一方，請儘可能定義在符合人們思惟習慣的一方，但不要同時都定義。

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

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

在數據庫後臺，Django實際上會額外建立一張用於體現多對多關係的中間表。默認狀況下，該表的名稱是「多對多字段名+關聯對象模型名+一個獨一無二的哈希碼」，例如‘author_books_9cdf4’，固然你也能夠經過db_table選項，自定義表名。

參數說明：

related_name

參考外鍵的相同參數。

related_query_name

參考外鍵的相同參數。

limit_choices_to

參考外鍵的相同參數。可是對於使用through參數自定義中間表的多對多字段無效。

symmetrical

默認狀況下，Django中的多對多關係是對稱的。看下面的例子：

from django.db import models class Person(models.Model): friends = models.ManyToManyField("self") 

Django認爲，若是我是你的朋友，那麼你也是個人朋友，這是一種對稱關係，Django不會爲Person模型添加person_set屬性用於反向關聯。若是你不想使用這種對稱關係，能夠將symmetrical設置爲False，這將強制Django爲反向關聯添加描述符。

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參數在某些使用場景中是必須的，相當重要，請務必掌握！

through_fields

接着上面的例子。Membership模型中包含兩個關聯Person的外鍵，Django沒法肯定到底使用哪一個做爲和Group關聯的對象。因此，在這個例子中，必須顯式的指定through_fields參數，用於定義關係。

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

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

db_table

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

db_constraint

參考外鍵的相同參數。

swappable

參考外鍵的相同參數。

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

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

3、一對一（OneToOneField）

一對一關係類型的定義以下：

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

從概念上講，一對一關係很是相似具備unique=True屬性的外鍵關係，可是反向關聯對象只有一個。這種關係類型多數用於當一個模型須要從別的模型擴展而來的狀況。好比，Django自帶auth模塊的User用戶表，若是你想在本身的項目裏建立用戶模型，又想方便的使用Django的認證功能，那麼一個比較好的方案就是在你的用戶模型裏，使用一對一關係，添加一個與auth模塊User模型的關聯字段。

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

若是你沒有給一對一關係設置related_name參數，Django將使用當前模型的小寫名做爲默認值。

看下面的例子：

from django.conf import settings from django.db import models # 兩個字段都使用一對一關聯到了Django內置的auth模塊中的User模型 class MySpecialUser(models.Model): user = models.OneToOneField( settings.AUTH_USER_MODEL, on_delete=models.CASCADE, ) supervisor = models.OneToOneField( settings.AUTH_USER_MODEL, on_delete=models.CASCADE, related_name='supervisor_of', ) 

這樣下來，你的User模型將擁有下面的屬性：

>>> user = User.objects.get(pk=1)
>>> hasattr(user, 'myspecialuser')
True
>>> hasattr(user, 'supervisor_of')
True

OneToOneField一對一關係擁有和多對一外鍵關係同樣的額外可選參數，只是多了一個parent_link參數。

---

跨模塊的模型：

有時候，咱們關聯的模型並不在當前模型的文件內，不要緊，就像咱們導入第三方庫同樣的從別的模塊內導入進來就好，以下例所示：

from django.db import models from geography.models import ZipCode class Restaurant(models.Model): # ... zip_code = models.ForeignKey( ZipCode, on_delete=models.SET_NULL, blank=True, null=True, )