Django —— model基礎

ORM 

映射關係

　　表名     《-----------------------》      類名 

　　字段     《-----------------------》      類屬性 

　　表記錄    《-----------------------》    類實例對象 

 

建立表（建立model）

實例：咱們來假定下面這些概念，字段和關係

做者模型（表）：一個做者有姓名和年齡。

做者詳細模型（表）：把做者的詳情放到詳情表，包含生日，手機號，家庭住址等信息。做者詳情模型和做者模型之間是一對一的關係（one-to-one）

出版商模型（表）：出版商有名稱，所在城市以及email。

書籍模型（表）： 書籍有書名和出版日期，一本書可能會有多個做者，一個做者也能夠寫多本書，因此做者和書籍的關係就是多對多的關聯關係(many-to-many);一本書只應該由一個出版商出版，因此出版商和書籍是一對多關聯關係(one-to-many)。

建立表以下

class Author(models.Model):
    nid = models.AutoField(primary_key=True)
    name=models.CharField( max_length=32)
    age=models.IntegerField()
 
    # 與AuthorDetail創建一對一的關係
    authorDetail=models.OneToOneField(to="AuthorDetail")     #會在Author表中建立外鍵，關聯到AuthorDetail的主鍵上（nid）。注意：要先添加做者詳情條目，才能添加做者條目。建議在AuthorDetail添加OneToOne關係。
 
class AuthorDetail(models.Model): 
    nid = models.AutoField(primary_key=True)
    birthday=models.DateField()
    telephone=models.BigIntegerField()
    addr=models.CharField( max_length=64)
    
class Publish(models.Model):
    nid = models.AutoField(primary_key=True)
    name=models.CharField( max_length=32)
    city=models.CharField( max_length=32)
    email=models.EmailField()
 
 
class Book(models.Model):
 
    nid = models.AutoField(primary_key=True)
    title = models.CharField( max_length=32)
    publishDate=models.DateField()
    price=models.DecimalField(max_digits=5,decimal_places=2)
    keepNum=models.IntegerField() 
　　 commentNum=models.IntegerField()
 
    # 與Publish創建一對多的關係,外鍵字段創建在多的一方
    publish=models.ForeignKey(to="Publish",to_field="nid")
 
    # 與Author表創建多對多的關係,ManyToManyField能夠建在兩個模型中的任意一個，自動建立第三張表
    authors=models.ManyToManyField(to='Author')　　

 在settings.py 中設置logging來查看sql語句，輸出到console

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console':{
            'level':'DEBUG',
            'class':'logging.StreamHandler',
        },
    },
    'loggers': {
        'django.db.backends': {
            'handlers': ['console'],
            'propagate': True,
            'level':'DEBUG',
        },
    }
}

 

 

注意事項：

一、 表的名稱     APP名稱_類名，是根據 模型中的元數據自動生成的，也能夠覆寫爲別的名稱　　

二、id 字段是自動添加的

三、對於外鍵字段，Django 會在字段名上添加"_id" 來建立數據庫中的列名

四、這個例子中的CREATE TABLE SQL 語句使用PostgreSQL 語法格式，要注意的是Django 會根據settings 中指定的數據庫類型來使用相應的SQL 語句。

五、定義好模型以後，你須要告訴Django _使用_這些模型。你要作的就是修改配置文件settings.py中的INSTALL_APPS中設置，在其中添加models.py所在應用的名稱。

六、外鍵字段 ForeignKey 有一個 null=True 的設置(它容許外鍵接受空值 NULL)，你能夠賦給它空值 None 。

——字段選項 

(1)null

若是爲True，Django 將用NULL 來在數據庫中存儲空值。 默認值是 False.

(1)blank

若是爲True，該字段容許不填。默認爲False。
要注意，這與 null 不一樣。null純粹是數據庫範疇的，而 blank 是數據驗證範疇的。
若是一個字段的blank=True，表單的驗證將容許該字段是空值。若是字段的blank=False，該字段就是必填的。

