1、支持链式调用的接口
即返回QuerySet的接口
- all接口。相当于select * from table_name ,用于查询所有数据
- filter接口。根据条件过滤数据,常用条件基本上是字段等于、不等于、大于、小于、当然还有其他的,比如能改成产生LIKE查询的:Model.objects.filert(content__contains="条件")
- exclude接口。同filter,只是相反的逻辑
- reverse接口。把QuerySet结果倒叙排列
- distinct接口。用来进行去重查询,产生SELECT DISTINCT这样的SQL查询
- none接口。返回空的QuerySet
2、不支持链式调用的接口
即返回值不是QuerySet的接口
- get接口。比如Post.objects.get(id=1)用于查询id为1的文章:如果存在,则直接返回对应的Post实例;如果不存在,则抛出DoesNotExist异常,所以一般情况下,我们会这么用:
try:
post = Post.objects.get(id=1)
except Post.DoesNotExist:
- create接口。用来直接创建一个Model对象,比如post=Post.objects.create(title=”一起学习Django“)
- get_or_create接口。根据条件查找,如果没查找到,就调用create创建。
- update_or_create接口。同get_or_create只是用来做更新操作
- count接口。返回QuerySet有多少条记录
- latest接口。用于返回最新的一条记录,但是需要在Model的Meta中定义:get_latest_by = <用来排序的字段>
- earliest接口。返回最早的一条记录
- first接口。从当前,QuerySet记录中获取第一条
- last接口。同上获取最后一条
- exists接口。返回True或者False。如果只是需要判断QuerySet是否有数据,用这个接口是最合适的方式,不要用count或者len(QuerySet)这样的操作来判断是否存在。相反,如果可以预期接下来会用到QuerySet中的数据,就可以使用len(QuerySet)的方式来做判断,这样可以减少一次DB查询
- bulk_create接口。同create,用来批量创建记录
- in_bulk接口。批量查询,接收两个参数id_list和filed_name。可以通过Post.objects.in_bulk([1、2、3])查询出id为1、2、3的数据,返回结果是字典类型key为查询条件。返回结果示例:{1:<Post实例1>,2:<Post实例2>, 3:<Post 实例3>}
- update 接口。用来根据条件批量更新记录,比如:
Post.objects.filter(owner_name="carson").update(title='测试更新')
- delete接口。同update,这个接口是用来根据条件批量删除记录。需要注意的是,update和delete都会触发Django的signal
- values接口。当我们明确知道需要返回某个字段的值,不需要Model实例时,可以使用它,用法如下:
title_list = Post.objects.filter(category_id=1).values('title')
返回结果包含dict的QuerySet,类似这样:<QuerySet[{'title':xxx},]>
- values_list接口。同values,但是直接返回的是包含tuple的QuerySet:
titles_list = Post.objects.filter(category=1).values_list('title')
返回结果类似:<QuerySet[('标题',)]>,如果只是一个字段的话,可以通过增加flat=True参数,便于我们后续处理:
title_list = Post.objects.filter(category=1).values_list('title',flat=True)
for title in title_list: # 此时会执行数据库查询
print(post.content) # 此时会执行数据查询,获取content