【Django 03】QuerySet 和 Instance应用

1. DRF QuerySet 和 Instance功能概述

1.1 QuerySet

从数据库中查询结果存放的集合称为 QuerySet。 Django ORM用到三个类：Manager、QuerySet、Model。每个Model都有一个默认的
manager实例，名为objects。Django的ORM通过Mode的objects属性提供各种数据操的接口（API），并通过 Model.objects 方法返回QuerySet，生产符合查询条件的列表，列表中包含多个 Instance。
在Django中，QuerySet是一个与数据库交互的高级抽象层，它用于执行数据库查询操作和操作数据库表中的数据。QuerySet是Django的ORM（Object-Relational Mapping）系统的一部分，它允许你通过Python代码而不是SQL语句来查询和操作数据库。

class QuerySet(model=None, query=None, using=None)[source]

其具有两大特色（1） 惰性：若这个对象中包含了需要的数据且需要使用时，它会去DB中获取数据，否则不会获取。 比如说在内部，创建、过滤、切片和传递一个QuerySet，而没有进行真正的数据执行，不会真实操作数据库，被称为惰性。（2）缓存使用同一个查询集，第一次使用时会发生数据库的查询，然后Django会把结果缓存下来，再次使用这个查询集时会使用缓存的数据，减少了数据库的查询次数。

1.2 操作说明

设定：已存在数据表定义如下：

class Goods(DjangoPeople):
{
number = CharField(max_length=32, verbose_name=‘编号’)
name = CharField(max_length=64, verbose_name=‘名称’)
unit = CharField(max_length=64, verbose_name=‘单位’)
remark = CharField(max_length=256, verbose_name=‘备注’)
} 
* `all()` :返回模型的所有对象，它的效果等价于不带任何条件的 `filter()` 方法。
    
    如：  DjangoPeople.objects.all() # 查询所有 语句。

*  filter()(**kwargs) 用于返回符合条件的所有数据。

    如：DjangoPeople.objects.filter(name=“abc”) #取出name="x"的DjangoPeople成员：
    又如：DjangoPeople.objects.filter(name=“x”) .filter(unit=“y”) #取出name="x"且unit="y"的DjangoPeople成员：

get() 方法与 filter() 的作用类似，用于返回符合条件的单个对象但是可能会返回多个值

delete() ：可以删除符合条件的所有对象

如：catagories_to_delete=DjangoPeople.objects.filter(name=“abc”)
deleted_count= categories_to_delete.delete()

update() ：将符合条件的所有对象的某个字段值进行更新

create() 是 save() 方法的快捷方式，用于创建并保存一个新的对象。

如：created_category = DjangoPeople.objects.create(name=“abc”)

count() ：返回符合条件的对象数量

order_by() ：对返回的对象进行排序，默认为升序。降序则在字段名前面加负号。

查询数据：你可以使用QuerySet来查询数据库中的数据。例如，你可以执行filter()、get()、exclude()等方法，以获取匹配特定条件的数据库记录。

链式查询：QuerySet支持链式查询，这意味着你可以在查询中多次使用不同的方法，以便筛选和排序数据。这使得构建复杂的查询非常容易。

延迟执行：QuerySet使用延迟执行的机制，它并不立即执行数据库查询，而是在需要数据时才执行。这有助于优化查询，减少不必要的数据库访问。

更新和删除数据：你可以使用update()方法来更新QuerySet中的数据，或者使用delete()方法删除匹配条件的数据。

聚合和统计：QuerySet支持对查询结果进行聚合和统计操作，如计数、求和、平均值等。

序列化数据：你可以将QuerySet中的数据序列化为JSON或其他格式，以便在API或前端应用程序中使用。

使用模型类：QuerySet是与Django模型类相关联的，它与模型类一起工作，允许你以面向对象的方式处理数据库数据。

QuerySet其他的其接口定义，用法类似，这里不再一一赘述，需要运用，可查阅Django官网。

1.3 Instance功能

Instance指的是一个 Django 模型的单个实例，也就是数据库中的一行数据。相比于 QuerySet（查询集合），它是针对单个对象的操作，用于创建、更新或者删除单个模型实例。
创建一个对象：Obj = Model(attr1=val1, attr2=val2)，Obj.save()
更新一个对象：Obj = Model.objects.get(id=xxx)，Obj.attr1 = val1，Obj.save()
删除一个对象：Obj = Model.objects.get(id=xxx)，Obj.delete()

QuerySet 适用于需要查找多个对象或进行聚合操作的场景，而 Instance 适用于单独对象的创建、修改和删除操作。

2. Django APIView

2.1 Teaching Order

APIView 的概念

APIview 是 Django REST Framework 提供的一个视图类。它和 Django 中的 view 类有些相似，但是又有一些不同之处。APIview 可以处理基于 HTTP 协议的请求，并返回基于内容协商的响应，它旨在提供一个易于使用且灵活的方式来构建 API 视图。

view.py

# 面向对象编程
from django.shortcuts import render
from rest_framework.decorators import api_view
from .models import *
from rest_framework.response import Response
from rest_framework.views import APIView
#### APIView
 class GetGoods(APIView):
     def get(self, request):
         data = Goods.objects.all()
         serializer = GoodsSerializer(instance=data, many=True)
         print(serializer.data)
         return Response(serializer.data)

     def post(self, request):
         # 从请求数据中提取字段
         request_data = {
             "category": request.data.get("Goodscategory"),
             "number": request.data.get("number"),
             "name": request.data.get("name"),
             "barcode": request.data.get("barcode"),
             "spec": request.data.get("spec"),
             "shelf_life_days": request.data.get("shelf_life_days"),
             "purchase_price": request.data.get("purchase_price"),
             "retail_price": request.data.get("retail_price"),
             "remark": request.data.get("remark"),
         }

         # 使用 create() 方法创建新的商品对象
         new_goods = Goods.objects.create(**request_data)

         # 对创建的对象进行序列化，并作为响应返回
         serializer = GoodsSerializer(instance=new_goods)
         return Response(serializer.data)


 # 面向对象编程
 class FilterGoodsCategoryAPI(APIView):
     # request 表示当前的请求对象
     # self 表示当前实例对象

     def get(self, request, format=None):
         print(request.method)
         return Response('ok')

     def post(self, request, format=None):
         print(request.method)
         return Response('ok')

     def put(self, request, format=None):
         print(request.method)
         return Response('ok')

url.py

from apps.erp_test.views import *

urlpatterns = [
    path('admin/', admin.site.urls),
    path('filtergoodscategoryapi/', FilterGoodsCategoryAPI.as_view()),
    path('getgoods/', GetGoods.as_view()),
]

首先，self 表示当前实例对象，这里指的是视图类的实例对象。

request 表示当前的请求对象，包含了客户端发送的信息，例如请求头、请求体等。

pk 是 path 参数 int:pk，用于获取请求中的产品 ID。

format 表示客户端请求的响应格式，例如 JSON、XML 等。这个参数通常不需要指定，会根据客户端发送的 Accept 请求头来自动选择响应格式。如果客户端指定了响应格式，那么我们可以从请求中获取到这个参数并且做出相应的处理。

在这个方法中，我们需要通过 pk 参数获取到对应的产品数据，并将其序列化成 JSON 格式并返回给客户端。具体的实现方式可以参考序列化器文档和 Django ORM 文档。

　　‍