Models and databases 之一 字段

模型是关于数据的单一的、最终的数据源。它包含存储的数据的基本字段和行为。通常，每个模型映射到单个数据库表。

• 每一个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    上传文件路径