一、QuerySet

QuerySet 是 Django 中的一個(gè)查詢集合，它是由 Model.objects 方法返回的，并且可以用于生成數(shù)據(jù)庫(kù)中所有滿足一定條件的對(duì)象的列表。

QuerySet 在 Django 中表示從數(shù)據(jù)庫(kù)中獲取的對(duì)象集合,它是一個(gè)可迭代的、類似列表的對(duì)象集合。主要特點(diǎn)包括:- 從 Model.objects 獲得,表示數(shù)據(jù)庫(kù)中所有該 Model 的對(duì)象集合。

- 可以添加過(guò)濾條件來(lái)限制查詢結(jié)果,如?.filter()、`.exclude()`、`.order_by()` 等。

- 惰性執(zhí)行,創(chuàng)建 QuerySet 不會(huì)立即執(zhí)行查詢,只有在需要求值時(shí)才查詢數(shù)據(jù)庫(kù)。- 可遍歷,可以用在 for 循環(huán)中進(jìn)行迭代。- 可切片,使用索引切片來(lái)獲取一個(gè)子集。

- 支持鏈?zhǔn)秸{(diào)用過(guò)濾方法,每個(gè)過(guò)濾調(diào)用返回一個(gè)新的 QuerySet。

- 可以獲取單個(gè)元素,如?.get()?返回單個(gè)匹配的對(duì)象。

- 支持轉(zhuǎn)換為其他對(duì)象列表,如?.values()。

- 可以轉(zhuǎn)為字符串執(zhí)行原始 SQL 查詢。所以 QuerySet 是從數(shù)據(jù)庫(kù)中獲取模型對(duì)象數(shù)據(jù)的一個(gè)強(qiáng)大而靈活的接口。正確使用可以最大限度減少數(shù)據(jù)庫(kù)查詢,提高效率。每個(gè) QuerySet 包含多個(gè) Model 實(shí)例(Instance),表示滿足查詢條件的所有對(duì)象實(shí)例。

1.filter()方法接收的參數(shù)有:- 字段名,比如:.filter(name='John')
- 查詢表達(dá)式,比如:?.filter(age__gt=18)
- Q對(duì)象,用于復(fù)雜查詢,比如:

from django.db.models import Qqueryset.filter(Q(age__gt=18) & Q(name='John'))

關(guān)鍵字參數(shù),比如:.filter(name='John', age__gt=18)filter()會(huì)基于給定的參數(shù)生成一個(gè)新的過(guò)濾后的QuerySet。例如:

Article.objects.filter(published=True) # 已發(fā)布文章Article.objects.filter(title__contains='Django') # 標(biāo)題包含Django的文章Article.objects.filter(Q(title__contains='Django') | Q(title__contains='Python'))
# 標(biāo)題包含Django或Python的文章

重要的是,filter()并不會(huì)立即執(zhí)行查詢,只是返回一個(gè)新的QuerySet,真正的數(shù)據(jù)庫(kù)查詢會(huì)在需要求值的時(shí)候發(fā)生。我們可以多次調(diào)用filter()來(lái)鏈?zhǔn)竭^(guò)濾,每個(gè)filter()調(diào)用會(huì)基于前一個(gè)QuerySet然后返回一個(gè)新的QuerySet。

