模型（model）

from django.db import models
继承：models.Model

模型接口方法

<1> all():                  查询所有结果
<2> filter(**kwargs):       它包含了与所给筛选条件相匹配的对象
<3> get(**kwargs):          返回与所给筛选条件相匹配的对象，返回结果有且只有一个，
                            如果符合筛选条件的对象超过一个或者没有都会抛出错误。
<4> exclude(**kwargs):      它包含了与所给筛选条件不匹配的对象
<5> order_by(*field):       对查询结果排序  用法:order_by('-price')        DESC 降序
<6> reverse():              对查询结果反向排序
<8> count():                返回数据库中匹配查询(QuerySet)的对象数量。
<9> first():                返回第一条记录
<10> last():                返回最后一条记录
<11> exists():              如果QuerySet包含数据，就返回True，否则返回False         相当于limit 1(用途查询这个表中是否有值)
<12> values(*field):        用法:Book.objects.all.values('title','price')  返回值是<queryset[{'title':'aa','pirce':12},{}]
<13> values_list(*field):   用法:Book.objects.all.values_list('title','price')  返回值是<queryset[('aa',12),('bb',33)]
<14> distinct():            从返回结果中剔除重复纪录  用法:Book.objects.all.values('title','price').distinct()   
                            错误用法 Book.objects.all.distinct()  因为id不相同,其他相同,无法去重

model field 类型

1、AutoField

一个自增的IntegerField，一般不直接使用，Django会自动给每张表添加一个自增的primary key。

2、BigIntegerField

64位整数， -9223372036854775808 到 9223372036854775807。默认的显示widget 是 TextInput.

3、BinaryField （ Django 1.6 版本新增）

存储二进制数据。不能使用 filter 函数获得 QuerySet

4、BooleanField

True/False，默认的widget 是 CheckboxInput。

如果需要置空，则必须用 NullBooleanField 代替。

Django 1.6 修改：BooleanField 的默认值由 False 改为 None，在 default 属性未设置的情况下。

5、CharField

存储字符串。必须有 max_length 参数指定长度。默认的form widget 是 TextInput

如果字符串巨长，推荐使用 TextField。

6、CommaSeparatedIntegerField

一串由逗号分开的整数。必须有 max_length 参数。

7、DateField
日期，与python里的datetime.date 实例同。有以下几个可选的选项，均为bool类型：

DateField.auto_now: 每次执行 save 操作的时候自动记录当前时间，常作为最近一次修改的时间使用。注意：总是在执行save 操作的时候执行，无法覆盖。
DateField.auto_now_add: 第一次创建的时候添加当前时间。常作为创建时间使用。注意：每次create 都会调用。

默认的form widget 是 TextInput。

注意：设置auto_now 或者 auto_now_add 为 True 会导致当前自动拥有 editable=False 和 blank = True 设置。

8、DateTimeField
日期+时间。与python里的 datetime.datetime 实例同。常用附加选项和DateField一样。
默认 form widget 是一个 TextInput

9、DecimalField
设置了精度的十进制数字。

10、EmailField
在 CharField 基础上附加了邮件地址合法性验证。不需要强制设定 max_length
注意：当前默认设置 max_length 是 75，虽然已经不符合标准，但未了向前兼容，未修改。

11、FileField
文件上传。不支持 primary_key 和 unique 选项。否则会报 TypeError 异常。
必须设置 FileField.upload_to 选项，这个是本地文件系统路径，附加在 MEDIA_ROOT 设置的后边，也就是 MEDIA_ROOT 下的子目录相对路径。

默认的form widget 是 FileInput。

使用 FileField 和 ImageField 需要以下步骤：
（1）修改 settting.py，设置 MEDIA_ROOT（使用绝对路径），指定用户上传的文件保存在哪里。设置 MEDIA_URL，作为 web地址前缀，要保证 MEDIA_ROOT 目录对运行 Django 的用户是可写的；
（2）在 model 中增加 FileField 或 ImageField，并指定 upload_to 选项指定存在 MEDIA_ROOT 的哪个子目录里；

（3）存在数据库里的是什么东西呢？是 File 或 Image相对于 MEDIA_ROOT 的相对路径，你可以在 Django 里方便的使用这个地址，比如你的 ImageField 叫 tupian，你可以在 template 中用{{object.tupian.url}}。

举个例子：假设你的 MEDIA_ROOT=’/home/media’，upload_to 设置为 ‘photos/%Y/%m/%d’，’%Y/%m/%d’ 部分使用strftime() 提供。如果你在 2013年10月10日上传了一个文件，那么它就存在 /home/media/photos/2013/10/10/ 下。

文件在 model实例执行 save操作的同时保存，所以文件在model实例执行save之前，硬盘的上的文件名的是不可靠的。

注意：要验证用户上传的文件确实是自己需要的，以防止安全漏洞出现。

默认情况下，FileField 在数据库中表现为 varchar(100) 的一个列。你可以使用 max_length 来改变这个大小。

11、FileField 和 FieldFile
当你访问一个 model 内的 FileField 时，将得到一个 FieldFile 实例来访问实际的文件。这个类提供了几个属性和方法用来和实际的文件数据交互：
FieldFile.url：只读属性，获取文件的相对URL地址;

FieldFile.open( mode = ‘rb’ )：打开文件，和python 的 open 一样;

FieldFile.close()：和 python 的 file.close() 一样;

FieldFile.save( name, content, save=True )：name 是文件名，content 是包含了文件内容的 django.core.files.File实例，与 python 的 file 不一样。The optional save argument controls whether or not the instance is saved after the file has been altered. Defaults to True。

两种方式进行 content 设置：

from django.core.files import File

f = open( ‘helo.txt’ )

content = File(f)

