## ORM
django為使用一種新的方式，即：關系對象映射（Object Relational Mapping，簡稱ORM）
django中遵循 `Code Frist` 的原則，即：根據代碼中定義的類來自動生成數據庫表。
需要使用`django.db`中的`models`模塊
```
from django.db import models
class userinfo(models.Model):
name = models.CharField(max_length=30)
email = models.EmailField()
memo = models.TextField()
user_group = models.ForeignKey(to='UserGroup', to_field='id', default=1)
class UserGroup(models.Model):
# id列，默認創建自增
# 用戶名 字符串 長度
id = models.AutoField(primary_key=True)
groupname = models.CharField(max_length=32)
```
>[danger]外鍵
user_group = models.ForeignKey(to='', to_field='')，此處外鍵的字段名為user_group，實際上在數據庫生成的字段名為user_group_id，以后數據更新時，可以直接操作這個字段。
外鍵會自動生成索引，便于查詢，其他字段字段使用db_index=True創建索引。
## 可定義的數據類型
### 數字型
```
models.AutoField # 自增列<==>int()
如果沒有的話，默認會生成一個名稱為 id 的列，如果要顯示的自定義一個自增列，必須將給列設置為主鍵 primary_key=True。
models.BooleanField # 布爾類型=tinyint(1)
不能為空，blank=True
models.NullBooleanField # 允許為空的布爾類型
models.Decimal 十進制小數類型 = decimal
必須指定整數位max_digits和小數位decimal_places
models.FloatField # 浮點類型 = double
models.IntegerField # 整形
models.BigIntegerField # 長整形
integer_field_ranges = {
'SmallIntegerField': (-32768, 32767),
'PositiveSmallIntegerField': (0, 32767),
'IntegerField': (-2147483648, 2147483647),
'PositiveIntegerField': (0, 2147483647),
'BigIntegerField': (-9223372036854775808, 9223372036854775807),
}
```
### 時間日期型
```
models.DateField # 日期類型 date
auto_now = True 則每次更新都會更新這個時間；
auto_now_add 則只是第一次創建添加，之后的更新不再改變。
models.DateTimeField # 日期類型 datetime
同DateField的參數
models.TimeField # 時間 HH:MM[:ss[.uuuuuu]]
```
### 文本型
```
models.CharField # 字符串字段
models.TextField # 字符串=longtext
models.ComaSeparatedIntegerField 用逗號分割的數字=varchar
繼承CharField，所以必須 max_lenght 參數
```
### 特殊類型
```
models.EmailField 字符串類型（正則表達式郵箱） =varchar
對字符串進行正則表達式
models.URLField 字符串，地址正則表達式
models.IPAddressField # 字符串類型（ip4正則表達式）
models.GenericIPAddressField # 字符串類型（ip4和ip6是可選的）
參數protocol可以是：both、ipv4、ipv6
models.ImageField # 圖片
models.FilePathField # 文件
models.SlugField # 減號、下劃線、字母、數字
models.BinaryField # 二進制
```
### 更多字段參數
~~~
# 常用
null=True # 數據庫中字段是否可以為空
primary_key = False # 主鍵，對AutoField設置主鍵后，就會代替原來的自增 id 列
unique=True # 不允許重復
db_index = True # 數據庫索引
max_length # 最大字符長度
default # 默認值
# 日期相關
auto_now 和 auto_now_add
auto_now # 自動創建---無論添加或修改，都是當前操作的時間
auto_now_add # 自動創建---永遠是創建時的時間
# choices 用于不會變動的信息，如性別，經常變動的如改變需要重啟服務
GENDER_CHOICE = (
(u'M', u'Male'),
(u'F', u'Female'),
)
gender = models.CharField(max_length=2,choices = GENDER_CHOICE)
name|db_column # 數據庫中的字段名稱
# 幫助相關
auto_created=False # 自動創建
validators=[]
upload-to
~~~
### admin相關
~~~
blank=True # Admin 中添加數據時是否可允許空值
help_text # 在Admin中提示幫助信息
error_messages=None # 錯誤提示
verbose_name # 在Admin中字段的顯示名稱
editable=True # 在Admin里是否可編輯
~~~
