開始學習Django,以下是一些筆記。
學習資料來源:Django學習,這個博主寫的比較詳盡,也很細緻。
在MVC或者說MTV設計模式中,模型(M)代表對數據庫的操作。
1.模型命名:
字段命名約束:
Django不允許下面兩種字段名:
-
與Python關鍵字衝突。這會導致語法錯誤。例如:
class Example(models.Model): pass = models.IntegerField() # 'pass'是Python保留字!
-
字段名中不能有兩個以上下劃線在一起,因爲兩個下劃線是Django的查詢語法。例如:
class Example(models.Model): foo__bar = models.IntegerField() # 'foo__bar' 有兩個下劃線在一起!
-
2.修改模型的注意事項
這裏可以選擇在執行migrate之前,先執行python manage.py makemigrations
讓修改動作保存到記錄文件中,方便github等工具的使用。
當你每次對模型進行增、刪、修改時,請務必執行命令python manage.py migrate
,讓操作實際應用到數據庫上。
如果不執行以上語句,模型的改變事體現不到數據庫上去的。
3.常用字段:
字段類型的作用:
- 決定數據庫中對應列的數據類型(例如:INTEGER, VARCHAR, TEXT)
- HTML中對應的表單標籤的類型,例如
<input type=“text” />
- 在admin後臺和自動生成的表單中最小的數據驗證需求
Django內置了許多字段類型,它們都位於django.db.models
中,例如models.CharField
。這些類型基本滿足需求,如果還不夠,你也可以自定義字段。
類型 | 說明 |
---|---|
AutoField | 一個自動增加的整數類型字段。通常你不需要自己編寫它,Django會自動幫你添加字段:id = models.AutoField(primary_key=True) ,這是一個自增字段,從1開始計數。如果你非要自己設置主鍵,那麼請務必將字段設置爲primary_key=True 。Django在一個模型中只允許有一個自增字段,並且該字段必須爲主鍵! |
BigAutoField | (1.10新增)64位整數類型自增字段,數字範圍更大,從1到9223372036854775807 |
BigIntegerField | 64位整數字段(看清楚,非自增),類似IntegerField ,-9223372036854775808 到9223372036854775807。在Django的模板表單裏體現爲一個textinput標籤。 |
BinaryField | 二進制數據類型。使用受限,少用。 |
BooleanField | 布爾值類型。默認值是None。在HTML表單中體現爲CheckboxInput標籤。如果要接收null值,請使用NullBooleanField。 |
CharField | 字符串類型。必須接收一個max_length參數,表示字符串長度不能超過該值。默認的表單標籤是input text。最常用的filed,沒有之一! |
CommaSeparatedIntegerField | 逗號分隔的整數類型。必須接收一個max_length參數。常用於表示較大的金額數目,例如1,000,000元。 |
DateField | class DateField(auto_now=False, auto_now_add=False, **options) 日期類型。一個Python中的datetime.date的實例。在HTML中表現爲TextInput標籤。在admin後臺中,Django會幫你自動添加一個JS的日曆表和一個“Today”快捷方式,以及附加的日期合法性驗證。兩個重要參數:(參數互斥,不能共存) auto_now :每當對象被保存時將字段設爲當前日期,常用於保存最後修改時間。auto_now_add :每當對象被創建時,設爲當前日期,常用於保存創建日期(注意,它是不可修改的)。設置上面兩個參數就相當於給field添加了editable=False 和blank=True 屬性。如果想具有修改屬性,請用default參數。例子:pub_time = models.DateField(auto_now_add=True) ,自動添加發布時間。 |
DateTimeField | 日期時間類型。Python的datetime.datetime的實例。與DateField相比就是多了小時、分和秒的顯示,其它功能、參數、用法、默認值等等都一樣。 |
DecimalField | 固定精度的十進制小數。相當於Python的Decimal實例,必須提供兩個指定的參數!參數max_digits :最大的位數,必須大於或等於小數點位數 。decimal_places :小數點位數,精度。 當localize=False 時,它在HTML表現爲NumberInput標籤,否則是text類型。例子:儲存最大不超過999,帶有2位小數位精度的數,定義如下:models.DecimalField(..., max_digits=5, decimal_places=2) 。 |
DurationField | 持續時間類型。存儲一定期間的時間長度。類似Python中的timedelta。在不同的數據庫實現中有不同的表示方法。常用於進行時間之間的加減運算。但是小心了,這裏有坑,PostgreSQL等數據庫之間有兼容性問題! |
EmailField | 郵箱類型,默認max_length最大長度254位。使用這個字段的好處是,可以使用DJango內置的EmailValidator進行郵箱地址合法性驗證。 |
FileField | class FileField(upload_to=None, max_length=100, **options) 上傳文件類型,後面單獨介紹。 |
FilePathField | 文件路徑類型,後面單獨介紹 |
FloatField | 浮點數類型,參考整數類型 |
ImageField | 圖像類型,後面單獨介紹。 |
IntegerField | 整數類型,最常用的字段之一。取值範圍-2147483648到2147483647。在HTML中表現爲NumberInput標籤。 |
GenericIPAddressField | class GenericIPAddressField(protocol='both', unpack_ipv4=False, **options)[source] ,IPV4或者IPV6地址,字符串形式,例如192.0.2.30 或者2a02:42fe::4 在HTML中表現爲TextInput標籤。參數protocol 默認值爲‘both’,可選‘IPv4’或者‘IPv6’,表示你的IP地址類型。 |
NullBooleanField | 類似布爾字段,只不過額外允許NULL 作爲選項之一。 |
PositiveIntegerField | 正整數字段,包含0,最大2147483647。 |
PositiveSmallIntegerField | 較小的正整數字段,從0到32767。 |
SlugField | slug是一個新聞行業的術語。一個slug就是一個某種東西的簡短標籤,包含字母、數字、下劃線或者連接線,通常用於URLs中。可以設置max_length參數,默認爲50。 |
SmallIntegerField | 小整數,包含-32768到32767。 |
TextField | 大量文本內容,在HTML中表現爲Textarea標籤,最常用的字段類型之一!如果你爲它設置一個max_length參數,那麼在前端頁面中會受到輸入字符數量限制,然而在模型和數據庫層面卻不受影響。只有CharField才能同時作用於兩者。 |
TimeField | 時間字段,Python中datetime.time的實例。接收同DateField一樣的參數,只作用於小時、分和秒。 |
URLField | 一個用於保存URL地址的字符串類型,默認最大長度200。 |
UUIDField | 用於保存通用唯一識別碼(Universally Unique Identifier)的字段。使用Python的UUID類。在PostgreSQL數據庫中保存爲uuid類型,其它數據庫中爲char(32)。這個字段是自增主鍵的最佳替代品,後面有例子展示。 |