ORM模型层
01.常用字段
<1> CharField
字符串字段, 用于较短的字符串.
CharField 要求必须有一个参数 maxlength, 用于从数据库层和Django校验层限制该字段所允许的最大字符数.
<2> IntegerField
#用于保存一个整数.
<3> FloatField
一个浮点数. 必须 提供两个参数:
参数 描述：
max_digits 总位数(不包括小数点和符号)
decimal_places 小数位数
举例来说, 要保存最大值为 999 (小数点后保存2位),你要这样定义字段:
models.FloatField(..., max_digits=5, decimal_places=2)
要保存最大值一百万(小数点后保存10位)的话,你要这样定义:
models.FloatField(..., max_digits=19, decimal_places=10)
admin 用一个文本框(<input type="text">)表示该字段保存的数据.
<4> AutoField
一个 IntegerField, 添加记录时它会自动增长. 你通常不需要直接使用这个字段;
自定义一个主键：my_id=models.AutoField(primary_key=True)
如果你不指定主键的话,系统会自动添加一个主键字段到你的 model.
<5> BooleanField
A true/false field. admin 用 checkbox 来表示此类字段.
<6> TextField
一个容量很大的文本字段.
admin 用一个 <textarea> (文本区域)表示该字段数据.(一个多行编辑框).
<7> EmailField
一个带有检查Email合法性的 CharField,不接受 maxlength 参数.
<8> DateField
一个日期字段. 共有下列额外的可选参数:
Argument 描述
auto_now 当对象被保存时,自动将该字段的值设置为当前时间.通常用于表示 "last-modified" 时间戳.
auto_now_add 当对象首次被创建时,自动将该字段的值设置为当前时间.通常用于表示对象创建时间.
(仅仅在admin中有意义..)
<9> DateTimeField
一个日期时间字段. 类似 DateField 支持同样的附加选项.
<10> ImageField
类似 FileField, 不过要校验上传对象是否是一个合法图片.#它有两个可选参数:height_field和width_field,
如果提供这两个参数,则图片将按提供的高度和宽度规格保存.
<11> FileField
一个文件上传字段.
要求一个必须有的参数: upload_to, 一个用于保存上载文件的本地文件系统路径. 这个路径必须包含 strftime #formatting,
该格式将被上载文件的 date/time
注意：在一个 model 中使用 FileField 或 ImageField 需要以下步骤:
1）在你的 settings 文件中, 定义一个完整路径给 MEDIA_ROOT 以便让 Django在此处保存上传文件.
(出于性能考虑,这些文件并不保存到数据库.) 定义MEDIA_URL 作为该目录的公共 URL. 要确保该目录对
WEB服务器用户帐号是可写的.
2）在你的 model 中添加 FileField 或 ImageField, 并确保定义了 upload_to 选项,以告诉 Django
使用 MEDIA_ROOT 的哪个子目录保存上传文件.你的数据库中要保存的只是文件的路径(相对于 MEDIA_ROOT).
出于习惯你一定很想使用 Django 提供的 get_<#fieldname>_url 函数.举例来说,如果你的 ImageField
叫作 mug_shot, 你就可以在模板中以 {{ object.#get_mug_shot_url }} 这样的方式得到图像的绝对路径.
02.字段选项：常用的参数
(0)null
如果为True，Django 将用NULL 来在数据库中存储空值。 默认值是 False.
(1)blank
如果为True，该字段允许不填。默认为False。
要注意，这与 null 不同。null纯粹是数据库范畴的，而 blank 是数据验证范畴的。
如果一个字段的blank=True，表单的验证将允许该字段是空值。如果字段的blank=False，该字段就是必填的。
(2)default
字段的默认值。可以是一个值或者可调用对象。如果可调用 ，每有新对象被创建它都会被调用。
(3)primary_key
如果为True，那么这个字段就是模型的主键。如果你没有指定任何一个字段的primary_key=True，
Django 就会自动添加一个IntegerField字段做为主键，所以除非你想覆盖默认的主键行为，
否则没必要设置任何一个字段的primary_key=True。
(4)unique
如果该值设置为 True, 这个数据字段的值在整张表中必须是唯一的
(5)choices
由二元组组成的一个可迭代对象（例如，列表或元组），用来给字段提供选择项。 如果设置了choices ，默认的表单将是一个选择框而不是标准的文本框，而且这个选择框的选项就是choices 中的选项。
这是一个关于 choices 列表的例子：
YEAR_IN_SCHOOL_CHOICES = (
('FR', 'Freshman'),
('SO', 'Sophomore'),
('JR', 'Junior'),
('SR', 'Senior'),
('GR', 'Graduate'),
)
每个元组中的第一个元素，是存储在数据库中的值；第二个元素是在管理界面或 ModelChoiceField 中用作显示的内容。 在一个给定的 model 类的实例中，想得到某个 choices 字段的显示值，就调用 get_FOO_display 方法(这里的 FOO 就是 choices 字段的名称 )。例如：
1 from django.db import models
2
3 class Person(models.Model):
4 SHIRT_SIZES = (
5 ('S', 'Small'),
6 ('M', 'Medium'),
7 ('L', 'Large'),
8 )
9 name = models.CharField(max_length=60)
10 shirt_size = models.CharField(max_length=1, choices=SHIRT_SIZES)
11
12
13 >>> p = Person(name="Fred Flintstone", shirt_size="L")
14 >>> p.save()
15 >>> p.shirt_size
16 'L'
17 >>> p.get_shirt_size_display()
18 'Large'
03.settings配置中
给项目根目录下的__init__添加
import pymysql
pymysql.install_as_MySQLdb()
*如果报错如下：
django.core.exceptions.ImproperlyConfigured: mysqlclient 1.3.3 or newer is required;
MySQLclient目前只支持到python3.4，因此如果使用的更高版本的python，需要修改如下：
通过查找路径C:ProgramsPythonPython36-32Libsite-packagesDjango-2.0-py3.6.eggdjangodbackendsmysql 这个路径里的文件把
if version < (1, 3, 3):
raise ImproperlyConfigured("mysqlclient 1.3.3 or newer is required; you have %s" % Database.__version__)
注释掉 就OK了。
*如果想打印orm转换过程中的sql，需要在settings中进行如下配置：
1 LOGGING = { 2 'version': 1, 3 'disable_existing_loggers': False, 4 'handlers': { 5 'console':{ 6 'level':'DEBUG', 7 'class':'logging.StreamHandler', 8 }, 9 }, 10 'loggers': { 11 'django.db.backends': { 12 'handlers': ['console'], 13 'propagate': True, 14 'level':'DEBUG', 15 }, 16 } 17 }
04.添加表纪录
<1>一对一：
方式1
# create方法的返回值book_obj就是插入book表中的python葵花宝典这本书籍纪录对象
book_obj=Book.objects.create(title="python葵花宝典",state=True,price=100,publish="苹果出版社",pub_date="2012-12-12")
方式2
book_obj=Book(title="python葵花宝典",state=True,price=100,publish="苹果出版社",pub_date="2012-12-12")
book_obj.save()
<2>一对多：
方式1:找到关联表的对象
publish_obj=Publish.objects.get(nid=1)
book_obj=Book.objects.create(title="金",publishDate="2012-12-12",price=100,publish=publish_obj)
方式2:找到关联表的字段_id
book_obj=Book.objects.create(title="金",publishDate="2012-12-12",price=100,publish_id=1)
<3>多对多：用add进行多对多的关联创建
1 # 当前生成的书籍对象
2 book_obj=Book.objects.create(title="追风筝的人",price=200,publishDate="2012-11-12",publish_id=1)
3 # 为书籍绑定的做作者对象
4 yuan=Author.objects.filter(name="yuan").first() # 在Author表中主键为2的纪录
5 egon=Author.objects.filter(name="alex").first() # 在Author表中主键为1的纪录
6
7 # 绑定多对多关系,即向关系表book_authors中添加纪录
8 book_obj.authors.add(yuan,egon) # 将某些特定的 model 对象添加到被关联对象集合中。 ======= book_obj.authors.add(*[])
9
10 *多对多关系其他常用API
11 -1book_obj.authors.remove() # 将某个特定的对象从被关联对象集合中去除。 ====== book_obj.authors.remove(*[])
12 对于ForeignKey对象，这个方法仅在null=True时存在。
13
14 -2book_obj.authors.clear() #清空被关联对象集合
15 注意这样不会删除对象 —— 只会删除他们之间的关联。就像 remove() 方法一样，clear()只能在 null=True的ForeignKey上被调用。
16
17 -3book_obj.authors.set() #先清空再设置
*延伸：
1 # 1 *[]的使用
2
3 book_obj = Book.objects.get(id=1)
4 author_list = Author.objects.filter(id__gt=2)
5 book_obj.authors.add(*author_list)
6
7 # 2 直接绑定主键
8 book_obj.authors.add(*[1,3]) # 将id=1和id=3的作者对象添加到这本书的作者集合中
9 # 应用: 添加或者编辑时,提交作者信息时可以用到.
05.查询表纪录:查询API
<1> all(): 查询所有结果
<2> filter(**kwargs): 它包含了与所给筛选条件相匹配的对象
<3> get(**kwargs): 返回与所给筛选条件相匹配的对象，返回结果有且只有一个，
如果符合筛选条件的对象超过一个或者没有都会抛出错误。
<4> exclude(**kwargs): 它包含了与所给筛选条件不匹配的对象
<5> order_by(*field): 对查询结果排序
<6> reverse(): 对查询结果反向排序
<8> count(): 返回数据库中匹配查询(QuerySet)的对象数量。
<9> first(): 返回第一条记录
<10> last(): 返回最后一条记录
<11> exists(): 如果QuerySet包含数据，就返回True，否则返回False
<12> values(*field): 返回一个ValueQuerySet——一个特殊的QuerySet，运行后得到的并不是一系列
model的实例化对象，而是一个可迭代的字典序列
<13> values_list(*field): 它与values()非常相似，它返回的是一个元组序列，values返回的是一个字典序列
<14> distinct(): 从返回结果中剔除重复纪录
基于双下划线的模糊查询
1 Book.objects.filter(price__in=[100,200,300]) #in内
2 Book.objects.filter(price__gt=100) #gt大于
3 Book.objects.filter(price__lt=100) #lt小于
4 Book.objects.filter(price__range=[100,200]) #range范围
5 Book.objects.filter(title__contains="python")
6 Book.objects.filter(title__icontains="python") # 大小写不明感
7 Book.objects.filter(title__startswith="py") #startswith开头
8 Book.objects.filter(pub_date__year=2012) # _date__year拿到月份
9 startswith，istartswith, endswith, iendswith # 加了i的都为否定语句
06.删除表记录
方法就是 delete()。它运行时立即删除对象而不返回任何值。例如：
Entry.objects.filter(pub_date__year=2005).delete()
07.修改表纪录
Book.objects.filter(title__startswith="py").update(price=120)
此外，update()方法对于任何结果集（QuerySet）均有效，这意味着你可以同时更新多条记录update()
方法会返回一个整型数值，表示受影响的记录条数。
08.查询表记录
<1>对象obj查询
先查找一个obj对象，用get方法获取，或者用first
用此obj对象进行（正向看字段，反向看表名__set.all()）
其中在一对一的情况，可直接拿到obj，再通过.属性拿到相应值
一对多的情况，正向可拿到obj，再通过.属性拿到相应值/反向需要.all()拿到queryset进行遍历或者values_list()拿到需要的值
多对多的情况，正反向都需要.all()，再通过遍历拿到obj
<2>双下划线__查询
公式：需要的表.objects.filter(通过__拿到关键值).values_list('通过__拿到各种需求的值',''...)
<3>聚合查询aggregate
from django.db.models import Min, Max, Count, Sum
深度查询 .aggregate(自己赋值=Count/Max...'通过__拿到各种需求的值')
<4>分组查询annotate
每一xxx可以使用，相当于sql里的group
多于聚合查询混合使用
深度查询 .annotate(自己赋值=Count('通过__拿到各种需求的值'))
<5>排序order_by
.order_by('num_authors')
<6>F与Q
F:对单个对象中多个值进行比较操作
from django.db.models import F
# 查询评论数大于收藏数2倍的书籍
Book.objects.filter(commnetNum__lt=F('keepNum')*2)
# 将每一本书的价格提高30元：
Book.objects.all().update(price=F("price")+30)
Q:filter() 等方法中的关键字参数查询都是一起进行“AND” 的，要进行& |等复杂操作需要用Q
from django.db.models import Q
# or操作
bookList=Book.objects.filter(Q(authors__name="yuan")|Q(authors__name="egon"))