模型是關于數據的單一的、最終的數據源。它包含存儲的數據的基本字段和行為。通常,每個模型映射到單個數據庫表。
- 每一個model十幾個繼承django.db.models.Model的Python子類
- 每一個model的屬性代表一個數據庫中的字段
- Django有一個操作數據庫的API
Quick example
from djiando.db import models
class Person(models.Model):
first_name = models.CharField(max_lenght=30)
last_name = models.CharField(max_length=30)
first_name和last_name是Person的屬性,也是響應的數據庫中的字段
以上Person類相當于下面的SQL語句
CREATE TABLE myapp_person(
'id' serial NOT NULL PRIMARY KEY
'first_name' varchar(30) NOT NULL
'last_name' varchar(30) NOT NULL
)
Django默認會為每一個類(表)加一個主鍵 myapp是你Django App的名稱 默認已App的名稱為表的前綴
需要使用一下命令同步數據庫(在相應的目錄下)
python manage.py makemigrations
python manage.py migrate
Fields(字段)
定義字段時不要有Django中model API的關鍵字(方法、屬性等)沖突,例如 clean,save和detele。
在model中的字段類型都是一個Field類的實例(一般都用Field類的子類 例如CharField)。正確的選擇Field types決定存儲在數據中字段的類型(INTEGER,VARCHAR等)。
1、models.AutoField 自增列 = int(11)
如果沒有的話,默認會生成一個名稱為 id 的列,如果要顯示的自定義一個自增列,必須將給列設置為主鍵 primary_key=True。
2、models.CharField 字符串字段
必須 max_length 參數
3、models.BooleanField 布爾類型=tinyint(1)
不能為空,Blank=True
4、models.ComaSeparatedIntegerField 用逗號分割的數字=varchar
繼承CharField,所以必須 max_lenght 參數
5、models.DateField 日期類型 date
對于參數,auto_now = True 則每次更新都會更新這個時間;auto_now_add 則只是第一次創建添加,之后的更新不再改變。
6、models.DateTimeField 日期類型 datetime
同DateField的參數
7、models.Decimal 十進制小數類型 = decimal
必須指定整數位max_digits和小數位decimal_places
8、models.EmailField 字符串類型(正則表達式郵箱) =varchar
對字符串進行正則表達式
9、models.FloatField 浮點類型 = double
10、models.IntegerField 整形
11、models.BigIntegerField 長整形
integer_field_ranges = {
'SmallIntegerField': (-32768, 32767),
'IntegerField': (-2147483648, 2147483647),
'BigIntegerField': (-9223372036854775808, 9223372036854775807),
'PositiveSmallIntegerField': (0, 32767),
'PositiveIntegerField': (0, 2147483647),
}
12、models.IPAddressField 字符串類型(ip4正則表達式)
13、models.GenericIPAddressField 字符串類型(ip4和ip6是可選的)
參數protocol可以是:both、ipv4、ipv6
驗證時,會根據設置報錯
14、models.NullBooleanField 允許為空的布爾類型
15、models.PositiveIntegerFiel 正Integer
16、models.PositiveSmallIntegerField 正smallInteger
17、models.SlugField 減號、下劃線、字母、數字
18、models.SmallIntegerField 數字
數據庫中的字段有:tinyint、smallint、int、bigint
19、models.TextField 字符串=longtext
20、models.TimeField 時間 HH:MM[:ss[.uuuuuu]]
21、models.URLField 字符串,地址正則表達式
22、models.BinaryField 二進制
23、models.ImageField 圖片
24、models.FilePathField 文件
Field options 字段選項
每一個字段都有一組特定字段的參數,例如CharField及其子類,需要至少傳遞一個max_length的參數作為相應的數據庫中varchar的長度。
每一個字段都有一個通用的選項可以設置,這些選項的設置與數據庫的設置息息相關,常用的設置項如下:
- null 如果是True,表示Django允許該字段存儲NULL,默認是False
- blank 此字段是否接受空白內容,默認值是False
blank與null的意義是不一樣的,blank是與值相關,如果blank=True表示此字段可以接受一個空白的值,如果是False表示此字段必須填寫 - choices 已選項的方式最為此字段的候選值
候選值的定義方式
YEAR_IN_SCHOOL_CHOICES=(
('FR','Freshman'),
('SO','Sophomore'),
('JR','Junior'),
('SR','Senior'),
('GR','Graduate'),
)
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_lenth=1,choices= SHIRT_SIZES)
>>>p = Person(name='Fred',shirt_size='L')
>>>p.save()
>>>p.shirt_size
'L'
>>>p.get_shirt_size_display()
'Large'
- default 設置字段的默認值
- help_text 字段的求助信息
- primary_key 設置數據表中的主鍵,默認False
from django.db import models
class Fruit(models.Model):
name = models.CharField(max_length=100,primary_key=True)
>>>f = Fruit.objects.create(name='Apple')
>>>f.name = 'Pear'
>>>f.save()
>>>f.objects.values_list('name',flat=True)
>>>['Apple','Pear']
其中flat=True 表示返回單個的值而不是元組。多個字段是不能用
- unique 設置次字段是否為唯一值
Automatic primary key fields
默認的Django為每個model設置默認自動遞增主鍵
id = models.AutoField(primary_key=True)
Verbose field names
每個filed type(除了ForeignKey, ManyToManyField and OneToOneField )都能在第一個參數設置verbose name
一個訪問人能夠讀懂的名字,用于顯示在網頁上的。如果verbose_nam設置的話。 默認是字段響應的屬性名(下劃線用空格代替)
first_name = models.CharField("person's first name",max_length=30)
>>>這是的verbose_name的名字為 person's first name
first_name = models.CharField(max_length=30)
>>>verbose_name的名字為 first name
ForeignKey, ManyToManyField and OneToOneField 等verbose name的設置需要用keyword的方式設置
poll = models.ForeignKey(Poll,on_delete=models.CASCADE,verbose_name='the related poll',)
auto_now 和 auto_now_add (用于時間字段類型)
auto_now 自動創建---無論添加或修改,都是當前操作的時間
auto_now_add 自動創建---永遠是創建時的時間
db_column 數據庫中的字段名稱
db_index = True 數據庫索引
editable=True 在Admin里是否可編輯
error_messages=None 錯誤提示
auto_created=False 自動創建
validators=[] 自定義數據格式驗證
upload-to 上傳文件路徑