(2)default

字段的默認值。能夠是一個值或者可調用對象。若是可調用 ，每有新對象被建立它都會被調用。

(3)primary_key

若是爲True，那麼這個字段就是模型的主鍵。若是你沒有指定任何一個字段的primary_key=True，
Django 就會自動添加一個IntegerField字段作爲主鍵，因此除非你想覆蓋默認的主鍵行爲，
不然不必設置任何一個字段的primary_key=True。

(4)unique

若是該值設置爲 True, 這個數據字段的值在整張表中必須是惟一的

(5)choices
由二元組組成的一個可迭代對象（例如，列表或元組），用來給字段提供選擇項。 若是設置了choices ，默認的表單將是一個選擇框而不是標準的文本框，並且這個選擇框的選項就是choices 中的選項。

這是一個關於 choices 列表的例子：

YEAR_IN_SCHOOL_CHOICES = (
    ('FR', 'Freshman'),
    ('SO', 'Sophomore'),
    ('JR', 'Junior'),
    ('SR', 'Senior'),
    ('GR', 'Graduate'),
)
每一個元組中的第一個元素，是存儲在數據庫中的值；第二個元素是在管理界面或 ModelChoiceField 中用做顯示的內容。 在一個給定的 model 類的實例中，想獲得某個 choices 字段的顯示值，就調用 get_FOO_display 方法(這裏的 FOO 就是 choices 字段的名稱 )。例如：

from django.db import models

class Person(models.Model):
    SHIRT_SIZES = (
        ('S', 'Small'),
        ('M', 'Medium'),
        ('L', 'Large'),
    )
    name = models.CharField(max_length=60)
    shirt_size = models.CharField(max_length=1, choices=SHIRT_SIZES)


>>> p = Person(name="Fred Flintstone", shirt_size="L")
>>> p.save()
>>> p.shirt_size
'L'
>>> p.get_shirt_size_display()
'Large'

 

添加表記錄 

—— 普通字段

方法1

publish_obj=Publish(name="人民出版社",city="北京",email="renMin@163.com")
publish_obj.save()

底層sql
INSERT INTO "app01_publish" ("name", "city", "email") VALUES ('人民出版社', '北京', 'renmin@163.com');

 

 方法2

publish_obj=Publish.objects.create(name="人民出版社",city="北京",email="renMin@163.com")

sql
INSERT INTO "app01_publish" ("name", "city", "email") VALUES ('人民出版社', '北京', 'renmin@163.com')

 

 方法3

表.objects.create(**request.POST.dict())  #tempalte中的name  和 數據庫中的字段名稱必須相同。

 

 

—— 外鍵字段（多對一）

方式1:
   publish_obj=Publish.objects.get(nid=1)
   Book.objects.create(title="python",publishDate="2012-12-12",price=665,keepNum=334,commentNum=100,publish=publish_obj)    #更新對象

sql
SELECT "app01_publish"."nid", "app01_publish"."name", "app01_publish"."city", "app01_publish"."email" FROM "app01_publish" WHERE "app01_publish"."nid" = 1
INSERT INTO "app01_book" ("title", "publishDate", "price", "keepNum", "commentNum", "publish_id") VALUES ('python', '2012-12-12', '665.00', 334, 100, 1)

 方式2:
   Book.objects.create(title="python",publishDate="2012-12-12",price=665,pageNum=334,publish_id=1)　　 #更新對象id

sql
INSERT INTO "app01_book" ("title", "publishDate", "price", "keepNum", "commentNum", "publish_id") VALUES ('python', '2012-12-12', '665.00', 334, 100, 1)

 

關鍵點：book_obj.publish是 關聯的publish的記錄的對象

——多對多字段

 

book_obj=Book.objects.create(title="追風箏的人",publishDate="2012-11-12",price=69,pageNum=314,publish_id=1)
 
author_yuan=Author.objects.create(name="yuan",age=23,authorDetail_id=1)
author_egon=Author.objects.create(name="egon",age=32,authorDetail_id=2)
 
