Django ORM 中的单表查询 API（1）

在 Django 中，对象关系映射（ORM）提供了一种功能强大、表现力丰富的数据库交互方式。ORM 允许开发人员使用高级 Python 代码执行数据库查询，从而更轻松地处理数据库实体。

下面，我们将探讨 Django ORM 中单表查询 API 的用法，重点是 all()、filter()、get()、first() 和 last()。  

1、all() 方法

all()方法：返回一个包含数据库表中所有对象的 QuerySet。当在模型上调用该方法时，它会生成一个 SQL 查询，以检索相应表中的所有记录。例如
```
ret = Book.objects.all()
```
这将从 `Book` 表中获取所有记录，并以 QuerySet 的形式返回。

2、filter()方法

filter()方法：用于根据某些条件缩小查询结果的范围。它接受指定过滤条件的关键字参数。例如
```
ret = Book.objects.filter(name="西游记")
```
这将从 `Book` 表中检索名称为 "西游记 "的记录。

3、get()方法

get()方法：用于从数据库中检索符合指定条件的单个对象。该方法只期望得到一个结果，如果有零条或多条匹配记录，则会引发异常。例如
```
ret = Book.objects.get(name="西游记")
```
这将从 `Book` 表中检索名称为 "西游记 "的记录。

4、first() 和 last() 方法

first()和last()方法：分别用于从查询结果中检索第一个和最后一个对象。它们会从 QuerySet 返回一个模型对象。例如
```
fbook = Book.objects.all().first()
lbook = Book.objects.all().last()
```
通过这些方法，可以从 `Book` 表中检索第一条和最后一条记录。

5、代码演示 

############### 单表查询API ##################
def query(request):
    # 1 all() : 调用者 objects管理器 ， 返回 QuerySet
    # ret=Book.objects.all()
    # SELECT `app01_book`.`id`, `app01_book`.`name`, `app01_book`.`price`, `app01_book`.`pub_date`,
    # `app01_book`.`publish` FROM `app01_book` LIMIT 21
    # print(ret)
    # <QuerySet [<Book: Book object (7)>, <Book: Book object (8)>, <Book: Book object (13)>,<Book: Book object (14)>, <Book: Book object (15)>, <Book: Book object (16)>,<Book: Book object (17)>, <Book: Book object (18)>]>
    # <QuerySet[ < Book: 111 >, < Book: linux >, < Book: java >, < Book: java999 >, < Book: 飘 >, < Book: 红楼梦 >, < Book: 西游记 >, < Book: 水浒传 >] >

    # 2 filter()：调用者 objects管理器， 返回 QuerySet
    # ret=Book.objects.filter(name="西游记")
    # SELECT `app01_book`.`id`, `app01_book`.`name`, `app01_book`.`price`, `app01_book`.`pub_date`,
    # `app01_book`.`publish` FROM `app01_book` WHERE `app01_book`.`name` = '西游记' LIMIT 21
    # print(ret)
    # <QuerySet [<Book: 西游记>]>

    # 3 get() ：调用者 objects管理器，返回 查询到的 models对象，且只能查出来一个，否则报错
    # ret=Book.objects.get(name="西游记")
    # print(ret) # 西游记   __str__()
    # print(ret.name) # 西游记

    # 4 first(),last() : 调用者 QuerySet，返回model对象
    # fbook=Book.objects.all()[0]
    # fbook = Book.objects.all().first()
    # lbook = Book.objects.all().last()

    return HttpResponse("query success")

6、小结

Django ORM 中的单表查询 API 提供了一种使用高级 Python 代码与数据库交互和检索数据的便捷方法。通过使用 `all()`、`filter()`、`get()`、`first()` 和 `last()` 等方法，开发人员可以轻松执行各种数据库查询。

通过了解和利用这些方法，开发人员可以在其 Django 应用程序中高效地查询和操作数据，从而使开发过程更加简化、更有成效。