Django model字段類型清單

Django 通過 models 實現數據庫的創建、修改、刪除等操作,本文爲模型中一般常用的類型的清單,便於查詢和使用:

AutoField:一個自動遞增的整型字段,添加記錄時它會自動增長。你通常不需要直接使用這個字段;如果你不指定主鍵的話,系統會自動添加一個主鍵字段到你的model。(參閱自動主鍵字段)

BooleanField:布爾字段,管理工具裏會自動將其描述爲checkbox。

CharField:字符串字段,單行輸入,用於較短的字符串,如要保存大量文本, 使用 TextField,CharField有一個必填參數:

CharField.max_length:字符的最大長度,django會根據這個參數在數據庫層和校驗層限制該字段所允許的最大字符數。

TextField:一個容量很大的文本字段, admin 管理界面用 <textarea>多行編輯框表示該字段數據。

CommaSeparatedIntegerField:用於存放逗號分隔的整數值。類似 CharField,必須maxlength 參數。

DateField:日期字段,admin 用一個文本框 <input type=”text”> 來表示該字段數據(附帶一個 JavaScript 日曆和一個”Today”快捷按鍵。有下列額外的可選參數:

auto_now:當對象被保存時,自動將該字段的值設置爲當前時間.通常用於表示 “last-modified” 時間戳;
auto_now_add:當對象首次被創建時,自動將該字段的值設置爲當前時間.通常用於表示對象創建時間。

DateTimeField:類似 DateField 支持同樣的附加選項。

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/p_w_picpaths”;
match:可選參數, 一個正則表達式, 作爲一個字符串, FilePathField 將使用它過濾文件名。 注意這個正則表達式只會應用到 base filename 而不是路徑全名。 Example: “foo。*\。txt^”, 將匹配文件 foo23.txt 卻不匹配 bar.txt 或 foo23.gif;
recursive:可選參數, 是否包括 path 下全部子目錄,True 或 False,默認值爲 False。

match 僅應用於 base filename, 而不是路徑全名。 如:FilePathField(path=”/home/p_w_picpaths”, match=”foo.*”, recursive=True)…會匹配 /home/p_w_picpaths/foo.gif 而不匹配 /home/p_w_picpaths/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創建表時會自動加上:

1id = meta.AutoField('ID', primary_key=True)
2primary_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 錯誤


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章