Model 模型

Introduction简介

示例

class profile(models.Model):
    SEX_CHOICE = (
        ('M':'男'),
        ('F':'女')
    )
    user = models.ForeignKey(User)  # 外键
    sex = models.CharField(
            max_length = 1,
            verbose_name = '性别',  # 显示名称
            choices = SEX_CHOICE)   # 可选内容
    birthday = models.DateField(default = datetime.date.today()) # 默认值, 日期
    registertime = models.DateTimeField(auto_now=True)
    # django默认是用
    lastlogin = models.DateTimeField()

方法

create...

refresh_from_db

validate objects..

save

save的时候，会把model的所有数据全量更新一遍，所以两个线程来了，只会save最后一个的数据

主键有就是update，主键没有就是insert
save的时候发生了什么
1. 触发model的pre—save信号
2. 处理数据，每个field触发pre_save，比如auto_now_add和auto_now
3. 处理给数据库的数据，每个field触发get_db_prep_save
4. 插入数据
5. 触发post-save信号
django怎么区分update和insert
指定更新哪些field: product.save(update_fields=["name"])
- 更新后，并不会触发refresh_from_db

delete...

pickle...

`str`

`eq`

`hash`

`get_absolute_url`

Field Types 字段类型

官网

ArrayField

postgresql特有的, size可以不传, 就是动态的size

from django.contrib.postgres.fields import ArrayField
from django.db import models


class ChessBoard(models.Model):
    board = ArrayField(
        ArrayField(
            models.CharField(max_length=10, blank=True),
            size=8,
        ),
        size=8,
    )

AutoField, BigAutoField, BigIntegerField, BinaryField

BooleanField

before 1.11 version: use NullBooleanField
after 2.0 version: user BooleanField(null=True)

CharField

当你添加charfield并且设置default以后，旧的进程会保存为None报错。所以建议新增的charfield都设置null=True, 所有进程更新后再删除null
哪怕设置了default，在migrations的时候也会先设置旧数据的default然后删除default，导致已经存在的进程无法保存数据

models.CharField(max_length=255)
models.TextField()  # 默认会为""
    max_length  # 不是数据库底层支持的。
models.EmailField()
## 底层还是 CharField 只不过用 EmailValidator 去校验

EmailValidator

DateField

官网
对于日期,不存在时区的概念,都是直接存入的日期,没有转化成utc

auto_now 自动保存为当前时间。当调用Model.save()的时候，这个字段会自动更新。如果你不希望更新，就使用QuerySet.update()
如果是bulk_create的，也会更新这个字段，并且每个model的时间都不一样
auto_now_add 只有当model第一次创建的时候，自动设置为当前时间。所以后续可以更改。

DateTimeField

参数
- auto_now_add = True: 保存为当前时间，不再改变见DateField
- auto_now = True: 保存未当前时间，每次保存时候会自动变更见DateField

示例

如果timezone = 'UTC'

DateTimeModel.objects.create(time=timezone.now())  # 没问题
DateTimeModel.objects.create(time=datetime.now())  # 自动保存为当前时间, 因为datetime.now()会自动变化，所以这个时间也是正确的
DateTimeModel.objects.create(time='2017-12-12 10:24:00')  # 保存为UTC的10点了，如果是客户直接上传的，就会到处差了8小时
DateTimeModel.objects.create(time='2017-12-12T10:24:00+08:00')  # 这么精确，也没问题

如果timezone = 'Asia/Shanghai'

DateTimeModel.objects.create(time=timezone.now())  # 没问题
DateTimeModel.objects.create(time=datetime.now())  # 自动保存为当前时间, 因为datetime.now()会自动变化，所以这个时间也是正确的
DateTimeModel.objects.create(time='2017-12-12 10:24:00')  # 保存为Asia/Shanghai的10点了，如果是客户直接上传的，因为恰好客户和我们的服务器是同一个时区，所以也没问题
DateTimeModel.objects.create(time='2017-12-12T10:24:00+08:00')  # 这么精确，也没问题

结论: 服务器端都用timezone，客户端都用带iso 8601

DecimalField

官网

decimal: '1.1', 1.1, decimal.Decimal('1.1')
- required 参数
```
max_digits = 3  # 数字的位数(包括小数), >= decimal_places
decimal_places = 2  # 小数尾数
```
- 注意事项
  - 整数部分的最大长度就是 max_digits - decimal_places, 不会因为某个数字小数部分没有而导致整数部分可以变得更长
  - 小数部分的最大长度就是 decimal_places, 不会因为整数部分短了这个就长
  - 不能传"", 或者None
  - 有了default就可以不传
  - 如果设置了blank=True, admin页面就能传递None(就算有default也不会设置成default, 而是这是成None), 后台不支持null=True的话就会报错
DurationField
官网时间字段, 返回python里的timedelta. 如果是PostgreSQL, 使用的是interval类型.
如果是其他的，一般都是存bigint表明要多少microseconds
EmailField

FileField

class FileField(upload_to="uploads/%Y/%m/%d")

FilePathField
FloatField
ImageField

IntegerField

