Django 經過 models 實現數據庫的建立、修改、刪除等操做git
模型中通常經常使用的類型的清單
AutoField
一個自動遞增的整型字段,添加記錄時它會自動增加。你一般不須要直接使用這個字段;若是你不指定主鍵的話,系統會自動添加一個主鍵字段到你的model。
正則表達式
BooleanField:
布爾字段,管理工具裏會自動將其描述爲checkbox。數據庫
CharField:
字符串字段,單行輸入,用於較短的字符串,如要保存大量文本, 使用 TextField,CharField有一個必填參數:django
CharField.max_length:字符的最大長度,django會根據這個參數在數據庫層和校驗層限制該字段所容許的最大字符數。服務器
TextField:
一個容量很大的文本字段, admin 管理界面用 <textarea>多行編輯框表示該字段數據。ide
CommaSeparatedIntegerField:
用於存放逗號分隔的整數值。相似 CharField,必須maxlength 參數。函數
DateField:
日期字段,admin 用一個文本框 <input type=」text」> 來表示該字段數據(附帶一個 JavaScript 日曆和一個」Today」快捷按鍵。有下列額外的可選參數:工具
auto_now:當對象被保存時,自動將該字段的值設置爲當前時間.一般用於表示 「last-modified」 時間戳;
auto_now_add:當對象首次被建立時,自動將該字段的值設置爲當前時間.一般用於表示對象建立時間。性能
DateTimeField:
EmailField:
一個帶有檢查 Email 合法性的 CharField,不接受 maxlength 參數。
FileField:
一個文件上傳字段。 要求一個必須有的參數: upload_to, 一個用於保存上載文件的本地文件系統路徑。 這個路徑必須包含 strftime formatting, 該格式將被上載文件的 date/time 替換(so that uploaded files don’t fill up the given directory)。在一個 model 中使用 FileField 或 ImageField 須要如下步驟:在你的 settings 文件中, 定義一個完整路徑給 MEDIA_ROOT 以便讓 Django在此處保存上傳文件。 (出於性能考慮,這些文件並不保存到數據庫。) 定義 MEDIA_URL 做爲該目錄的公共 URL。 要確保該目錄對 WEB 服務器用戶賬號是可寫的。在你的 model 中添加 FileField 或 ImageField, 並確保定義了 upload_to 選項,以告訴 Django 使用 MEDIA_ROOT 的哪一個子目錄保存上傳文件。你的數據庫中要保存的只是文件的路徑(相對於 MEDIA_ROOT)。 出於習慣你必定很想使用 Django 提供的 get_<fieldname>_url 函數。舉例來講,若是你的 ImageField 叫做 mug_shot, 你就能夠在模板中以 {{ object。get_mug_shot_url }} 這樣的方式獲得圖像的絕對路徑。
FilePathField:
選擇指定目錄按限制規則選擇文件,有三個參數可選, 其中」path」必需的,這三個參數能夠同時使用, 參數描述:
path:必需參數,一個目錄的絕對文件系統路徑。 FilePathField 據此獲得可選項目。 Example: 「/home/images」;
match:可選參數, 一個正則表達式, 做爲一個字符串, FilePathField 將使用它過濾文件名。 注意這個正則表達式只會應用到 base filename 而不是路徑全名。
Example: 「foo。*\。txt^」, 將匹配文件 foo23.txt 卻不匹配 bar.txt 或 foo23.gif;
recursive:可選參數, 是否包括 path 下所有子目錄,True 或 False,默認值爲 False。
match 僅應用於 base filename, 而不是路徑全名。 如:FilePathField(path=」/home/images」, match=」foo.*」, recursive=True)…會匹配 /home/images/foo.gif 而不匹配 /home/images/foo/bar.gif
FloatField:浮點型字段。 必須提供兩個 參數, 參數描述:
max_digits:總位數(不包括小數點和符號)
decimal_places:小數位數。如:要保存最大值爲 999 (小數點後保存2位),你要這樣定義字段:models.FloatField(…,max_digits=5, decimal_places=2),要保存最大值一百萬(小數點後保存10位)的話,你要這樣定義:models.FloatField(…,max_digits=19, decimal_places=10)
ImageField:
相似 FileField, 不過要校驗上傳對象是不是一個合法圖片。它有兩個可選參數:height_field 和 width_field,若是提供這兩個參數,則圖片將按提供的高度和寬度規格保存。 該字段要求 Python Imaging 庫。
IntegerField:
用於保存一個整數。
IPAddressField:
一個字符串形式的 IP 地址, (如 「202.1241.30″)。
NullBooleanField:
相似 BooleanField, 不過容許 NULL 做爲其中一個選項。 推薦使用這個字段而不要用 BooleanField 加 null=True 選項。 admin 用一個選擇框 <select> (三個可選擇的值: 「Unknown」, 「Yes」 和 「No」 ) 來表示這種字段數據。
PhoneNumberField:
一個帶有合法美國風格電話號碼校驗的 CharField(格式:XXX-XXX-XXXX)。(中國可能很差用)
PositiveIntegerField:
相似 IntegerField, 但取值範圍爲非負整數(這個字段應該是容許0值的…能夠理解爲無符號整數)
PositiveSmallIntegerField:
正小整型字段,相似 PositiveIntegerField, 取值範圍較小(數據庫相關)SlugField「Slug」 是一個報紙術語。 slug 是某個東西的小小標記(短籤), 只包含字母,數字,下劃線和連字符。它們一般用於URLs。 若你使用 Django 開發版本,你能夠指定 maxlength。 若 maxlength 未指定, Django 會使用默認長度: 50,它接受一個額外的參數:prepopulate_from: 來源於slug的自動預置列表
SlugField:
是一個報紙術語. slug 是某個東西的小小標記(短籤), 只包含字母,數字,下劃線和連字符.它們一般用於URLs。
SmallIntegerField:
相似 IntegerField, 不過只容許某個取值範圍內的整數。(依賴數據庫)
TimeField:
時間字段,相似於 DateField 和 DateTimeField。
URLField:
用於保存 URL。 若 verify_exists 參數爲 True (默認), 給定的 URL 會預先檢查是否存在(即URL是否被有效裝入且沒有返回404響應)。
USStateField:
美國州名縮寫,由兩個字母組成(天朝人民無視)。
XMLField:
XML字符字段,校驗值是否爲合法XML的 TextField,必須提供參數:schema_path:校驗文本的 RelaxNG schema 的文件系統路徑。
附:Field 選項
- null :缺省設置爲false.一般不將其用於字符型字段上,好比CharField,TextField上.字符型字段若是沒有值會返回空字符串。
- blank:該字段是否能夠爲空。若是爲假,則必須有值
- choices:一個用來選擇值的2維元組。第一個值是實際存儲的值,第二個用來方便進行選擇。如SEX_CHOICES= ((‘F’,'Female’),(‘M’,'Male’),)
- core:db_column,db_index 若是爲真將爲此字段建立索引
- default:設定缺省值
- editable:若是爲假,admin模式下將不能改寫。缺省爲真
- help_text:admin模式下幫助文檔
- primary_key:設置主鍵,若是沒有設置django建立表時會自動加上:
1 |
id = meta.AutoField( 'ID' , primary_key = True ) |
2 |
primary_key = True implies blank = False , null = False and unique = True . Only one primary key is allowed on an object . |
- radio_admin:用於admin模式下將select轉換爲radio顯示。只用於ForeignKey或者設置了choices
- unique:數據惟一
- unique_for_date:日期惟一,以下例中系統將不容許title和pub_date兩個都相同的數據重複出現
- title = meta.CharField(maxlength=30,unique_for_date=’pub_date’)
- unique_for_month / unique_for_year:用法同上
- validator_list:有效性檢查。非有效產生 django.core.validators.ValidationError 錯誤
快速查詢列表
AutoField(Field) - int自增列,必須填入參數 primary_key=True BigAutoField(AutoField) - bigint自增列,必須填入參數 primary_key=True 注:當model中若是沒有自增列,則自動會建立一個列名爲id的列 from django.db import models class UserInfo(models.Model): # 自動建立一個列名爲id的且爲自增的整數列 username = models.CharField(max_length=32) class Group(models.Model): # 自定義自增列 nid = models.AutoField(primary_key=True) name = models.CharField(max_length=32) SmallIntegerField(IntegerField): - 小整數 -32768 ~ 32767 PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) - 正小整數 0 ~ 32767 IntegerField(Field) - 整數列(有符號的) -2147483648 ~ 2147483647 PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) - 正整數 0 ~ 2147483647 BigIntegerField(IntegerField): - 長整型(有符號的) -9223372036854775808 ~ 9223372036854775807 BooleanField(Field) - 布爾值類型 NullBooleanField(Field): - 能夠爲空的布爾值 CharField(Field) - 字符類型 - 必須提供max_length參數, max_length表示字符長度 TextField(Field) - 文本類型 EmailField(CharField): - 字符串類型,Django Admin以及ModelForm中提供驗證機制 IPAddressField(Field) - 字符串類型,Django Admin以及ModelForm中提供驗證 IPV4 機制 GenericIPAddressField(Field) - 字符串類型,Django Admin以及ModelForm中提供驗證 Ipv4和Ipv6 - 參數: protocol,用於指定Ipv4或Ipv6, 'both',"ipv4","ipv6" unpack_ipv4, 若是指定爲True,則輸入::ffff:192.0.2.1時候,可解析爲192.0.2.1,開啓刺功能,須要protocol="both" URLField(CharField) - 字符串類型,Django Admin以及ModelForm中提供驗證 URL SlugField(CharField) - 字符串類型,Django Admin以及ModelForm中提供驗證支持 字母、數字、下劃線、鏈接符(減號) CommaSeparatedIntegerField(CharField) - 字符串類型,格式必須爲逗號分割的數字 UUIDField(Field) - 字符串類型,Django Admin以及ModelForm中提供對UUID格式的驗證 FilePathField(Field) - 字符串,Django Admin以及ModelForm中提供讀取文件夾下文件的功能 - 參數: path, 文件夾路徑 match=None, 正則匹配 recursive=False, 遞歸下面的文件夾 allow_files=True, 容許文件 allow_folders=False, 容許文件夾 FileField(Field) - 字符串,路徑保存在數據庫,文件上傳到指定目錄 - 參數: upload_to = "" 上傳文件的保存路徑 storage = None 存儲組件,默認django.core.files.storage.FileSystemStorage ImageField(FileField) - 字符串,路徑保存在數據庫,文件上傳到指定目錄 - 參數: upload_to = "" 上傳文件的保存路徑 storage = None 存儲組件,默認django.core.files.storage.FileSystemStorage width_field=None, 上傳圖片的高度保存的數據庫字段名(字符串) height_field=None 上傳圖片的寬度保存的數據庫字段名(字符串) DateTimeField(DateField) - 日期+時間格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ] DateField(DateTimeCheckMixin, Field) - 日期格式 YYYY-MM-DD TimeField(DateTimeCheckMixin, Field) - 時間格式 HH:MM[:ss[.uuuuuu]] DurationField(Field) - 長整數,時間間隔,數據庫中按照bigint存儲,ORM中獲取的值爲datetime.timedelta類型 FloatField(Field) - 浮點型 DecimalField(Field) - 10進制小數 - 參數: max_digits,小數總長度 decimal_places,小數位長度 BinaryField(Field) - 二進制類型
null 數據庫中字段是否能夠爲空 db_column 數據庫中字段的列名 default 數據庫中字段的默認值 primary_key 數據庫中字段是否爲主鍵 db_index 數據庫中字段是否能夠創建索引 unique 數據庫中字段是否能夠創建惟一索引 unique_for_date 數據庫中字段【日期】部分是否能夠創建惟一索引 unique_for_month 數據庫中字段【月】部分是否能夠創建惟一索引 unique_for_year 數據庫中字段【年】部分是否能夠創建惟一索引 verbose_name Admin中顯示的字段名稱 blank Admin中是否容許用戶輸入爲空 editable Admin中是否能夠編輯 help_text Admin中該字段的提示信息 choices Admin中顯示選擇框的內容,用不變更的數據放在內存中從而避免跨表操做 如:gf = models.IntegerField(choices=[(0, '何穗'),(1, '大表姐'),],default=1) error_messages 自定義錯誤信息(字典類型),從而定製想要顯示的錯誤信息; 字典健:null, blank, invalid, invalid_choice, unique, and unique_for_date 如:{'null': "不能爲空.", 'invalid': '格式錯誤'} validators 自定義錯誤驗證(列表類型),從而定製想要的驗證規則 from django.core.validators import RegexValidator from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\ MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator 如: test = models.CharField( max_length=32, error_messages={ 'c1': '優先錯信息1', 'c2': '優先錯信息2', 'c3': '優先錯信息3', }, validators=[ RegexValidator(regex='root_\d+', message='錯誤了', code='c1'), RegexValidator(regex='root_112233\d+', message='又錯誤了', code='c2'), EmailValidator(message='又錯誤了', code='c3'), ] )