06.orm模型层

Posted 2021-01-04 qql-anatkh

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"))