book_obj.authors.add(author_egon,author_yuan)    #  將某個特定的 model 對象添加到被關聯對象集合中。   =======    book_obj.authors.add(*[])

 

sql
INSERT INTO "app01_book" ("title", "publishDate", "price", "keepNum", "commentNum", "publish_id") VALUES ('python', '2012-12-12', '665.00', 334, 100, 1);
INSERT INTO "app01_author" ("name", "age", "authorDetail_id") VALUES ('yuan', 23, 1);
INSERT INTO "app01_author" ("name", "age", "authorDetail_id") VALUES ('egon', 32, 2);
SELECT "app01_book_authors"."author_id" FROM "app01_book_authors" WHERE ("app01_book_authors"."book_id" = 19 AND "app01_book_authors"."author_id" IN (26, 27));
INSERT INTO "app01_book_authors" ("book_id", "author_id") SELECT 19, 26 UNION ALL SELECT 19, 27;

 ==========================================================

book_obj.authors.create()      #建立並保存一個新對象，而後將這個對象加被關聯對象的集合中，而後返回這個新對象。

例子：

book表

book_obj = models.Book.objects.filter(nid=23)[0]
book_obj.authors.create(name='lisi',age=40,authorDetail_id=3)   給這本書建立用戶，並在關聯表中建立關聯關係。

SQL

(0.045) SELECT "app01_book"."nid", "app01_book"."title", "app01_book"."publishDate", "app01_book"."price", "app01_book"."keepNum", "app01_book"."commentNum", "app01_book"."publish_id" FROM "app01_book" WHERE "app01_book"."nid" = 23 LIMIT 1; args=(23,)
(0.002) INSERT INTO "app01_author" ("name", "age", "authorDetail_id") VALUES ('lisi', 40, 3); args=['lisi', 40, 3]
(0.001) SELECT "app01_book_authors"."author_id" FROM "app01_book_authors" WHERE ("app01_book_authors"."book_id" = 23 AND "app01_book_authors"."author_id" IN (36)); args=(23, 36)
(0.002) INSERT INTO "app01_book_authors" ("book_id", "author_id") SELECT 23, 36; args=(23, 36)

 

 關鍵點：book_obj.authors是什麼？

 解除關係：

 

book_obj.authors.remove()     # 將某個特定的對象從被關聯對象集合中去除。    ======   book_obj.authors.remove(*[])

book_obj = models.Book.objects.filter(title='python')[0]
author_egon = models.Author.objects.filter(name='egon')[0]
book_obj.authors.remove(author_egon)

book_obj.authors.clear()       #清空被關聯對象集合。

book_obj = models.Book.objects.filter(title='python')[0]
author_egon = models.Author.objects.filter(name='egon')[0]
book_obj.authors.clear()

 

查詢表記錄

——查詢相關API

<1> all():                 查詢全部結果 
 
<2> filter(**kwargs):      它包含了與所給篩選條件相匹配的對象
 
<3> get(**kwargs):         返回與所給篩選條件相匹配的對象，返回結果有且只有一個，
                           若是符合篩選條件的對象超過一個或者沒有都會拋出錯誤。
 
<5> exclude(**kwargs):     它包含了與所給篩選條件不匹配的對象
 
<4> values(*field):        返回一個ValueQuerySet——一個特殊的QuerySet，運行後獲得的並非一系列
                           model的實例化對象，而是一個可迭代的字典序列
 
<9> values_list(*field):   它與values()很是類似，它返回的是一個元組序列，values返回的是一個字典序列
 
<6> order_by(*field):      對查詢結果排序
 
<7> reverse():             對查詢結果反向排序
 
<8> distinct():            從返回結果中剔除重複紀錄
 
<10> count():              返回數據庫中匹配查詢(QuerySet)的對象數量。
 
<11> first():              返回第一條記錄
 
<12> last():               返回最後一條記錄
 
