## QuerySet API 我们通常做查询操作的时候，都是通过模型名字.objects的方式进行操作。其实模型名字.objects是一个django.db.models.manager.Manager对象，而Manager这个类是一个“空壳”的类，他本身是没有任何的属性和方法的。他的方法全部都是通过Python动态添加的方式，从QuerySet类中拷贝过来的  所以我们如果想要学习ORM模型的查找操作，首先要学会QuerySet上的一些API的使用。 ## QuerySet的方法 在使用QuerySet进行查找操作的时候，可以提供多种操作。比如过滤完后还要根据某个字段进行排序，那么这一系列的操作我们可以通过一个非常流畅的链式调用的方式进行。比如要从文章表中获取标题为123，并且提取后要将结果根据发布的时间进行排序，那么可以使用以下方式来完成 ``` articles = Article.objects.filter(title='123').order_by('create_time') ``` 可以看到order\_by方法是直接在filter执行后调用的。这说明filter返回的对象是一个拥有order\_by方法的对象。而这个对象正是一个新的QuerySet对象。因此可以使用order\_by方法。 那么以下将介绍在那些会返回新的QuerySet对象的方法。 1.`filter`：将满足条件的数据提取出来，返回一个新的`QuerySet` 2.`exclude`：排除满足条件的数据，返回一个新的`QuerySet` ``` 提取那些标题不包含`hello`的图书 Article.objects.exclude(title__contains='hello') ``` 3.`annotate`：给`QuerySet`中的每个对象都添加一个使用查询表达式（聚合函数、F表达式、Q表达式、Func表达式等）的新字段 ``` 将在每个对象中都添加一个`author__name`的字段，用来显示这个文章的作者的年龄 articles = Article.objects.annotate(author_name=F("author__name")) ``` 4.`order_by`：指定将查询的结果根据某个字段进行排序。如果要倒叙排序，那么可以在这个字段的前面加一个负号 ``` # 根据创建的时间正序排序(从小到大，默认排序规则) articles = Article.objects.order_by("create_time") # 根据创建的时间倒序排序 articles = Article.objects.order_by("-create_time") # 根据作者的名字进行排序 articles = Article.objects.order_by("author__name") # 首先根据创建的时间进行排序，如果时间相同，则根据作者的名字进行排序 articles = Article.objects.order_by("create_time",'author__name') # 根据图书订单的评分来排序 articles = BookOrder.objects.order_by("book__rating") ``` 5.`values`：用来指定在提取数据出来，需要提取哪些字段。默认情况下会把表中所有的字段全部都提取出来，可以使用`values`来进行指定，并且使用了`values`方法后，提取出的`QuerySet`中的数据类型不是模型，而是在`values`方法中指定的字段和值形成的字典 ``` articles = Article.objects.values("title",'content') for article in articles: print(article) ``` 以上打印出来的`article`是类似于`{"title":"abc","content":"xxx"}`的形式 6.`values_list`：类似于`values`。只不过返回的`QuerySet`中，存储的不是字典，而是元组 ``` articles = Article.objects.values_list("id","title") print(articles) ``` 那么在打印`articles`后，结果为`<QuerySet [(1,'abc'),(2,'xxx'),...]>`等 7.`all`：获取这个`ORM`模型的`QuerySet`对象。 8.`select_related`：在提取某个模型的数据的同时，也提前将相关联的数据提取出来。比如提取文章数据，可以使用`select_related`将`author`信息提取出来，以后再次使用`article.author`的时候就不需要再次去访问数据库了。可以减少数据库查询的次数 ``` article = Article.objects.get(pk=1) >> article.author # 重新执行一次查询语句 article = Article.objects.select_related("author").get(pk=2) >> article.author # 不需要重新执行查询语句了 ``` `selected_related`只能用在`一对多`或者`一对一`中，不能用在`多对多`或者`多对一`中。比如可以提前获取文章的作者，但是不能通过作者获取这个作者的文章，或者是通过某篇文章获取这个文章所有的标签 9.`prefetch_related`：这个方法和`select_related`非常的类似，就是在访问多个表中的数据的时候，减少查询的次数。这个方法是为了解决`多对一`和`多对多`的关系的查询问题。比如要获取标题中带有`hello`字符串的文章以及他的所有标签 ``` from django.db import connection articles = Article.objects.prefetch_related("tag_set").filter(title__contains='hello') print(articles.query) # 通过这条命令查看在底层的SQL语句 for article in articles: print("title:",article.title) print(article.tag_set.all()) ``` 10.`create`：创建一条数据，并且保存到数据库中。这个方法相当于先用指定的模型创建一个对象，然后再调用这个对象的`save`方法 ``` article = Article(title='abc') article.save() # 下面这行代码相当于以上两行代码 article = Article.objects.create(title='abc') ``` 11.`get_or_create`：根据某个条件进行查找，如果找到了那么就返回这条数据，如果没有查找到，那么就创建一个 ``` obj,created= Category.objects.get_or_create(title='默认分类') ``` 如果有标题等于`默认分类`的分类，那么就会查找出来，如果没有，则会创建并且存储到数据库中。 这个方法的返回值是一个元组，元组的第一个参数`obj`是这个对象，第二个参数`created`代表是否创建的。 12.`exists`：判断某个条件的数据是否存在。如果要判断某个条件的元素是否存在，那么建议使用`exists`，这比使用`count`或者直接判断`QuerySet`更有效得多。 ``` if Article.objects.filter(title__contains='hello').exists(): print(True) 比使用count更高效： if Article.objects.filter(title__contains='hello').count() > 0: print(True) 也比直接判断QuerySet更高效： if Article.objects.filter(title__contains='hello'): print(True) ``` 13.`update`：执行更新操作，在`SQL`底层走的也是`update`命令。比如要将所有`category`为空的`article`的`article`字段都更新为默认的分类 ``` Article.objects.filter(category__isnull=True).update(category_id=3) ``` 注意这个方法走的是更新的逻辑。所以更新完成后保存到数据库中不会执行`save`方法，因此不会更新`auto_now`设置的字段 14.切片操作：有时候我们查找数据，有可能只需要其中的一部分 ``` books = Book.objects.all()[1:3] for book in books: print(book) ``` 切片操作并不是把所有数据从数据库中提取出来再做切片操作。而是在数据库层面使用`LIMIE`和`OFFSET`来帮我们完成。所以如果只需要取其中一部分的数据的时候，建议大家使用切片操作。 ## 将QuerySet转换为SQL去执行 生成一个QuerySet对象并不会马上转换为SQL语句去执行 ``` from django.db import connection books = Book.objects.all() print(connection.queries) ``` 我们可以看到在打印connection.quries的时候打印的是一个空的列表。说明上面的QuerySet并没有真正的执行。 在以下情况下QuerySet会被转换为SQL语句执行 1. 迭代：在遍历QuerySet对象的时候，会首先先执行这个SQL语句，然后再把这个结果返回进行迭代。比如以下代码就会转换为SQL语句： ``` for book in Book.objects.all(): print(book) ``` 2. 使用步长做切片操作：QuerySet可以类似于列表一样做切片操作。做切片操作本身不会执行SQL语句，但是如果如果在做切片操作的时候提供了步长，那么就会立马执行SQL语句。需要注意的是，做切片后不能再执行filter方法，否则会报错。 3. 调用len函数：调用len函数用来获取QuerySet中总共有多少条数据也会执行SQL语句。 4. 调用list函数：调用list函数用来将一个QuerySet对象转换为list对象也会立马执行SQL语句。 5. 判断：如果对某个QuerySet进行判断，也会立马执行SQL语句。