06.orm模型層

ORM模型層

01.經常使用字段

<1> CharField
字符串字段, 用於較短的字符串.
CharField 要求必須有一個參數 maxlength, 用於從數據庫層和Django校驗層限制該字段所容許的最大字符數.

<2> IntegerField
#用於保存一個整數.

<3> FloatField
一個浮點數. 必須 提供兩個參數:

參數 描述：
　　max_digits 總位數(不包括小數點和符號)
　　decimal_places 小數位數
　　舉例來講, 要保存最大值爲 999 (小數點後保存2位),你要這樣定義字段:

　　models.FloatField(..., max_digits=5, decimal_places=2)
　　要保存最大值一百萬(小數點後保存10位)的話,你要這樣定義:

　　models.FloatField(..., max_digits=19, decimal_places=10)
　　admin 用一個文本框(<input type="text">)表示該字段保存的數據.

<4> AutoField
一個 IntegerField, 添加記錄時它會自動增加. 你一般不須要直接使用這個字段;
自定義一個主鍵：my_id=models.AutoField(primary_key=True)
若是你不指定主鍵的話,系統會自動添加一個主鍵字段到你的 model.

<5> BooleanField
A true/false field. admin 用 checkbox 來表示此類字段.

<6> TextField
一個容量很大的文本字段.
admin 用一個 <textarea> (文本區域)表示該字段數據.(一個多行編輯框).

<7> EmailField
一個帶有檢查Email合法性的 CharField,不接受 maxlength 參數.

<8> DateField
一個日期字段. 共有下列額外的可選參數:
Argument 描述
auto_now 當對象被保存時,自動將該字段的值設置爲當前時間.一般用於表示 "last-modified" 時間戳.
auto_now_add 當對象首次被建立時,自動將該字段的值設置爲當前時間.一般用於表示對象建立時間.
(僅僅在admin中有意義..)

<9> DateTimeField
一個日期時間字段. 相似 DateField 支持一樣的附加選項.

<10> ImageField
相似 FileField, 不過要校驗上傳對象是不是一個合法圖片.#它有兩個可選參數:height_field和width_field,
若是提供這兩個參數,則圖片將按提供的高度和寬度規格保存.
<11> FileField
一個文件上傳字段.
要求一個必須有的參數: upload_to, 一個用於保存上載文件的本地文件系統路徑. 這個路徑必須包含 strftime #formatting,
該格式將被上載文件的 date/time