<13> exists():             若是QuerySet包含數據，就返回True，不然返回False

 注意：必定區分object與querySet的區別 ！！！

——基於對象的跨表查詢

————一對多查詢（Publish  和  Book）

正向查詢（按字段：publisher）

# 查詢nid=1的書籍的出版社所在的城市<br>
book_obj=Book.objects.get(nid=1)
print(book_obj.publish.city) # book_obj.publish 是nid=1的書籍對象關聯的出版社對象　　

 

 反向查詢（按代表:boot_set）

# 查詢 人民出版社出版過的全部書籍
 
    publish=Publish.objects.get(name="人民出版社")
 
    book_list=publish.book_set.all()  # 與人民出版社關聯的全部書籍對象集合
 
    for book_obj in book_list:
        print(book_obj.title)

 

————一對一查詢（Author 和  AuthorDetail）

正向查詢（按字段：authorDetail）

# 查詢egon做者的手機號
 
    author_egon=Author.objects.get(name="egon")   #return  一條數據obj ，對象能夠直接  .屬性
    print(author_egon.authorDetail.telephone)

 

反向查詢（按代表：author 沒有_set）

# 查詢全部住址在北京的做者的姓名
 
    authorDetail_list=AuthorDetail.objects.filter(addr="beijing")
 　  author = authorDetail_list.author.all()
    for obj in author:
        print(obj.name)

 

————多對多查詢（Author 和  Book）

正向查詢（按字段：authors）

    book_obj=Book.objects.filter(title="python").first()
 
    authors=book_obj.authors.all()
 
    for author_obj in authors:
 
        print(author_obj.name,author_obj.authorDetail.telephone)

 

反向查詢（按表名：boot_set）

    author_obj=Author.objects.get(name="egon")
    book_list=author_obj.book_set.all() #與egon做者相關的全部書籍
 
    for book_obj in book_list:
        print(book_obj.title)

 

注意：

你能夠經過在 ForeignKey() 和ManyToManyField的定義中設置 related_name 的值來覆寫 FOO_set 的名稱。例如，若是 Article model 中作一下更改： publish = ForeignKey(Blog, related_name='bookList')，那麼接下來就會如咱們看到這般：

# 查詢 人民出版社出版過的全部書籍
 
   publish=Publish.objects.get(name="人民出版社")
 
   book_list=publish.bookList.all()  # 與人民出版社關聯的全部書籍對象集合

 

——雙下劃線 之 單表查詢

models.Tb1.objects.filter(id__lt=10, id__gt=1)   # 獲取id大於1 且 小於10的值
 
models.Tb1.objects.filter(id__in=[11, 22, 33])   # 獲取id等於十一、2二、33的數據
models.Tb1.objects.exclude(id__in=[11, 22, 33])  # not in
 models.Tb1.objects.filter(name__contains="ven") models.Tb1.objects.filter(name__icontains="ven") # icontains大小寫不敏感  models.Tb1.objects.filter(id__range=[1, 2]) # 範圍bettwen and  startswith
istartswith
endswith
iendswith　

——基於雙下劃線的跨表查詢

# 練習1:  查詢人民出版社出版過的全部書籍的名字與價格(一對多)  

    # 正向查詢   按字段:publish

    queryResult=Book.objects.filter(publish__name="人民出版社").values_list("title","price")


    # 反向查詢  按表名:book

    queryResult=Publish.objects.filter(name="人民出版社").values_list("book__title","book__price")



# 練習2: 查詢egon出過的全部書籍的名字(多對多)

    # 正向查詢 按字段:authors:
    queryResult=Book.objects.filter(authors__name="egon").values_list("title")

    # 反向查詢 按表名:book
    queryResult=Author.objects.filter(name="egon").values_list("book__title","book__price")


# 練習3: 查詢人民出版社出版過的全部書籍的名字以及做者的姓名


    # 正向查詢
    queryResult=Book.objects.filter(publish__name="人民出版社").values_list("title","authors__name")


    # 反向查詢
    queryResult=Publish.objects.filter(name="人民出版社").values_list("book__title","book__authors__age","book__authors__name")