官网 integer: 1, '1', 不可以是 '2.9', 但是可以是 2.9(之后存入2), 调用的是int函数 * 基础 models.IntegerField() # 整数 -2147483648 - -2147483648 models.PositiveSmallIntegerField() # 0 - 32767 models.SmallIntegerField() # -32767 - 32767 models.PositiveIntegerField() # 0 - 2147483647 models.FloatField() # 小数如果设置了unique的话，就会在数据库层面设置unique。不过数据库显示的时候偶尔会看上去一样实际上二者的二进制数据有点区别，换成是十进制后显示不出来。在python内部可以显示 models.DecimalField() # 精确小数 * AutoField # 不使用原来的id，而是使用自定义的主键。注意一个model里面primary_key只能有一个，autofield也只能有一个 models.AutoField(primary_key=True)

GenericIPAddressField

JSONField

JSONField虽然可以传json,但是drf里null的判断比json的早。所以None无法通过校验.
django里None的判断也比json早，遇到是None的时候直接保存null了，会违背数据库的约束。但是从数据库却能直接设置成"null", 导致从数据库拿出来的数据，直接save竟然会报错的情况。

PositiveIntegerField, PositiveSmallIntegerField,

SlugField

包含[a-zA-Z_-]，可以用在一些变量名上面
max_length 默认50
allow_unicode: 默认False，是否允许非ascii的名字

SmallIntegerField

TextField

TextField如果定义了max_length, 会影响view和form. 但是在数据库底层实现上没有max_length这个说法.

TimeField

URLField

其实就是CharField加上了URLValidator, 默认是200个字符长度

UUIDField

import uuid
models.UUIDField(default=uuid.uuid4)

Relationship fields 关联字段

ForeignKey

Example 例子

def get_default_user():
    return User.objects.first()

limit_choices_to={'is_staff': True}, # 只能设置给 is_staff 的User
related_name = "+" # 设置成+或者以+结尾，就会没有反向查找
models.ForeignKey(Model,
    on_delete=models.CASCADE # 默认连带删除(2.0以后参数必须传)
    on_delete=models.SET(get_default_user)  # 删除后调用函数设置连带关系的默认直
)

on_delete参数参考
- models.CASCADE: 连带删除
- models.PROTECT: 报错
- models.SET_NULL: 设置为空
- models.SET_DEFAULT: 设置为默认
- models.SET(): 调用函数
- models.DO_NOTHING: 什么都不做,但是数据库如果限制会有报错

OneToOneField

onetoone如果没有设置null=True, 但是实际数据库是None的话, 获取时会报错

models.ForeignKey(Model)    # 关联到另一个Model
models.OneToOneField(Model, related_name="profile", db_index=True)

参数

limit_choices_to={'is_staff': True}, # 只能设置给 is_staff 的User
related_name = "+" # 设置成+或者以+结尾，就会没有反向查找
设置被删除后，设置成一个其他用户

def get_default_user():
    return User.objects.first()
models.ForeignKey(Model,
    on_delete=models.CASCADE # 默认连带删除(2.0以后参数必须传)
    on_delete=models.SET(get_default_user)  # 删除后调用函数设置连带关系的默认直
)

ManyToManyField

官网

参数

related_name, related_query_name, limit_choices_to
symmetrical 官网

class Person(models.Model):
    friends = models.ManyToManyField("self")

默认为True, 代表如果personA的friends有personB, 那么personB的friends也就有A了, 所以也不存在~~friends_set~~ person_set属性如果需要分别计算, 需要设置symmetrical为False, 这样A把B当朋友, B就可以不把A当朋友了, 此时

through = "ModelRefName" 可以把中间关联的表拿出来写成model加参数
through_fields 官网 through_fields = ("source_field_name", "target_field_name") 当through定义的时候才有效, 如果through的表里面有多个field外键到同一张表, 第一个字段代表那个field代表了自己这个model, 第二个字段代表哪个field代表了manytomany的field
db_table = "关联的表名" 关联的数据库的表名称
db_constraint
swappable
null对于ManyToManyField没有任何效果

api

官网

基础

label = models.ManyToManyField(Label, verbose_name=u'标签', null=True)
todos = models.ManyToManyField(TodoList, through="WeeklyPaperTodoRef")

add: 官网

model.todos.add('1','2')  # 可以是数字，可以是字符串，可以是对象。只要是一个一个传入的即可，add以后就立刻添加进入了数据库
1. return None, 无法通过结果来判断是否有添加
2. 如果已经在里面了，不会二次添加
3. 如果不再这个里面，就会直接加进去
return None

remove:

model.label.remove(label1, label2)  # 可以重复，可以多个

set:
```
model.label.set([label1, label2])
```
clear:
```
model.label.clear()
```

其他

如果调用了本身，可以使用 models.ForeignKey('self', on_delete=models.CASCADE)
如果单独的manytomany, 可以使用through获取那个隐藏的model

school.students.through.objects.filter(school=school)

[ ] Field attribute reference

官网

Field API reference

Instance methods 实例方法

Refreshing objects from database

obj = MyModel.objects.first()
del obj.field
obj.field  # loads the only field from database 会重载这个field, 不会重载其他的field
obj.refresh_from_db()  # reload all the fields