2.get(）

get()方法與filter()有些類似,主要區(qū)別在于:

（1. get()用來(lái)獲取單個(gè)對(duì)象,而filter()獲取一個(gè)對(duì)象集合(queryset)。

（2. get()只能返回一個(gè)滿足條件的對(duì)象實(shí)例,如果不存在會(huì)引發(fā)模型類的DoesNotExist異常。

（3. get()無(wú)法鏈接調(diào)用,只能獲取單個(gè)對(duì)象。例如:

# 獲取id=1的文章
article = Article.objects.get(id=1) # 查詢標(biāo)題包含'Python'的文章,如果不存在會(huì)報(bào)錯(cuò)
article = Article.objects.get(title__contains='Python')# filter()返回滿足條件的所有文章
articles = Article.objects.filter(title__contains='Python')

所以get()主要用于根據(jù)過(guò)濾條件獲取單個(gè)對(duì)象,這對(duì)于獲取某個(gè)具體模型實(shí)例很有用,但需要注意如果不存在會(huì)引發(fā)異常。而filter()用于獲取多個(gè)滿足條件的對(duì)象,這對(duì)獲取一個(gè)QuerySet集合并對(duì)其進(jìn)一步處理很有用。需要根據(jù)具體場(chǎng)景選擇使用get()還是filter()。

3.all(）

Django中的`Model.objects.all()`方法返回該模型的全部對(duì)象集合。它相當(dāng)于沒(méi)有任何過(guò)濾條件的`filter()`查詢:

Article.objects.all()
# 等同于
Article.objects.filter()

all()返回的是一個(gè)包含該模型所有對(duì)象的QuerySet。我們可以在`all()`的基礎(chǔ)上進(jìn)一步鏈?zhǔn)竭^(guò)濾:

Article.objects.all().filter(published=True) 

all()對(duì)于獲取某個(gè)模型的全部數(shù)據(jù)很有用。當(dāng)然,如果數(shù)據(jù)量很大,我們可能需要限制返回的數(shù)據(jù)條數(shù),以提高性能。另外,all()每次都會(huì)查詢數(shù)據(jù)庫(kù)。如果需要多次使用全部數(shù)據(jù)集,可以考慮使用緩存或預(yù)取相關(guān)對(duì)象:prefetch_related()。所以在合適的時(shí)候使用`all()`可以方便地獲取模型的全部實(shí)例,但需要注意數(shù)據(jù)量大小和重復(fù)查詢的問(wèn)題。

4.delete()

delete()方法將刪除QuerySet中的所有對(duì)象,并返回刪除的對(duì)象數(shù)量。

  @action(detail=False, methods=['get','post'])def delete_example(self, request):name = request.data.get('name')# 刪除名稱為 'name' 的商品categories_to_delete = GoodsCategory.objects.filter(name=name)# 使用delete()方法刪除對(duì)象deleted_count= categories_to_delete.delete()print(f"Deleted {deleted_count} categories.")      

主要流程是:1. 通過(guò)filter()篩選出需要?jiǎng)h除的對(duì)象集合2. 在這個(gè)QuerySet上調(diào)用delete()方法實(shí)現(xiàn)刪除3. delete()方法會(huì)刪除QuerySet中的所有對(duì)象,并返回刪除的對(duì)象數(shù)量所以delete()為批量刪除QuerySet中的對(duì)象提供了很好的便利。注意delete()會(huì)立即執(zhí)行刪除操作,不像filter()那樣是延遲執(zhí)行。另外,delete()默認(rèn)不會(huì)觸發(fā)模型的delete()方法,如果需要調(diào)用可以設(shè)置:

categories_to_delete.delete(keep_parents=False)

這樣會(huì)為每個(gè)對(duì)象調(diào)用delete()方法。delete()方法非常適合批量刪除不需要的對(duì)象,可以用來(lái)定期清理數(shù)據(jù)庫(kù)。但需要注意確保篩選條件正確,避免誤刪除。

5.update()

update() 方法將對(duì)QuerySet進(jìn)行篩選,獲取需要更新的對(duì)象集合,然后執(zhí)行數(shù)據(jù)庫(kù)更新操作?；菊Z(yǔ)法如下:

queryset.update(字段1=值1, 字段2=值2...)

這將設(shè)置指定的字段到相應(yīng)的值。例如:

Article.objects.filter(published=True).update(status='p') 
# 將已發(fā)布文章的狀態(tài)都設(shè)為'p'Article.objects.filter(id__in=[1,2,3]).update(views=F('views') + 1)
# 對(duì)id為1,2,3的文章瀏覽量增1

update()默認(rèn)只會(huì)更新指定的字段。需要注意,update()同樣會(huì)立即執(zhí)行更新,并返回更新的行數(shù)。update()提供了一個(gè)非常高效的批量更新對(duì)象方法,可以避免大量的單個(gè)對(duì)象更新開(kāi)銷。但同樣需要確保更新條件的準(zhǔn)確性。