# 練習4: 手機號以151開頭的做者出版過的全部書籍名稱以及出版社名稱

    queryResult=Book.objects.filter(authors__authorDetail__telephone__regex="151").values_list("title","publish__name")

 

 注意：

反向查詢時，若是定義了related_name ，則用related_name替換表名，例如： publish = ForeignKey(Blog, related_name='bookList')：

# 練習1:  查詢人民出版社出版過的全部書籍的名字與價格(一對多)
 
    # 反向查詢 再也不按表名:book,而是related_name:bookList
 
    queryResult=Publish.objects.filter(name="人民出版社").values_list("bookList__title","bookList__price")

 

——聚合查詢和分組查詢

————聚合：aggregate()

# 計算全部圖書的平均價格
    >>> from django.db.models import Avg
    >>> Book.objects.all().aggregate(Avg('price'))
    {'price__avg': 34.35}

 

aggregate()是QuerySet 的一個終止子句，意思是說，它返回一個包含一些鍵值對的字典。鍵的名稱是聚合值的標識符，值是計算出來的聚合值。鍵的名稱是按照字段和聚合函數的名稱自動生成出來的。若是你想要爲聚合值指定一個名稱，能夠向聚合子句提供它。

 >>> from django.db.models import Avg

>>> Book.objects.aggregate(average_price=Avg('price'))
{'average_price': 34.35}

 

若是你但願生成不止一個聚合，你能夠向aggregate()子句中添加另外一個參數。因此，若是你也想知道全部圖書價格的最大值和最小值，能夠這樣查詢：

 

>>> from django.db.models import Avg, Max, Min
>>> Book.objects.aggregate(Avg('price'), Max('price'), Min('price'))
{'price__avg': 34.35, 'price__max': Decimal('81.20'), 'price__min': Decimal('12.99')}

 

————分組：annotate()

爲QuerySet中每個對象都生成一個獨立的彙總值。

(1) 練習：統計每一本書的做者個數

bookList=Book.objects.annotate(authorsNum=Count('authors'))
for book_obj in bookList:
    print(book_obj.title,book_obj.authorsNum)

 

sql

SELECT 
"app01_book"."nid", 
"app01_book"."title", 
"app01_book"."publishDate", 
"app01_book"."price", 
"app01_book"."pageNum", 
"app01_book"."publish_id", 
COUNT("app01_book_authors"."author_id") AS "authorsNum" 
FROM "app01_book" LEFT OUTER JOIN "app01_book_authors" 
ON ("app01_book"."nid" = "app01_book_authors"."book_id") 
GROUP BY 
"app01_book"."nid", 
"app01_book"."title", 
"app01_book"."publishDate", 
"app01_book"."price", 
"app01_book"."pageNum", 
"app01_book"."publish_id"

sql

View Code

 

(2) 若是想對所查詢對象的關聯對象進行聚合：

練習：統計每個出版社的最便宜的書

方法1：

publishList=Publish.objects.annotate(MinPrice=Min("book__price"))
 
for publish_obj in publishList:
    print(publish_obj.name,publish_obj.MinPrice)

 

annotate的返回值是querySet，若是不想遍歷對象，能夠用上valuelist：

queryResult= Publish.objects.annotate(MinPrice=Min("book__price")).values_list("name","MinPrice")
print(queryResult)

 

方法2：

Book.objects.values("publish__name").annotate(MinPrice=Min('price'))

 

注意：values內的字段即group by的字段

(3) 統計每一本以py開頭的書籍的做者個數：

 queryResult=Book.objects.filter(title__startswith="Py").annotate(num_authors=Count('authors'))

 

(4) 統計不止一個做者的圖書：

queryResult=Book.objects.annotate(num_authors=Count('authors')).filter(num_authors__gt=1)

 (5) 根據一本圖書做者數量的多少對查詢集 QuerySet進行排序:

    