　　注意：在一個 model 中使用 FileField 或 ImageField 須要如下步驟:
　　1）在你的 settings 文件中, 定義一個完整路徑給 MEDIA_ROOT 以便讓 Django在此處保存上傳文件.
　　(出於性能考慮,這些文件並不保存到數據庫.) 定義MEDIA_URL 做爲該目錄的公共 URL. 要確保該目錄對
　　WEB服務器用戶賬號是可寫的.
　　2）在你的 model 中添加 FileField 或 ImageField, 並確保定義了 upload_to 選項,以告訴 Django
　　使用 MEDIA_ROOT 的哪一個子目錄保存上傳文件.你的數據庫中要保存的只是文件的路徑(相對於 MEDIA_ROOT).
　　出於習慣你必定很想使用 Django 提供的 get_<#fieldname>_url 函數.舉例來講,若是你的 ImageField
　　叫做 mug_shot, 你就能夠在模板中以 {{ object.#get_mug_shot_url }} 這樣的方式獲得圖像的絕對路徑.

 

02.字段選項：經常使用的參數

(0)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 字段的名稱 )。例如：

 1 from django.db import models  2  3 class Person(models.Model):  4 SHIRT_SIZES = (  5 ('S', 'Small'),  6 ('M', 'Medium'),  7 ('L', 'Large'),  8 )  9 name = models.CharField(max_length=60) 10 shirt_size = models.CharField(max_length=1, choices=SHIRT_SIZES) 11 12 13 　　>>> p = Person(name="Fred Flintstone", shirt_size="L") 14 　　>>> p.save() 15 　　>>> p.shirt_size 16 　　'L' 17 　　>>> p.get_shirt_size_display() 18 　　'Large'

 

03.settings配置中
　　給項目根目錄下的__init__添加
　　import pymysql
　　pymysql.install_as_MySQLdb()

*若是報錯以下：
django.core.exceptions.ImproperlyConfigured: mysqlclient 1.3.3 or newer is required;

MySQLclient目前只支持到python3.4，所以若是使用的更高版本的python，須要修改以下：
經過查找路徑C:\Programs\Python\Python36-32\Lib\site-packages\Django-2.0-py3.6.egg\django\db\backends\mysql 這個路徑裏的文件把
if version < (1, 3, 3):
raise ImproperlyConfigured("mysqlclient 1.3.3 or newer is required; you have %s" % Database.__version__)
註釋掉 就OK了。

*若是想打印orm轉換過程當中的sql，須要在settings中進行以下配置：

 1 LOGGING = {  2 'version': 1,  3 'disable_existing_loggers': False,  4 'handlers': {  5 'console':{  6 'level':'DEBUG',  7 'class':'logging.StreamHandler',  8 },  9 }, 10 'loggers': { 11 'django.db.backends': { 12 'handlers': ['console'], 13 'propagate': True, 14 'level':'DEBUG', 15 }, 16 } 17 }

 

04.添加表紀錄
　　<1>一對一：
　　　　方式1
　　　　# create方法的返回值book_obj就是插入book表中的python葵花寶典這本書籍紀錄對象

book_obj=Book.objects.create(title="python葵花寶典",state=True,price=100,publish="蘋果出版社",pub_date="2012-12-12")

　　方式2

book_obj=Book(title="python葵花寶典",state=True,price=100,publish="蘋果出版社",pub_date="2012-12-12") book_obj.save()

<2>一對多：
　　方式1:找到關聯表的對象
　　

publish_obj=Publish.objects.get(nid=1) book_obj=Book.objects.create(title="金",publishDate="2012-12-12",price=100,publish=publish_obj)

 

　　方式2:找到關聯表的字段_id

book_obj=Book.objects.create(title="金",publishDate="2012-12-12",price=100,publish_id=1)

<3>多對多：用add進行多對多的關聯建立
　　

 1 # 當前生成的書籍對象  2 　　book_obj=Book.objects.create(title="追風箏的人",price=200,publishDate="2012-11-12",publish_id=1)  3 　　# 爲書籍綁定的作做者對象  4 　　yuan=Author.objects.filter(name="yuan").first() # 在Author表中主鍵爲2的紀錄  5 　　egon=Author.objects.filter(name="alex").first() # 在Author表中主鍵爲1的紀錄  6  7 　　# 綁定多對多關係,即向關係表book_authors中添加紀錄  8 　　book_obj.authors.add(yuan,egon) # 將某些特定的 model 對象添加到被關聯對象集合中。 ======= book_obj.authors.add(*[])  9 10 　　*多對多關係其餘經常使用API 11 　　-1book_obj.authors.remove() # 將某個特定的對象從被關聯對象集合中去除。 ====== book_obj.authors.remove(*[]) 12 　　對於ForeignKey對象，這個方法僅在null=True時存在。 13 14 　　-2book_obj.authors.clear() #清空被關聯對象集合 15 　　注意這樣不會刪除對象 —— 只會刪除他們之間的關聯。就像 remove() 方法同樣，clear()只能在 null=True的ForeignKey上被調用。 16 17 　　-3book_obj.authors.set() #先清空再設置

 

 

 

*延伸：

1 # 1 *[]的使用 2 3 book_obj = Book.objects.get(id=1) 4 author_list = Author.objects.filter(id__gt=2) 5 book_obj.authors.add(*author_list) 6 7 # 2 直接綁定主鍵 8 book_obj.authors.add(*[1,3]) # 將id=1和id=3的做者對象添加到這本書的做者集合中 9 # 應用: 添加或者編輯時,提交做者信息時能夠用到.

 

05.查詢表紀錄:查詢API

　　<1> all(): 查詢全部結果

<2> filter(**kwargs): 它包含了與所給篩選條件相匹配的對象

<3> get(**kwargs): 返回與所給篩選條件相匹配的對象，返回結果有且只有一個，
若是符合篩選條件的對象超過一個或者沒有都會拋出錯誤。

<4> exclude(**kwargs): 它包含了與所給篩選條件不匹配的對象

<5> order_by(*field): 對查詢結果排序

<6> reverse(): 對查詢結果反向排序

<8> count(): 返回數據庫中匹配查詢(QuerySet)的對象數量。

<9> first(): 返回第一條記錄

<10> last(): 返回最後一條記錄

<11> exists(): 若是QuerySet包含數據，就返回True，不然返回False

<12> values(*field): 返回一個ValueQuerySet——一個特殊的QuerySet，運行後獲得的並非一系列
model的實例化對象，而是一個可迭代的字典序列
<13> values_list(*field): 它與values()很是類似，它返回的是一個元組序列，values返回的是一個字典序列

<14> distinct(): 從返回結果中剔除重複紀錄

基於雙下劃線的模糊查詢

1 　　Book.objects.filter(price__in=[100,200,300]) #in內 2 　　Book.objects.filter(price__gt=100) #gt大於 3 　　Book.objects.filter(price__lt=100) #lt小於 4 　　Book.objects.filter(price__range=[100,200]) #range範圍 5 　　Book.objects.filter(title__contains="python") 6 　　Book.objects.filter(title__icontains="python") # 大小寫不明感 7 　　Book.objects.filter(title__startswith="py") #startswith開頭 8 　　Book.objects.filter(pub_date__year=2012) # _date__year拿到月份 9 　　startswith，istartswith, endswith, iendswith　# 加了i的都爲否認語句

 

06.刪除表記錄
　　方法就是 delete()。它運行時當即刪除對象而不返回任何值。例如：

Entry.objects.filter(pub_date__year=2005).delete()

07.修改表紀錄

Book.objects.filter(title__startswith="py").update(price=120)

此外，update()方法對於任何結果集（QuerySet）均有效，這意味着你能夠同時更新多條記錄update()
方法會返回一個整型數值，表示受影響的記錄條數。

08.查詢表記錄
　　<1>對象obj查詢
　　　　先查找一個obj對象，用get方法獲取，或者用first
　　　　用此obj對象進行（正向看字段，反向看錶名__set.all()）
　　　　其中在一對一的狀況，可直接拿到obj，再經過.屬性拿到相應值
　　　　一對多的狀況，正向可拿到obj，再經過.屬性拿到相應值/反向須要.all()拿到queryset進行遍歷或者values_list()拿到須要的值
　　　　多對多的狀況，正反向都須要.all()，再經過遍歷拿到obj

<2>雙下劃線__查詢
　　公式：須要的表.objects.filter(經過__拿到關鍵值).values_list('經過__拿到各類需求的值',''...)
<3>聚合查詢aggregate
　　from django.db.models import Min, Max, Count, Sum
　　深度查詢 .aggregate(本身賦值=Count/Max...'經過__拿到各類需求的值')
<4>分組查詢annotate
　　每一xxx可使用，至關於sql裏的group
　　多於聚合查詢混合使用
　　深度查詢 .annotate(本身賦值=Count('經過__拿到各類需求的值'))
<5>排序order_by
　　.order_by('num_authors')
<6>F與Q
　　F:對單個對象中多個值進行比較操做

from django.db.models import F # 查詢評論數大於收藏數2倍的書籍 Book.objects.filter(commnetNum__lt=F('keepNum')*2) # 將每一本書的價格提升30元： Book.objects.all().update(price=F("price")+30)

　　Q:filter() 等方法中的關鍵字參數查詢都是一塊兒進行「AND」 的，要進行& |等複雜操做須要用Q

from django.db.models import Q # or操做 bookList=Book.objects.filter(Q(authors__name="yuan")|Q(authors__name="egon"))