6.create()

create()?方法是?save()?方法的快捷方式，用于創(chuàng)建并保存一個(gè)新的對(duì)象。

@action(detail=False, methods=['get','post'])def create_example(self, request):name = request.data.get('name')# 使用create()方法創(chuàng)建新的商品分類對(duì)象created_category = GoodsCategory.objects.create(name)print("Created category:", created_category) 

主要的用法是:

GoodsCategory.objects.create(name='名稱', field1='值1',...)

這將實(shí)例化GoodsCategory,為其設(shè)置指定的字段值,然后直接保存到數(shù)據(jù)庫(kù)中。與下面的用法等價(jià):

category = GoodsCategory(name='名稱', field1='值1',...) 
category.save()

所以create()方法對(duì)于快速創(chuàng)建對(duì)象非常方便,尤其是在數(shù)據(jù)初始化或者測(cè)試中可以減少代碼量。需要注意:- create()參數(shù)必須提供對(duì)象必填字段的值
- create()會(huì)自動(dòng)保存對(duì)象,無(wú)需再調(diào)用save()
- 創(chuàng)建成功后會(huì)返回新創(chuàng)建的對(duì)象實(shí)例綜上,create()是save()方法的一個(gè)非常好用的封裝,可以簡(jiǎn)化對(duì)象創(chuàng)建的代碼。

7.count()

Django QuerySet 中的 count() 方法可以用來(lái)返回滿足指定查詢條件的對(duì)象的總數(shù)。count() 方法會(huì)執(zhí)行查詢,獲取匹配查詢(filters)的對(duì)象數(shù)目。使用方式:

Article.objects.filter(published=True).count() # 返回已發(fā)布文章數(shù)Article.objects.filter(title__contains='Django').count() # 返回標(biāo)題包含'Django'的文章數(shù)

Article.objects.filter(published=True).count() # 返回已發(fā)布文章數(shù) Article.objects.filter(title__contains='Django').count() # 返回標(biāo)題包含'Django'的文章數(shù)

count()會(huì)執(zhí)行查詢數(shù)據(jù)庫(kù)的COUNT操作,性能上比提取所有對(duì)象再計(jì)算列表長(zhǎng)度要更高效,尤其是數(shù)據(jù)量很大的時(shí)候。我們可以像鏈?zhǔn)秸{(diào)用filter()一樣,鏈?zhǔn)秸{(diào)用count()來(lái)獲取不同條件下的數(shù)量:

Article.objects.filter(published=True).filter(views__gt=10).count() 
# 返回已發(fā)布且瀏覽量大于10的文章數(shù)。

需要注意,使用count()之后再繼續(xù)鏈?zhǔn)竭^(guò)濾就不會(huì)生效了。所以count()為我們提供了一個(gè)簡(jiǎn)單直觀的方式來(lái)獲取查詢集大小?？梢杂脕?lái)判斷是否有匹配的對(duì)象,或者計(jì)算比較不同查詢的結(jié)果數(shù)目。

8.order_by()

Django QuerySet 中order_by()方法用于對(duì)返回的對(duì)象進(jìn)行排序。order_by()的常見(jiàn)用法:

# 按發(fā)布日期升序排序
Article.objects.order_by('publish_date') # 按瀏覽量降序排序 
Article.objects.order_by('-views')# 先按發(fā)布日期降序,再按標(biāo)題升序
Article.objects.order_by('-publish_date', 'title')

默認(rèn)order_by()是按升序排列的,如果需要降序,可以在參數(shù)字段名前加一個(gè)負(fù)號(hào)-。可以傳遞多個(gè)字段名來(lái)先后進(jìn)行排序,如上面的例子。order_by()通常用在需要排序的查詢中,比如獲取最新文章:

latest_articles = Article.objects.order_by('-publish_date')[:10] 