Book.objects.annotate(num_authors=Count('authors')).order_by('num_authors')

 

(6) 查詢各個做者出的書的總價格:

# 按author表的全部字段 group by
    queryResult=Author.objects.annotate(SumPrice=Sum("book__price")).values_list("name","SumPrice")
    print(queryResult)

#按authors__name group by
queryResult2=Book.objects.values("authors__name").annotate(SumPrice=Sum("price")).values_list("authors__name","SumPrice")
print(queryResult2)

 

——F查詢和Q查詢

F查詢

F查詢是幹什麼的？

現有一個book表：

 

如今要查詢 評論數  大於 收藏數的書籍

 from django.db.models import F
   Book.objects.filter(commnetNum__gt=F('keepNum'))

Django 支持 F() 對象之間以及 F() 對象和常數之間的加減乘除和取模的操做。

# 查詢評論數 大於 收藏數2倍的書籍
    Book.objects.filter(commnetNum__gt=F('keepNum')*2)

修改操做也可使用F函數,好比將每一本書的價格提升30元：

Book.objects.all().update(price=F("price")+30)　

 

 Q查詢

 filter()查詢支持AND查詢。如：

models.Book.objects.filter(price__gt=100,title='linux')

 若是須要執行或，非等操做。須要使用Q查詢。

from django.db.models import Q
Q(title__startswith='Py')

Q 對象可使用& 和| 操做符組合起來。當一個操做符在兩個Q 對象上使用時，它產生一個新的Q 對象。

bookList=Book.objects.filter(Q(authors__name="yuan")|Q(authors__name="egon"))   等同於    where  name="yuan"   or   name = "egon"

 

  你能夠組合& 和|  操做符以及使用括號進行分組來編寫任意複雜的Q 對象。同時，Q 對象可使用~ 操做符取反，這容許組合正常的查詢和取反(NOT) 查詢：

bookList=Book.objects.filter(Q(authors__name="yuan") & ~Q(publishDate__year=2017)).values_list("title")

 

查詢函數能夠混合使    用Q對象  和      關鍵字參數。   Q 對象 必須位於全部   關鍵字參數    的前面。例如：

bookList=Book.objects.filter(Q(publishDate__year=2016) | Q(publishDate__year=2017),title__icontains="python")

 

修改記錄

方法1

    author = models.Author.objects.filter(nid=34)[0]
    author.name = 'zhangshan'
    author.save()

 

SQL

SELECT "app01_author"."nid", "app01_author"."name", "app01_author"."age", "app01_author"."authorDetail_id" FROM "app01_author" WHERE "app01_author"."nid" = 34 LIMIT 1;UPDATE "app01_author" SET "name" = 'zhangshan', "age" = 23, "authorDetail_id" = 1 WHERE "app01_author"."nid" = 34   #更新這行數據的全部類，比較消耗數據庫資源

 

方法2

   ret = models.Author.objects.filter(nid=34).update(name='lisi')    只能使用filter(),不能使用get()，由於update是QuerySet的方法。get返回的是一個model的對象。他沒有update方法。
   print(ret)    返回一個整型的數值，表示受影響的記錄的條數。

sql
UPDATE "app01_author" SET "name" = 'lisi' WHERE "app01_author"."nid" = 34   只更新一列。

 

刪除記錄

 ret = models.Author.objects.filter(nid=34).delete()
 print(ret)

返回值
(1, {'app01.Book_authors': 0, 'app01.Author': 1})


(0.000) SELECT "app01_author"."nid", "app01_author"."name", "app01_author"."age", "app01_author"."authorDetail_id" FROM "app01_author" WHERE "app01_author"."nid" = 34; args=(34,)
(0.034) DELETE FROM "app01_book_authors" WHERE "app01_book_authors"."author_id" IN (34); args=(34,)    刪除關聯表中的相關的數據
(0.002) DELETE FROM "app01_author" WHERE "app01_author"."nid" IN (34); args=(34,)                      刪除Author表中的數據（由於外鍵，若是不先刪除關聯表中的數據，此數據沒法刪除-級聯刪除）

 

 

 

