ORM（object relational mapping）: 對象關系映射

映射關系：

　　　  表名  <－－－－－－－> 類名

       字段  <－－－－－－－> 屬性

　　　　表記錄 <－－－－－－－>類實例對象

建立模型(model)

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

作者模型：一個作者有姓名和年齡。

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

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

書籍模型： 書籍有書名和出版日期，一本書可能會有多個作者，一個作者也可以寫多本書，所以作者和書籍的關系就是多對多的關聯關系(many-to-many);一本書只應該由一個出版商出版，所以出版商和書籍是一對多關聯關系(one-to-many)。

 1 class Author(models.Model):
 2     nid = models.AutoField(primary_key=True)
 3     name=models.CharField( max_length=32)
 4     age=models.IntegerField()
 5  
 6     # 與AuthorDetail建立一對一的關系
 7     authorDetail=models.OneToOneField(to="AuthorDetail")
 8  
 9 class AuthorDetail(models.Model):
10  
11
 
     nid = models.AutoField(primary_key=True)
12     birthday=models.DateField()
13     telephone=models.BigIntegerField()
14     addr=models.CharField( max_length=64)
15     
16 class Publish(models.Model):
17     nid = models.AutoField(primary_key=True)
18     name=models.CharField( max_length=32)
 
19     city=models.CharField( max_length=32)
20     email=models.EmailField()
21  
22  
23 class Book(models.Model):
24  
25     nid = models.AutoField(primary_key=True)
26     title = models.CharField( max_length=32)
27     publishDate=models.DateField()
28     price=models.DecimalField(max_digits=5,decimal_places=2)
29     keepNum=models.IntegerField()<br>    commentNum=models.IntegerField()
30  
31     # 與Publish建立一對多的關系,外鍵字段建立在多的一方
32     publish=models.ForeignKey(to="Publish",to_field="nid")
33  
34     # 與Author表建立多對多的關系,ManyToManyField可以建在兩個模型中的任意一個，自動創建第三張表
35     authors=models.ManyToManyField(to=‘Author‘)　　

通過設置項目目錄中settings.py文件中LOGGING參數可查看每一次數據庫操作對應的sql語句

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

註意事項：

1、 表的名稱APPName_ModelName，是根據 模型中的元數據自動生成的，也可以覆寫為別的名稱　　

2、id 字段是自動添加的

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

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

5、外鍵字段 ForeignKey 有一個 null=True 的設置(它允許外鍵接受空值 NULL)，你可以賦給它空值 None，blank=True用於Admin操作時允許輸入框為空（如下）

字段選項

(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.普通字段

方式1
publish_obj=Publish(name="人民出版社",city="北京",email="[email protected]")
publish_obj.save() # 將數據保存到數據庫

方式2 <br>返回值publish_obj是添加的記錄對象
publish_obj=Publish.objects.create(name="人民出版社",city="北京",email="[email protected]")

2. 外鍵字段

方式1:
   publish_obj=Publish.objects.get(nid=1)
   Book.objects.create(title="金瓶眉",publishDate="2012-12-12",price=665,pageNum=334,publish=publish_obj)
 
方式2:
   Book.objects.create(title="金瓶眉",publishDate="2012-12-12",price=665,pageNum=334,publish_id=1)　　

3. 多對多字段

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(*[])
 
book_obj.authors.create()      #創建並保存一個新對象，然後將這個對象加被關聯對象的集合中，然後返回這個新對象。

查詢表記錄

查詢相關API

<1> all():                 查詢所有結果

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

註意區分object與querySet的區別

雙下劃線之單表查詢

models.Tb1.objects.filter(id__lt=10, id__gt=1)   # 獲取id大於1 且 小於10的值
 
models.Tb1.objects.filter(id__in=[11, 22, 33])   # 獲取id等於11、22、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和Book）

正向查詢(按字段：publish)：

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

反向查詢(按表名：book_set)：

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

2. 一對一查詢（如Author和AuthorDetail）

正向查詢(按字段：authorDetail)：

# 查詢egon作者的手機號
 
author_egon=Author.objects.get(name="egon")
print(author_egon.authorDetail.telephone)

反向查詢(按表名：author)：

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

3. 多對多查詢（如Author和Book）

正向查詢(按字段：authors)：

# 金瓶眉所有作者的名字以及手機號
 
book_obj=Book.objects.filter(title="金瓶眉").first()
 
authors=book_obj.authors.all()
 
for author_obj in authors:
 
     print(author_obj.name,author_obj.authorDetail.telephone)

反向查詢(按表名：book_set)：

# 查詢egon出過的所有書籍的名字
 
 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 的名稱。例如，如果 Book model 中做一下更改： publish = ForeignKey(Blog, related_name=‘bookList‘)，那麽接下來就會如我們看到這般：

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

基於雙下劃線的跨表查詢

# 練習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="yuan")
　　　　　　　　　　　　.values_list("title")

    # 反向查詢 按表名:book
queryResult=Author.objects.filter(name="yuan")
　　　　　　　　　　　　　　.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")

Django值ORM