需要注意order_by()通常應(yīng)該放在鏈?zhǔn)讲樵兊淖詈?因?yàn)樗鼤?huì)改變查詢結(jié)果的順序。order_by()非常實(shí)用,可以幫助我們按任意字段排序查詢集,靈活地獲取需要的數(shù)據(jù)。

9.values()

在Django中,values()方法可以用來(lái)獲取QuerySet中的對(duì)象的指定字段的值,返回一個(gè)ValueQueryset,里面是以字典形式包含指定字段值的對(duì)象。那么

Map.objects.all().values().first()

的作用就是:

(1.?Map.objects.all()?返回Map模型的全部對(duì)象的QuerySet

(2. 在這個(gè)QuerySet上調(diào)用`.values()`,不指定任何字段,那么會(huì)返回包含每個(gè)對(duì)象的所有字段及值的字典。

(3. 最后調(diào)用.first()返回第一個(gè)對(duì)象的字段字典。例如,如果Map模型有字段id, name, address,那么它類似于:

{'id': 1,'name': 'John','address': '123 Main St' 
}

如果我們只需要名稱和地址:

Map.objects.all().values('name', 'address').first()

那么得到的是:

{'name': 'John','address': '123 Main St'
}

這可以避免提取整個(gè)對(duì)象然后訪問(wèn)字段,提高效率。所以values()方法非常適合只需要獲取對(duì)象某些字段的值而不需要模型對(duì)象實(shí)例的時(shí)候使用。

?二、Instance

創(chuàng)建一個(gè)對(duì)象：Obj = Model(attr1=val1, attr2=val2)，Obj.save()
更新一個(gè)對(duì)象：Obj = Model.objects.get(id=xxx)，Obj.attr1 = val1，Obj.save()
刪除一個(gè)對(duì)象：Obj = Model.objects.get(id=xxx)，Obj.delete()

Django模型實(shí)例(Instance)表示的是數(shù)據(jù)庫(kù)中一個(gè)模型對(duì)象的一行記錄。它可以完成如下操作:

1. 創(chuàng)建對(duì)象實(shí)例可以通過(guò)Model類直接創(chuàng)建:

obj = Model(attr1=val1, attr2=val2)
obj.save()

或者使用objects管理器的create()方法:

obj = Model.objects.create(attr1=val1, ...)

2. 更新對(duì)象實(shí)例先獲取實(shí)例,修改字段后保存:

obj = Model.objects.get(id=1) 
obj.attr1 = new_value
obj.save()

3. 刪除對(duì)象實(shí)例獲取實(shí)例后調(diào)用delete():

obj = Model.objects.get(id=1)
obj.delete()

所以Django模型實(shí)例表示單個(gè)對(duì)象,主要用于對(duì)象的CRUD操作。它和QuerySet的區(qū)別在于是一個(gè)對(duì)象 VS 一組對(duì)象。

QuerySet 適用于需要查找多個(gè)對(duì)象或進(jìn)行聚合操作的場(chǎng)景，而 Instance 適用于單獨(dú)對(duì)象的創(chuàng)建、修改和刪除操作。

三、APIView（在 view.py 中）

?

?

APIview 是 Django REST Framework 提供的一個(gè)視圖類。它和 Django 中的 view 類有些相似，但是又有一些不同之處。APIview 可以處理基于 HTTP 協(xié)議的請(qǐng)求，并返回基于內(nèi)容協(xié)商的響應(yīng)，它旨在提供一個(gè)易于使用且靈活的方式來(lái)構(gòu)建 API 視圖。

- APIView繼承自Django的View類,提供了許多處理HTTP請(qǐng)求的方法,比如get、post等。

- APIView實(shí)現(xiàn)了內(nèi)容協(xié)商,可以根據(jù)請(qǐng)求頭中的Accept信息自動(dòng)返回JSON或其他格式。

- APIView具有請(qǐng)求解析器,可以解析請(qǐng)求的數(shù)據(jù),并將請(qǐng)求數(shù)據(jù)綁定到請(qǐng)求對(duì)象上。- APIView可以輕松地構(gòu)建基于類的視圖邏輯,通過(guò)繼承和組合來(lái)重用通用邏輯。

- APIView支持基于函數(shù)的視圖行為,可以使用@action裝飾器來(lái)實(shí)現(xiàn)。

- APIView比Django的View類更偏向于構(gòu)建Web API。它提供了對(duì)請(qǐng)求和響應(yīng)的更多控制能力。

- APIView需要與序列化器Serializer配合使用,來(lái)序列化復(fù)雜數(shù)據(jù)。

總結(jié)起來(lái),APIView是一個(gè)專門用來(lái)構(gòu)建Web API的類,它建立在Django的通用View組件之上,提供了對(duì)requests和responses的控制,內(nèi)容協(xié)商等功能,以及對(duì)Serializer的集成,可以更便捷地構(gòu)建靈活的API。?

這里是一個(gè)使用APIView的代碼示例:（可與項(xiàng)目給出的示例做對(duì)比補(bǔ)充）

from rest_framework.views import APIView
from rest_framework.response import Responseclass HelloView(APIView):def get(self, request):content = {'message': 'Hello, World!'}return Response(content)def post(self, request):name = request.data.get('name')content = {'message': 'Hello, {}!'.format(name)}return Response(content)

這個(gè)示例中定義了一個(gè)簡(jiǎn)單的HelloView,繼承自APIView。

- get() 方法處理GET請(qǐng)求,返回一個(gè)字典作為響應(yīng)數(shù)據(jù)。

- post() 方法處理POST請(qǐng)求,從請(qǐng)求數(shù)據(jù)中獲取name參數(shù),返回個(gè)性化的問(wèn)候信息。

- APIView會(huì)自動(dòng)根據(jù)請(qǐng)求方法調(diào)用對(duì)應(yīng)的get或post方法。

- 返回Response對(duì)象,APIView會(huì)處理內(nèi)容協(xié)商,轉(zhuǎn)換數(shù)據(jù)格式。這樣,就可以快速構(gòu)建一個(gè)支持GET/POST的API端點(diǎn)了。我們還可以利用APIView提供的其他功能,比如解析器、身份驗(yàn)證等來(lái)構(gòu)建更強(qiáng)大的API。APIView作為Django REST framework的基礎(chǔ),提供了簡(jiǎn)潔而不失靈活性的API視圖構(gòu)建方式。

# 面向?qū)ο缶幊?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
#### APIViewclass 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):# 從請(qǐng)求數(shù)據(jù)中提取字段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() 方法創(chuàng)建新的商品對(duì)象new_goods = Goods.objects.create(**request_data)# 對(duì)創(chuàng)建的對(duì)象進(jìn)行序列化，并作為響應(yīng)返回serializer = GoodsSerializer(instance=new_goods)return Response(serializer.data)# 面向?qū)ο缶幊蘡lass FilterGoodsCategoryAPI(APIView):# request 表示當(dāng)前的請(qǐng)求對(duì)象# self 表示當(dāng)前實(shí)例對(duì)象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')

實(shí)現(xiàn)了一個(gè)簡(jiǎn)單的商品信息獲取接口。主要邏輯是:

1. 從Goods模型中獲取所有商品對(duì)象數(shù)據(jù)

2. 用GoodsSerializer序列化器對(duì)商品數(shù)據(jù)進(jìn)行序列化

3. 將序列化后的數(shù)據(jù)通過(guò)Response返回這樣就實(shí)現(xiàn)了一個(gè)獲取所有商品信息的API端點(diǎn)。

需要注意的是:

- APIView會(huì)自動(dòng)根據(jù)請(qǐng)求方法調(diào)用對(duì)應(yīng)的方法處理器,如這里的get()來(lái)處理GET請(qǐng)求。

- 數(shù)據(jù)需要序列化后才能作為JSON響應(yīng)返回,這里使用rest_framework的Serializer完成。

- Response包含了內(nèi)容協(xié)商、狀態(tài)碼等響應(yīng)處理功能。

使用APIView的優(yōu)點(diǎn)是:

- 繼承APIView就直接擁有了請(qǐng)求調(diào)度、響應(yīng)處理等功能- 可以通過(guò)面向?qū)ο蟮姆绞浇M織視圖邏輯,擴(kuò)展靈活- 結(jié)合Serializer可以快速實(shí)現(xiàn)序列化與響應(yīng)總之,這是一個(gè)典型的使用APIView構(gòu)建API的示例,利用其提供的封裝與便利性來(lái)簡(jiǎn)化視圖開(kāi)發(fā)。

def post(self, request):# 從請(qǐng)求數(shù)據(jù)中提取字段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"),}

這個(gè)post方法實(shí)現(xiàn)了從請(qǐng)求數(shù)據(jù)中提取需要的參數(shù)來(lái)創(chuàng)建商品的功能。主要邏輯:

1. 從request.data中獲取前端傳來(lái)的各個(gè)字段的數(shù)據(jù)

2. 將獲取到的數(shù)據(jù)保存到一個(gè)字典request_data中

3. request_data中的key就是模型的字段名,value是從請(qǐng)求中獲取到的值

4. 這樣就可以直接用這個(gè)request_data字典來(lái)創(chuàng)建商品實(shí)例:

goods = Goods.objects.create(**request_data)

這種字典參數(shù)的解包語(yǔ)法可以直接把字典的值賦給模型的對(duì)應(yīng)字段。

5. 最后可能需要返回創(chuàng)建好的商品數(shù)據(jù)給前端:

serializer = GoodsSerializer(goods)
return Response(serializer.data)

這樣,我們就可以通過(guò)接受用戶輸入的數(shù)據(jù)來(lái)創(chuàng)建新的商品,并返回結(jié)果。這種從請(qǐng)求中提取參數(shù),然后直接解包傳遞的方式可以簡(jiǎn)化創(chuàng)建對(duì)象的代碼。配合DRF的Serializer來(lái)序列化和響應(yīng)數(shù)據(jù),可以快速構(gòu)建出創(chuàng)建對(duì)象的API。

# 面向?qū)ο缶幊蘡lass FilterGoodsCategoryAPI(APIView):# request 表示當(dāng)前的請(qǐng)求對(duì)象# self 表示當(dāng)前實(shí)例對(duì)象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')

實(shí)現(xiàn)了一個(gè)商品分類過(guò)濾的API視圖,演示了APIView中如何根據(jù)不同的HTTP方法來(lái)處理不同的業(yè)務(wù)邏輯。

主要邏輯:

- 定義了FilterGoodsCategoryAPI類,繼承APIView

- 分別實(shí)現(xiàn)了get(), post(), put()方法來(lái)處理不同的HTTP請(qǐng)求方法

- 在每個(gè)方法內(nèi)部,打印了request.method,用于驗(yàn)證接收到的請(qǐng)求方法

- 然后直接返回字符串'ok'作為響應(yīng)這樣,當(dāng)一個(gè)GET請(qǐng)求發(fā)送到這個(gè)視圖的時(shí)候,會(huì)調(diào)用get()方法,并在終端打印輸出“GET”。對(duì)于POST或PUT請(qǐng)求,也會(huì)分別調(diào)用對(duì)應(yīng)的方法,并打印“POST”或“PUT”。APIView會(huì)自動(dòng)根據(jù)請(qǐng)求方法將不同的請(qǐng)求分發(fā)到對(duì)應(yīng)方法進(jìn)行處理。我們可以在每個(gè)方法內(nèi)實(shí)現(xiàn)真正的業(yè)務(wù)邏輯,比如獲取分類、添加商品等。這種面向?qū)ο蟮念愐晥D可以幫助我們更好地組織代碼,利用APIView的請(qǐng)求分發(fā)來(lái)處理不同的請(qǐng)求與業(yè)務(wù)邏輯。

所以這是一個(gè)使用APIView的典型示例,演示了其根據(jù)請(qǐng)求方法調(diào)度到對(duì)應(yīng)方法的功能。

未完待續(xù)