django中models field详解
本文参考自:django官方文档models/field
在model中添加字段的格式一般为: field_name = field_type(**field_options)
一 field options(所有字段共用)
1 null 默认为False,True则表示可以为null。(空字符串在数据库中可能被存储为'')
2 blank 默认为False,True表示可以为空。
3 choice 可选的,限制了该选项的字段值必须是所指定的choice中的一个。
class Student(models.Model):
FRESHMAN = 'FR'
SOPHOMORE = 'SO'
JUNIOR = 'JR'
SENIOR = 'SR'
YEAR_IN_SCHOOL_CHOICES = (
(FRESHMAN, 'Freshman'), #第一个参数是真正的model参数,#第二个参数则是方便人们理解阅读
(SOPHOMORE, 'Sophomore'),
(JUNIOR, 'Junior'),
(SENIOR, 'Senior'),
)
year_in_school = models.CharField(
max_length=2,
choices=YEAR_IN_SCHOOL_CHOICES,
default=FRESHMAN,
) def is_upperclass(self):
return self.year_in_school in (self.JUNIOR, self.SENIOR)
from django.db import models class Student(models.Model):
FRESHMAN = 'FR'
SOPHOMORE = 'SO'
JUNIOR = 'JR'
SENIOR = 'SR'
YEAR_IN_SCHOOL_CHOICES = (
(FRESHMAN, 'Freshman'), #第一个参数是真正的model参数,#第二个参数则是方便人们理解阅读
(SOPHOMORE, 'Sophomore'),
(JUNIOR, 'Junior'),
(SENIOR, 'Senior'),
)
year_in_school = models.CharField(
max_length=2,
choices=YEAR_IN_SCHOOL_CHOICES,
default=FRESHMAN,
) def is_upperclass(self):
return self.year_in_school in (self.JUNIOR, self.SENIOR)
4 db_column 数据库column名称。默认为本字段的名称。
5 db_index 如果为True的话,该字段的数据库索引将会被创建
6 default 设置该字段的默认值,可以是值也可以是对象。
7 editable 默认为True,若为False,则不会在admin/界面显示
8 primary_key 若设置为True,则表示将该字段设置为主键。一般情况下django默认会设置一个自增长的id主键。
9 unique 若设置为True,该字段值不可重复
二 field type(字段类型,细分的话可以分为普通字段以及关系字段)
1 普通字段
1 AutoField() 根据已有id自增长的整形唯一字段,一般每个model类不需设置该字段,因为django会为每个model自动设置。
django默认会为每个model类添加如下语句:id = models.AutoField(primary_key=True) 当其他字段添加了primary_key属性,则不会创建id字段了
每个model类仅能有一个主键
2 BooleanField() 布尔型字段,默认的表单窗口部件是CheckBoxInput
3 CharField() 字符型字段,默认的表单窗口部件是TextInput。该字段类型有一个必需参数:max_length 在数据库水平限定了字符串最大长度
4 DateField() 日期字段,字段的值是python中datetime.date的实例,默认的表单窗口是TextInput有几个可选的参数:
auto_now=True/False:当设置为True时,每当该对象使用save()时,该字段的值就会被更新。
auto_now_add=True/False: 当设置为True时,该字段的值为该对象被创建时的日期
5 DateTimeField() 日期和时间字段,值为datetime.datetime实例。默认的表单窗口以及可选参数同上。
6 DecimalField() 混合精度的小数型数字字段。有两个必需的参数:
max_digits=ingt_number:限定数字的最大位数(包含小数位)
decimal_places=int_number:存储数字的小数位
#to store numbers up to 999 with a resolution of 2 decimal places, you’d use
models.DecimalField(..., max_digits=5, decimal_places=2)
7 EmailField(max_length=254, **options) 邮件字段,使用EmailValidator进行验证
8 FileField(upload_to=None, max_length=100, **options) 文件上传字段。
这个字段不能设置primary_key和unique选项.在数据库中存储类型是varchar,默认最大长度为100.
有两个可选参数:
upload_to
如果使用默认的FileSystomStorage,文件将会存储到settings文件中配置的MEDIA_ROOT路径中。
upload_to的值也可以为可调用对象,通过调用这个对象可以获得上传路径。
instance=: 定义了FileField的模型实例
filename='': 文件名称。
class MyModel01(models.Model):
# file will be uploaded to MEDIA_ROOT/uploads
upload = models.FileField(upload_to='uploads/')
# or...
# file will be saved to MEDIA_ROOT/uploads/2015/01/30
upload = models.FileField(upload_to='uploads/%Y/%m/%d/') #upload_to=可调用对象
def user_directory_path(instance, filename):
# file will be uploaded to MEDIA_ROOT/user_<id>/<filename>
return 'user_{0}/{1}'.format(instance.user.id, filename) class MyModel02(models.Model):
upload = models.FileField(upload_to=user_directory_path)
class MyModel01(models.Model):
# file will be uploaded to MEDIA_ROOT/uploads
upload = models.FileField(upload_to='uploads/')
# or...
# file will be saved to MEDIA_ROOT/uploads/2015/01/30
upload = models.FileField(upload_to='uploads/%Y/%m/%d/') #upload_to=可调用对象
def user_directory_path(instance, filename):
# file will be uploaded to MEDIA_ROOT/user_<id>/<filename>
return 'user_{0}/{1}'.format(instance.user.id, filename) class MyModel02(models.Model):
upload = models.FileField(upload_to=user_directory_path)
storage 用来设定文件存储仓库
9 FilePathField(path=None, match=None, recursive=False, max_length=100, **options)
这个字段的值被限制在系统上某个目录中的所有文件名集合中。有三个参数
path='': 该参数必需。上行所说的‘某个目录’的绝对路径。Example: "/home/images"
.
match='pattern': 可选参数。格式是正则表达式。用来拣选符合匹配正则表达式的文件
recursive=True/False: 可选参数,默认为False。设定是否递归该目录下所有子目录的所有文件。
FilePathField(path="/home/images", match="foo.*", recursive=True)
10 FloatField() 浮点字段,默认的表单窗口部件是NumberInput。和DecimalField经常混淆不清,
FloatField在内部使用Python中的float对象,而DecimalField在内部使用Python中的decimal对象。
11 ImageField(upload_to=None, height_field=None, width_field=None, max_length=100, **options)
图像字段。继承了FileField的所有属性和方法。而且还能自动验证上传的对象是否为合法的图像。
12 IntegerField 整形字段。
13 GenericIPAddressField(protocol='both', unpack_ipv4=False, **options) ip地址字段
protocol='both/ipv4/ipv6' 默认为both
unpack_ipv4 用处不大。
14 NullBooleanField 类似于BooleanField,不同的是其允许值为null
15 TextField() 与CharField类似,但一般用来存储体积较大的文本。
16 TimeField(auto_now=False, auto_now_add=False, **options) 时间字段,其值为datetime.time实例
17 URLField(max_length=200, **options) URL字段
类似于CharField的子类,默认最大长度为200.
18 UUIDField(**options) 通用唯一标识字段,当不想用django默认设置的AutoField字段时,可以用该字段代替。
2 关系字段
关系字段:一对一,多对一,多对多
一对一: 现在有很多一对一辅导班,也就是上课时,一个老师对应一个学生,一个学生对应一个老师
多对一: 很多偏远山区的学校可能整个学校只有一个老师,这一个老师对应多个学生,所有的学生对应这一个老师
多对多: 而我们则很幸福,学校里有许多老师,一个老师教习一科,学生有多个老师,老师有多个学生。
1 ForeignKey(othermodel, on_delete, **options) 多对一或者一对多或者外键字段。
othermodel: 所关联的模型,'多' model使用外键关联 '一'model。
当所关联的模型为他自己时,使用'self'
当引用的模型为其他app中的模型时,要加上app名称标签: 'app_name.model_name'
数据库会自动在外键字段上创建索引,可以使用de_index=False关闭该功能。
on_delete: 当删除 "一" 模型对象时,django会根据该参数的值对与该对象相关联的其他对象(也就是 ‘多’)进行操作。
在django1.9以及之前的版本中,on_delete作为一个关键字参数。而在1.10则可以作为第二个参数
models.CASCADE: 默认为models.CASCADE 级联删除。当删除'一'时,‘多’会被删除。比如:
# mysite项目下名为polls的app中的models.py
class follower(models.Model):
name = models.CharField(max_length=200)
menpai = models.ForeignKey('menpai', on_delete=models.CASCADE) #定义了models.CASCADE属性 def __str__(self):
return self.name class menpai(models.Model):
name = models.CharField(max_length=200) def __str__(self):
return self.name #运行 python3 manager.py shell进入交互页面
>>> from polls.models import follower,menpai
>>> m1=menpai(name='huashanpai')
>>> m1.save()
>>> m2=menpai(name='riyuejiao')
>>> m2.save()
>>> f1=follower(name='linghuchong',menpai=m1)
>>> f1.save()
>>> f2=follower(name='renwoxing',menpai=m2)
>>> f2.save()
>>> f1.menpai
<menpai: huashanpai>
>>> m1.delete()
(2, {'polls.menpai': 1, 'polls.follower': 1}) # 删除华山派时,将令狐冲也删除了
# mysite项目下名为polls的app中的models.py
class follower(models.Model):
name = models.CharField(max_length=200)
menpai = models.ForeignKey('menpai', on_delete=models.CASCADE) #定义了models.CASCADE属性 def __str__(self):
return self.name class menpai(models.Model):
name = models.CharField(max_length=200) def __str__(self):
return self.name #运行 python3 manager.py shell进入交互页面
>>> from polls.models import follower,menpai
>>> m1=menpai(name='huashanpai')
>>> m1.save()
>>> m2=menpai(name='riyuejiao')
>>> m2.save()
>>> f1=follower(name='linghuchong',menpai=m1)
>>> f1.save()
>>> f2=follower(name='renwoxing',menpai=m2)
>>> f2.save()
>>> f1.menpai
<menpai: huashanpai>
>>> m1.delete()
(2, {'polls.menpai': 1, 'polls.follower': 1}) # 删除华山派时,将令狐冲也删除了
modles.PROTECT : 当删除一个具有外键关系的对象时,会引发一个异常,阻止删除该对象
models.SET_NULL: 设置删除对象所关联的外键字段为null。但字段的null属性必需为True
models.SET_DEFAULT : 设置删除对象所关联的外键字段为默认的值。
models.SET(value) :设置删除对象所关联的对象的外键字段为value,value也可以是一个可调用函数。
from django.conf import settings
from django.contrib.auth import get_user_model
from django.db import models def get_sentinel_user():
return get_user_model().objects.get_or_create(username='deleted')[0] class MyModel(models.Model):
user = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.SET(get_sentinel_user),
)
from django.conf import settings
from django.contrib.auth import get_user_model
from django.db import models def get_sentinel_user():
return get_user_model().objects.get_or_create(username='deleted')[0] class MyModel(models.Model):
user = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.SET(get_sentinel_user),
)
models.DO_NOTHING : 不做任何操作
limit_choices_to 限制该字段为选项形。格式:limit_choices_to={'is_staff': True}。值也可以为可调用函数。
def limit_pub_date_choices():
return {'pub_date__lte': datetime.date.utcnow()} limit_choices_to = limit_pub_date_choices
def limit_pub_date_choices():
return {'pub_date__lte': datetime.date.utcnow()} limit_choices_to = limit_pub_date_choices
related_name 设置从关联对象到自身的关系的名称,若值为'+' 则关联对象与自身无逆向关系。详解请看官方文档。
to_field 设置所关联对象的关联字段。默认为关联对象的主键字段。
2 ManyToManyField(othermodel, **options) 多对多字段。
othermodel: 所关联的model名称
db_table: 多对多关系会在两个模型所对应的表中间创建一个‘中间表’ ,将多对多转换为两个多对一,该选项为这个中间表设置名称。一般来说django会默认为中间表创建名称,但人们读起来可能搞不清楚究竟中间表关联到了哪里。
related_name: 同多对一字段中的related_name
limite_choices_to: 同....
symmetrical: 当多对多关联对象为自身时可能会用到的参数。默认为True。a,b同属于person模型,person中的friends字段与自身设置了多对多关系,当该值设置为True时,django假定关系为对称,即:a是b的朋友,那么b也是a的朋友。设置为False时,django会强制为逆向关系创建描述信息。
though: 不想让django自动创建中间表,手动创建中间表所对应的model,通过though指定对应的model名称。
though_field: 当though参数被使用时,该参数才会有效。指定使用哪些中间模型字段来确立两个模型的多对多关系。
3 OneToOneField(othermodel, on_delete, parent_link=False, **options) 一对一字段。
othermodel: .......
on_delete:........
related_name:...........
django中models field详解的更多相关文章
- django中request对象详解(转载)
django中的request对象详解 Request 我们知道当URLconf文件匹配到用户输入的路径后,会调用对应的view函数,并将 HttpRequest对象 作为第一个参数传入该函数. ...
- django中的模型详解-1
在说明django模型之前,首先来说明一下django的生命周期,也就是一个请求到达django是如何处理的.[暂时不包含中间件] 浏览器的请求---->到达django中的urls中找到对应的 ...
- Django中的Ajax详解
AJAX(Asynchronous Javascript And XML)翻译成中文就是“异步Javascript和XML”.即使用Javascript语言与服务器进行异步交互,传输的数据为XML(当 ...
- Django模型model Field详解:
类型说明 AutoField一个自动增加的整数类型字段.通常你不需要自己编写它,Django会自动帮你添加字段:id = models.AutoField(primary_key=True),这是一个 ...
- django中的auth详解
Auth模块是什么 Auth模块是Django自带的用户认证模块: 我们在开发一个网站的时候,无可避免的需要设计实现网站的用户系统.此时我们需要实现包括用户注册.用户登录.用户认证.注销.修改密码等 ...
- django中的filter详解
filter (数据过滤) 我们很少会一次性从数据库中取出所有的数据:通常都只针对一部分数据进行操作. 在Django API中,我们可以使用`` filter()`` 方法对数据进行过滤: > ...
- Django中model层详解
#!/usr/bin/env python# _*_ coding:utf-8 _*_ from django.db import models class UserType(models.Model ...
- Django框架 之 querySet详解
Django框架 之 querySet详解 浏览目录 可切片 可迭代 惰性查询 缓存机制 exists()与iterator()方法 QuerySet 可切片 使用Python 的切片语法来限制查询集 ...
- JDK中Unsafe类详解
Java中Unsafe类详解 在openjdk8下看Unsafe源码 浅析Java中的原子操作 Java并发编程之LockSupport http://hg.openjdk.java.net/jdk7 ...
随机推荐
- springboot 拦截器
拦截器的实现: 创建自定义拦截器CustomInterceptor: package com.xc.boot.handler; import org.springframework.stereotyp ...
- Stanford Local 2016 G "Ground Defense"(线段树)
传送门 题意: 有 n 个城市,编号 1~n: 有两种操作:Update,Query Update: E i s a d 更新区间[ i,i+d-1 ], i 节点降落 s 人, i+1 节点降落 s ...
- elasticsearch简单实现
初次接触分布式是全文搜索引擎,之前都是spinx+coreseek,先简单实现初步了解先 官方文档:https://www.elastic.co/guide/cn/elasticsearch/guid ...
- Java多线程:向线程传递参数的三种方法
在传统的同步开发模式下,当我们调用一个函数时,通过这个函数的参数将数据传入,并通过这个函数的返回值来返回最终的计算结果.但在多线程的异步开发模式下,数据的传递和返回和同步开发模式有很大的区别.由于线程 ...
- LCA(ST倍增)
时间复杂度: dfs树,求st表(状态数组f):O(NlgN) 处理M个查询:O(MlgN) 总:O((M+N)lgN) #include<iostream> #include<cs ...
- 《JavaScript.DOM》读书笔记
- js常用数据类型(Number,String,undefined,boolean) 引用类型( function,object,null ),其他数据类型( 数组Array,时间Date,正则RegExp ),数组与对象的使用
js常用数据类型 数字类型 | 字符串类型 | 未定义类型 | 布尔类型 typeof()函数查看变量类型 数字类型 Number var a1 = 10; var a2 = 3.66; conso ...
- 点评cat系列-应用集成
========================消息的基本属性========================消息的几个属性:type: 定义消息的 category, 比如 SQL 或 RPC 或 ...
- [物理学与PDEs]第2章第2节 粘性流体力学方程组 2.5 粘性热传导流体动力学方程组的数学结构
1. 粘性热传导流体动力学方程组可化为 $$\beex \bea \cfrac{\p \rho}{\p t}&+({\bf u}\cdot\n)\rho=-\rho \Div{\bf u}, ...
- JS实现定时任务,每隔N秒请求后台——setInterval定时和ajax请求
DiGui = function (param) { $.ajax({ success: function (returnValue) { window.setInterval("fnSet ...