要注意的是： delete() 方法是 QuerySet 上的方法，但並不適用於 Manager 自己。這是一種保護機制，是爲了不意外地調用 Entry.objects.delete() 方法致使 全部的 記錄被誤刪除。若是你確認要刪除全部的對象，那麼你必須顯式地調用：

Entry.objects.delete()
不會刪除



Entry.objects.all().delete()

 

 類 關聯管理器

"關聯管理器"是在一對多或者多對多的關聯上下文中使用的管理器。它存在於下面兩種狀況：

ForeignKey關係的「另外一邊」。像這樣：

from django.db import models
 
class Reporter(models.Model):
    # ...
    pass
 
class Article(models.Model):
    reporter = models.ForeignKey(Reporter)

在上面的例子中，管理器reporter.article_set擁有下面的方法。

ManyToManyField關係的兩邊：

class  Topping(models.Model):

     # ...

     pass

 

class  Pizza(models.Model):

     toppings  =  models.ManyToManyField(Topping)

這個例子中，topping.pizza_set 和pizza.toppings都擁有下面的方法。

add(obj1[, obj2, ...])

把指定的模型對象添加到關聯對象集中。

例如：

>>> b  =  Blog.objects.get( id = 1 )

>>> e  =  Entry.objects.get( id = 234 )

>>> b.entry_set.add(e)  # Associates Entry e with Blog b.

在上面的例子中，對於ForeignKey關係，e.save()由關聯管理器調用，執行更新操做。然而，在多對多關係中使用add()並不會調用任何 save()方法，而是由QuerySet.bulk_create()建立關係。

create(**kwargs)

建立一個新的對象，保存對象，並將它添加到關聯對象集之中。返回新建立的對象：

>>> b  =  Blog.objects.get( id = 1 )

>>> e  =  b.entry_set.create(

...     headline = 'Hello' ,

...     body_text = 'Hi' ,

...     pub_date = datetime.date( 2005 ,  1 ,  1 )

... )

 

# No need to call e.save() at this point -- it's already been saved.

這徹底等價於（不過更加簡潔於）：

>>> b  =  Blog.objects.get( id = 1 )

>>> e  =  Entry(

...     blog = b,

...     headline = 'Hello' ,

...     body_text = 'Hi' ,

...     pub_date = datetime.date( 2005 ,  1 ,  1 )

... )

>>> e.save(force_insert = True )

要注意咱們並不須要指定模型中用於定義關係的關鍵詞參數。在上面的例子中，咱們並無傳入blog參數給create()。Django會明白新的 Entry對象blog 應該添加到b中。

remove(obj1[, obj2, ...])

從關聯對象集中移除執行的模型對象：

>>> b  =  Blog.objects.get( id = 1 )

>>> e  =  Entry.objects.get( id = 234 )

>>> b.entry_set.remove(e)  # Disassociates Entry e from Blog b.

對於ForeignKey對象，這個方法僅在null=True時存在。

clear()

從關聯對象集中移除一切對象。

>>> b  =  Blog.objects.get( id = 1 )

>>> b.entry_set.clear()

注意這樣不會刪除對象 —— 只會刪除他們之間的關聯。

就像 remove() 方法同樣，clear()只能在 null=True的ForeignKey上被調用。

注意

對於全部類型的關聯字段，add()、create()、remove()和clear()都會立刻更新數據庫。換句話說，在關聯的任何一端，都不須要再調用save()方法。

直接賦值：

經過賦值一個新的可迭代的對象，關聯對象集能夠被總體替換掉。

>>> new_list  =  [obj1, obj2, obj3]

>>> e.related_set  =  new_list

若是外鍵關係知足null=True，關聯管理器會在添加new_list中的內容以前，首先調用clear()方法來解除關聯集中一切已存在對象的關聯。不然， new_list中的對象會在已存在的關聯的基礎上被添加。