另一种是：

from django.core.files.base import ContentFile

content = ContentFile( ‘helloworld’ )

FieldFile.delete( save = True )：删除当前的文件。如果文件已经打开，则自动关闭。The optional save argument controls whether or not the instance is saved after the file has been deleted. Defaults to True.

值得注意的是：当一个 model实例被删除之后，相关联的文件并没有被删除，需要自己清除！

12、FloatField
与 python 里的 float 实例相同，默认的 form widget 是 TextInput。
虽然 FloatField 与 DecimalField 都是表示实数，但却是不同的表现形式，FloatField 用的是 python d float 类型，但是 DecimalField 用的却是 Decimal 类型。区别可见：http://docs.python.org/2.7/library/decimal.html#decimal

13、ImageField
在 FileField 基础上加上是否是合法图片验证功能的一个类型。
除了 FileField 有的属性外，ImageField 另有 height 和 width 属性。

注意：需要安装 PIL 或者 Pillow 模块。在数据库中同样表现为 varchar(100)，可通过 max_length 改大小。

14、IntegerField
整数，默认的form widget 是 TextInput。
15、IPAddressField
IP地址，字符串类型，如 127.0.0.1。默认 form widget 是 TextInput。
16、TextField
大文本，巨长的文本。默认的 form widget 是 Textarea。

注意，如果使用 MySQLdb 1.2.1p2 和 utf-8_bin 编码，会有一些问题https://docs.djangoproject.com/en/dev/ref/databases/#mysql-collation。具体问题未分析，可自行避开。

17、URLField
加了 URL 合法性验证的 CharField。
默认的 form widget 是 TextInput。

默认max_length=200，可修改。

Field 选项

null
boolean 值，缺省设置为false。通常不将其用于字符型字段上，比如CharField，TextField上。字符型字段如果没有值会返回空字符串。

blank
boolean 值，该字段是否可以为空。如果为假，则必须有值。

choices
元组值，一个用来选择值的2维元组。第一个值是实际存储的值，第二个用来方便进行选择。如SEX_CHOICES=((‘F’,’Female’),(‘M’,’Male’),)

db_column
string 值，指定当前列在数据库中的名字，不设置，将自动采用model字段名；
db_index
boolean 值，如果为True将为此字段创建索引；

default
给当前字段设定的缺省值，可以是一个具体值，也可以是一个可调用的对象，如果是可调用的对象将每次产生一个新的对象；

editable
boolean 值，如果为假，admin模式下将不能改写。缺省为真；

error_messages
字典，设置默认的出错信息，可覆盖的key 有 null, blank, invalid, invalid_choice, 和 unique。

help_text
admin模式下帮助文档
form widget 内显示帮助文本。

primary_key
设置主键，如果没有设置django创建表时会自动加上：id = meta.AutoField(‘ID’, primary_key=True)

radio_admin
用于 admin 模式下将 select 转换为 radio 显示。只用于 ForeignKey 或者设置了choices

unique
boolean值，数据是否进行唯一性验证；
unique_for_date
字符串类型，值指向一个DateTimeField 或者一个 DateField的列名称。日期唯一，如下例中系统将不允许title和pub_date两个都相同的数据重复出现

title = meta.CharField( maxlength=30, unique_for_date=’pub_date’ )
unique_for_month / unique_for_year
用法同上
verbose_name
string类型。更人性化的列名。

Meta常用属性

db_table(设置表名)

定义该model在数据库中的表名称示例：db_table = ‘tb_table’

verbose_name(模型别名)

verbose_name的意思很简单，就是给你的模型类起一个更可读的名字一般定义为中文，我们： verbose_name = “学校”

verbose_name_plural(模型别名复数)

这个选项是指定，模型的复数形式是什么，比如： verbose_name_plural = “学校” 如果不指定Django会自动在模型名称后加一个’s’

ordering(排序)

这个字段是告诉Django模型对象返回的记录结果集是按照哪个字段排序的。这是一个字符串的元组或列表，没有一个字符串都是一个字段和用一个可选的表明降序的’-‘构成。当字段名前面没有’-‘时，将默认使用升序排列。使用’?’将会随机排列

ordering=[‘order_date’] # 按订单升序排列
ordering=[‘-order_date’] # 按订单降序排列，-表示降序
ordering=[‘?order_date’] # 随机排序，？表示随机
ordering=[‘-pub_date’,’author’] # 以pub_date为降序，在以author升序排列

不实用外键关联关系实现多表联查

classGoods(models.Model):
"""商品表"""
name=models.CharField('名称',max_length=50)
num=models.IntegerField('数量',default=0)
#db_contraint=False表明了使用逻辑上的关联关系，而不需要数据库中的外键约束
shop_id=models.ForeignKey('Shop',on_delete=models.CASCADE,db_constraint=False)
classShop(models.Model):
"""店铺表"""
name=models.CharField('店铺名称',max_length=50)
reputation=models.SmallInteger('店铺信誉',default=1,help_text='范围：1~5')
这样就可以通过外键来实现INNERJOIN查询：queryset=Goods.objects.values('id','num','shop__reputation').order('-num','-shop__reputation')

orm数据库查询

get()	获取单个对象
create()	创建对象
bulk_create()	批量创建对象
get_or_create()	查询对象，若没有找到则创建新的对象
update()	批量更新对象
update_or_create()	更新对象，若没有找到则创建新的对象
delete()	批量删除对象
first()	获取第一个对象
last()	获取最后一个对象
latest()	获取最近的对象
earliest()	获取最早的对象
count()	统计对象的个数
exists()	判断queryset中是否有对象
aggregate()	聚合操作
in_bulk()	根据主键值的列表，批量返回对象
iterator()	获取包含对象的迭代器

编程

Django