Django Ajax、批量操作與分頁實踐本章介紹不刷新整頁的異步請求、文件上傳、批量寫入、JSON 序列化和分頁。它們共同服務(wù)于更流暢的交互體驗但仍必須遵循 HTTP 方法、CSRF、防護、數(shù)據(jù)校驗和數(shù)據(jù)庫性能等基本規(guī)則。一、Ajax 的作用與請求邊界AjaxAsynchronous JavaScript and XML是瀏覽器通過 JavaScript 主動發(fā)起 HTTP 請求、拿到結(jié)果后僅更新局部頁面的技術(shù)集合。現(xiàn)代請求通常傳輸 JSON 或表單數(shù)據(jù)而不是 XML。Ajax 不等于“沒有頁面跳轉(zhuǎn)”而是由前端決定如何處理服務(wù)器響應(yīng)。方式觸發(fā)方式常見結(jié)果地址欄、a瀏覽器導(dǎo)航整頁加載新的頁面form原生提交GET 或 POST瀏覽器按響應(yīng)導(dǎo)航或刷新Ajax / FetchJavaScript 調(diào)用前端根據(jù)響應(yīng)局部更新頁面Ajax 仍然是普通 HTTP 請求GET 用于讀取POST/PUT/PATCH/DELETE 用于改變數(shù)據(jù)。后端必須像處理普通表單一樣完成認證、權(quán)限和輸入校驗。二、返回 JSON使用 JsonResponse瀏覽器與 Django 之間交換結(jié)構(gòu)化數(shù)據(jù)時JSON 是最常用格式。Python 字典不是 JSON 字符串推薦使用JsonResponse自動序列化并設(shè)置application/json響應(yīng)頭。# user/views.pyfromdjango.httpimportJsonResponsefromdjango.viewsimportViewclassRegisterView(View):defget(self,request,*args,**kwargs):returnrender(request,user/register.html)defpost(self,request,*args,**kwargs):usernamerequest.POST.get(username,).strip()passwordrequest.POST.get(password,)ifnotusernameornotpassword:returnJsonResponse({ok:False,error:用戶名和密碼不能為空,},status400)# 此處應(yīng)使用 Django 認證系統(tǒng)處理密碼不能明文保存。returnJsonResponse({ok:True,message:注冊成功},status201)代碼說明JSON 響應(yīng)建議使用統(tǒng)一字段例如ok、data、error并配合合適 HTTP 狀態(tài)碼。不要用HttpResponse(dict)直接返回字典若手動使用json.dumps()還需自行正確設(shè)置content_type。三、jQuery Ajax 提交普通表單數(shù)據(jù)jQuery 的$.ajax()傳入普通對象時默認以application/x-www-form-urlencoded形式編碼因此 Django 可從request.POST讀取數(shù)據(jù)。它并不會自動發(fā)送 JSON。POST 請求必須攜帶 Django 的 CSRF Token。模板中先輸出{% csrf_token %}再從隱藏輸入框讀取令牌并放入請求頭是較清晰的做法。!-- user/templates/user/register.html --{% load static %}scriptsrc{% static js/jquery.min.js %}/scriptformidregister-form{% csrf_token %}label用戶名inputidusernamenameusernamerequired/labellabel密碼inputidpasswordnamepasswordtypepasswordrequired/labelbuttonidsubmit-buttontypesubmit注冊/button/formpidmessagerolestatus/p$(#register-form).on(submit,function(event){event.preventDefault();constcsrfToken$([namecsrfmiddlewaretoken]).val();$.ajax({url:window.location.pathname,type:POST,data:{username:$(#username).val(),password:$(#password).val(),},headers:{X-CSRFToken:csrfToken},dataType:json,}).done(function(data){$(#message).text(data.message);}).fail(function(xhr){constmessagexhr.responseJSON?.error||請求失敗請稍后重試;$(#message).text(message);});});代碼說明dataType: json表示期望服務(wù)端響應(yīng)是 JSON并不會改變請求體編碼。表單提交事件中調(diào)用event.preventDefault()可以阻止瀏覽器原生整頁提交。success回調(diào)只處理成功狀態(tài)使用.fail()或error回調(diào)才能處理 4xx/5xx 響應(yīng)。發(fā)送 JSON 請求體當 API 明確約定使用 JSON 時應(yīng)把對象序列化為字符串設(shè)置contentType: application/json并在 Django 中從request.body讀取和解析。$.ajax({url:/api/calculate/,type:POST,contentType:application/json,dataType:json,headers:{X-CSRFToken:$([namecsrfmiddlewaretoken]).val()},data:JSON.stringify({number_one:12,number_two:3,operator:}),});importjsonfromdjango.httpimportJsonResponsedefcalculate(request):try:payloadjson.loads(request.body)leftfloat(payload[number_one])rightfloat(payload[number_two])except(KeyError,TypeError,ValueError,json.JSONDecodeError):returnJsonResponse({ok:False,error:參數(shù)格式錯誤},status400)operatorpayload.get(operator)operations{:lambda:leftright,-:lambda:left-right,*:lambda:left*right,/:lambda:left/rightifright!0elseNone,}ifoperatornotinoperations:returnJsonResponse({ok:False,error:不支持的運算符},status400)resultoperations[operator]()ifresultisNone:returnJsonResponse({ok:False,error:除數(shù)不能為 0},status400)returnJsonResponse({ok:True,result:result})代碼說明解析 JSON 時應(yīng)捕獲格式錯誤并驗證數(shù)據(jù)類型。涉及金額時不要使用float應(yīng)使用Decimal此處僅用于簡單計算示例。四、Ajax 上傳文件FormData文件不能作為普通對象字段可靠地發(fā)送。瀏覽器需要用FormData生成multipart/form-data請求體Django 則從request.FILES讀取上傳文件文本字段仍在request.POST。formidavatar-form{% csrf_token %}label用戶名inputidusernamenameusername/labellabel頭像inputidavatarnameavatartypefileacceptimage/*/labelbuttontypesubmit上傳/button/formpidupload-messagerolestatus/p$(#avatar-form).on(submit,function(event){event.preventDefault();constformDatanewFormData(this);$.ajax({url:window.location.pathname,type:POST,data:formData,processData:false,contentType:false,headers:{X-CSRFToken:$([namecsrfmiddlewaretoken]).val()},dataType:json,}).done((data)$(#upload-message).text(data.message)).fail((xhr)$(#upload-message).text(xhr.responseJSON?.error||上傳失敗));});fromdjango.httpimportJsonResponsedefupload_avatar(request):ifrequest.method!POST:returnJsonResponse({error:僅支持 POST},status405)avatarrequest.FILES.get(avatar)ifavatarisNone:returnJsonResponse({ok:False,error:請選擇文件},status400)ifavatar.size5*1024*1024:returnJsonResponse({ok:False,error:文件不能超過 5 MB},status400)# 還應(yīng)校驗真實內(nèi)容、擴展名和權(quán)限并使用受控存儲后端保存。returnJsonResponse({ok:True,message:文件已接收})代碼說明processData: false防止 jQuery 將FormData轉(zhuǎn)成查詢字符串contentType: false讓瀏覽器自動生成帶邊界的 multipart 請求頭。不要試圖讀取文件輸入框的.val()作為真實路徑瀏覽器會刻意隱藏本地路徑。request.is_ajax()已在 Django 3.1 棄用并在后續(xù)版本移除不應(yīng)使用它判斷請求類型。若業(yè)務(wù)確實需要特定標記可以檢查自定義請求頭但接口應(yīng)以響應(yīng)格式和 HTTP 約定為準而不是把“是否 Ajax”作為安全邊界。五、確認彈窗與安全刪除確認彈窗只能改善用戶體驗不能代替后端權(quán)限校驗。刪除操作必須使用 POST 或 DELETE不能使用 GET因為 GET 應(yīng)保持安全且冪等不應(yīng)改變服務(wù)器數(shù)據(jù)。tableidbook-tabletrdata-book-id1td西游記/tdtdbuttonclassdelete-booktypebutton刪除/button/td/tr/table$(#book-table).on(click,.delete-book,function(){constrow$(this).closest(tr);constbookIdrow.data(book-id);if(!window.confirm(確定刪除這本書嗎)){return;}$.ajax({url:/books/${bookId}/delete/,type:POST,headers:{X-CSRFToken:$([namecsrfmiddlewaretoken]).val()},dataType:json,}).done(function(data){if(data.ok)row.remove();}).fail(function(xhr){alert(xhr.responseJSON?.error||刪除失敗);});});fromdjango.contrib.auth.decoratorsimportlogin_requiredfromdjango.httpimportJsonResponsefromdjango.views.decorators.httpimportrequire_POSTfrom.modelsimportBooklogin_requiredrequire_POSTdefdelete_book(request,book_id):bookBook.objects.filter(pkbook_id).first()ifbookisNone:returnJsonResponse({ok:False,error:圖書不存在},status404)# 此處還應(yīng)校驗 request.user 是否有刪除該圖書的權(quán)限。book.delete()returnJsonResponse({ok:True})代碼說明頁面中重復(fù)項應(yīng)使用 class 而不是重復(fù)的 id。事件委托綁定到表格父元素即使后續(xù)動態(tài)添加按鈕也能響應(yīng)點擊。SweetAlert、layer 等組件可以替代window.confirm()但后端的登錄、權(quán)限、CSRF 和請求方法限制始終不可省略。六、批量插入bulk_create()逐條調(diào)用create()會執(zhí)行大量 INSERT 語句導(dǎo)入大量數(shù)據(jù)時bulk_create()可以顯著減少數(shù)據(jù)庫往返次數(shù)。它應(yīng)使用分批寫入避免一次性創(chuàng)建過多 Python 對象或超出數(shù)據(jù)庫參數(shù)限制。fromdecimalimportDecimalfromdjango.dbimporttransactionfrom.modelsimportBookdefimport_books(rows):batch_size1000batch[]withtransaction.atomic():forindex,rowinenumerate(rows,start1):batch.append(Book(namerow[name],priceDecimal(str(row[price])),))iflen(batch)batch_size:Book.objects.bulk_create(batch,batch_sizebatch_size)batch.clear()ifbatch:Book.objects.bulk_create(batch,batch_sizebatch_size)代碼說明bulk_create()通常不會調(diào)用每個對象的save()也不會發(fā)送pre_save、post_save信號依賴這些鉤子的業(yè)務(wù)邏輯需要額外處理。示例使用Decimal(str(...))避免浮點數(shù)精度問題。百萬級數(shù)據(jù)導(dǎo)入還應(yīng)考慮后臺任務(wù)、進度反饋、失敗重試和數(shù)據(jù)庫鎖影響不能直接阻塞普通 Web 請求。七、把 QuerySet 序列化為 JSON模型實例和QuerySet不能直接交給JsonResponse。接口應(yīng)明確選擇要公開的字段轉(zhuǎn)換為基礎(chǔ)數(shù)據(jù)類型后再返回這樣既能控制響應(yīng)結(jié)構(gòu)也能避免泄露敏感字段。fromdjango.httpimportJsonResponsefrom.modelsimportBookdefbook_list_api(request):bookslist(Book.objects.values(id,name,price)[:100])returnJsonResponse({results:books})代碼說明values()返回字典形式的QuerySetlist()觸發(fā)查詢并得到可 JSON 序列化的列表。返回對象包一層results可在以后添加分頁、統(tǒng)計信息或錯誤字段而不破壞接口結(jié)構(gòu)。django.core.serializers.serialize(json, queryset)也可將模型序列化為 JSON但輸出結(jié)構(gòu)包含模型標簽、主鍵和fields嵌套通常不適合作為面向前端的穩(wěn)定 API。復(fù)雜 API 更適合使用 Django REST Framework 的 Serializer 明確控制字段和驗證規(guī)則。八、分頁使用 Django Paginator分頁避免一次性向數(shù)據(jù)庫和頁面加載所有記錄。最基礎(chǔ)的切片公式是第page頁、每頁per_page條數(shù)據(jù)對應(yīng)[ (page - 1) * per_page : page * per_page ]。但業(yè)務(wù)項目應(yīng)優(yōu)先使用 Django 的Paginator它處理頁碼、總頁數(shù)、邊界與異常更可靠。fromdjango.core.paginatorimportEmptyPage,PageNotAnInteger,Paginatorfromdjango.shortcutsimportrenderfrom.modelsimportBookdefbook_list(request):booksBook.objects.order_by(id)paginatorPaginator(books,20)page_numberrequest.GET.get(page,1)try:page_objpaginator.page(page_number)exceptPageNotAnInteger:page_objpaginator.page(1)exceptEmptyPage:page_objpaginator.page(paginator.num_pages)returnrender(request,book/list.html,{page_obj:page_obj})!-- book/templates/book/list.html --ul{% for book in page_obj.object_list %}li{{ book.name }} - {{ book.price }}/li{% empty %}li暫無圖書/li{% endfor %}/ulnavaria-label圖書分頁ulclasspagination{% if page_obj.has_previous %}liahref?page1首頁/a/liliahref?page{{ page_obj.previous_page_number }}上一頁/a/li{% endif %} {% for page in page_obj.paginator.get_elided_page_range %} {% if page page_obj.paginator.ELLIPSIS %}liclassdisabledspan{{ page }}/span/li{% elif page page_obj.number %}liclassactivespan{{ page }}/span/li{% else %}liahref?page{{ page }}{{ page }}/a/li{% endif %} {% endfor %} {% if page_obj.has_next %}liahref?page{{ page_obj.next_page_number }}下一頁/a/liliahref?page{{ page_obj.paginator.num_pages }}尾頁/a/li{% endif %}/ul/nav代碼說明Paginator會對QuerySet做切片從而生成帶LIMIT和OFFSET的查詢。get_elided_page_range可在頁數(shù)很多時顯示省略號避免模板手寫大量嵌套判斷。深頁碼的 OFFSET 查詢在超大表上可能變慢這時應(yīng)考慮基于游標或主鍵的“鍵集分頁”。九、實踐要點Ajax 請求仍是 HTTP 請求后端必須校驗方法、權(quán)限、CSRF 與輸入數(shù)據(jù)。jQuery 普通對象默認發(fā)的是表單編碼發(fā)送 JSON 時需JSON.stringify()和contentType: application/json。上傳文件使用FormData文件從request.FILES讀取并在服務(wù)端限制大小、類型和存儲位置。所有刪除、創(chuàng)建和更新操作使用非 GET 方法確認彈窗不能替代服務(wù)器權(quán)限控制。大批量寫入分批bulk_create()理解它不會觸發(fā)save()和模型信號。接口只返回必要字段分頁優(yōu)先使用Paginator而不是拼接帶safe的 HTML 字符串。掌握這些做法后頁面交互、數(shù)據(jù)導(dǎo)入和列表展示可以在保持響應(yīng)速度的同時維持清晰的安全與維護邊界。 Django Ajax、批量操作與分頁實踐
Django Ajax、批量操作與分頁實踐本章介紹不刷新整頁的異步請求、文件上傳、批量寫入、JSON 序列化和分頁。它們共同服務(wù)于更流暢的交互體驗但仍必須遵循 HTTP 方法、CSRF、防護、數(shù)據(jù)校驗和數(shù)據(jù)庫性能等基本規(guī)則。一、Ajax 的作用與請求邊界AjaxAsynchronous JavaScript and XML是瀏覽器通過 JavaScript 主動發(fā)起 HTTP 請求、拿到結(jié)果后僅更新局部頁面的技術(shù)集合。現(xiàn)代請求通常傳輸 JSON 或表單數(shù)據(jù)而不是 XML。Ajax 不等于“沒有頁面跳轉(zhuǎn)”而是由前端決定如何處理服務(wù)器響應(yīng)。方式觸發(fā)方式常見結(jié)果地址欄、a瀏覽器導(dǎo)航整頁加載新的頁面form原生提交GET 或 POST瀏覽器按響應(yīng)導(dǎo)航或刷新Ajax / FetchJavaScript 調(diào)用前端根據(jù)響應(yīng)局部更新頁面Ajax 仍然是普通 HTTP 請求GET 用于讀取POST/PUT/PATCH/DELETE 用于改變數(shù)據(jù)。后端必須像處理普通表單一樣完成認證、權(quán)限和輸入校驗。二、返回 JSON使用 JsonResponse瀏覽器與 Django 之間交換結(jié)構(gòu)化數(shù)據(jù)時JSON 是最常用格式。Python 字典不是 JSON 字符串推薦使用JsonResponse自動序列化并設(shè)置application/json響應(yīng)頭。# user/views.pyfromdjango.httpimportJsonResponsefromdjango.viewsimportViewclassRegisterView(View):defget(self,request,*args,**kwargs):returnrender(request,user/register.html)defpost(self,request,*args,**kwargs):usernamerequest.POST.get(username,).strip()passwordrequest.POST.get(password,)ifnotusernameornotpassword:returnJsonResponse({ok:False,error:用戶名和密碼不能為空,},status400)# 此處應(yīng)使用 Django 認證系統(tǒng)處理密碼不能明文保存。returnJsonResponse({ok:True,message:注冊成功},status201)代碼說明JSON 響應(yīng)建議使用統(tǒng)一字段例如ok、data、error并配合合適 HTTP 狀態(tài)碼。不要用HttpResponse(dict)直接返回字典若手動使用json.dumps()還需自行正確設(shè)置content_type。三、jQuery Ajax 提交普通表單數(shù)據(jù)jQuery 的$.ajax()傳入普通對象時默認以application/x-www-form-urlencoded形式編碼因此 Django 可從request.POST讀取數(shù)據(jù)。它并不會自動發(fā)送 JSON。POST 請求必須攜帶 Django 的 CSRF Token。模板中先輸出{% csrf_token %}再從隱藏輸入框讀取令牌并放入請求頭是較清晰的做法。!-- user/templates/user/register.html --{% load static %}scriptsrc{% static js/jquery.min.js %}/scriptformidregister-form{% csrf_token %}label用戶名inputidusernamenameusernamerequired/labellabel密碼inputidpasswordnamepasswordtypepasswordrequired/labelbuttonidsubmit-buttontypesubmit注冊/button/formpidmessagerolestatus/p$(#register-form).on(submit,function(event){event.preventDefault();constcsrfToken$([namecsrfmiddlewaretoken]).val();$.ajax({url:window.location.pathname,type:POST,data:{username:$(#username).val(),password:$(#password).val(),},headers:{X-CSRFToken:csrfToken},dataType:json,}).done(function(data){$(#message).text(data.message);}).fail(function(xhr){constmessagexhr.responseJSON?.error||請求失敗請稍后重試;$(#message).text(message);});});代碼說明dataType: json表示期望服務(wù)端響應(yīng)是 JSON并不會改變請求體編碼。表單提交事件中調(diào)用event.preventDefault()可以阻止瀏覽器原生整頁提交。success回調(diào)只處理成功狀態(tài)使用.fail()或error回調(diào)才能處理 4xx/5xx 響應(yīng)。發(fā)送 JSON 請求體當 API 明確約定使用 JSON 時應(yīng)把對象序列化為字符串設(shè)置contentType: application/json并在 Django 中從request.body讀取和解析。$.ajax({url:/api/calculate/,type:POST,contentType:application/json,dataType:json,headers:{X-CSRFToken:$([namecsrfmiddlewaretoken]).val()},data:JSON.stringify({number_one:12,number_two:3,operator:}),});importjsonfromdjango.httpimportJsonResponsedefcalculate(request):try:payloadjson.loads(request.body)leftfloat(payload[number_one])rightfloat(payload[number_two])except(KeyError,TypeError,ValueError,json.JSONDecodeError):returnJsonResponse({ok:False,error:參數(shù)格式錯誤},status400)operatorpayload.get(operator)operations{:lambda:leftright,-:lambda:left-right,*:lambda:left*right,/:lambda:left/rightifright!0elseNone,}ifoperatornotinoperations:returnJsonResponse({ok:False,error:不支持的運算符},status400)resultoperations[operator]()ifresultisNone:returnJsonResponse({ok:False,error:除數(shù)不能為 0},status400)returnJsonResponse({ok:True,result:result})代碼說明解析 JSON 時應(yīng)捕獲格式錯誤并驗證數(shù)據(jù)類型。涉及金額時不要使用float應(yīng)使用Decimal此處僅用于簡單計算示例。四、Ajax 上傳文件FormData文件不能作為普通對象字段可靠地發(fā)送。瀏覽器需要用FormData生成multipart/form-data請求體Django 則從request.FILES讀取上傳文件文本字段仍在request.POST。formidavatar-form{% csrf_token %}label用戶名inputidusernamenameusername/labellabel頭像inputidavatarnameavatartypefileacceptimage/*/labelbuttontypesubmit上傳/button/formpidupload-messagerolestatus/p$(#avatar-form).on(submit,function(event){event.preventDefault();constformDatanewFormData(this);$.ajax({url:window.location.pathname,type:POST,data:formData,processData:false,contentType:false,headers:{X-CSRFToken:$([namecsrfmiddlewaretoken]).val()},dataType:json,}).done((data)$(#upload-message).text(data.message)).fail((xhr)$(#upload-message).text(xhr.responseJSON?.error||上傳失敗));});fromdjango.httpimportJsonResponsedefupload_avatar(request):ifrequest.method!POST:returnJsonResponse({error:僅支持 POST},status405)avatarrequest.FILES.get(avatar)ifavatarisNone:returnJsonResponse({ok:False,error:請選擇文件},status400)ifavatar.size5*1024*1024:returnJsonResponse({ok:False,error:文件不能超過 5 MB},status400)# 還應(yīng)校驗真實內(nèi)容、擴展名和權(quán)限并使用受控存儲后端保存。returnJsonResponse({ok:True,message:文件已接收})代碼說明processData: false防止 jQuery 將FormData轉(zhuǎn)成查詢字符串contentType: false讓瀏覽器自動生成帶邊界的 multipart 請求頭。不要試圖讀取文件輸入框的.val()作為真實路徑瀏覽器會刻意隱藏本地路徑。request.is_ajax()已在 Django 3.1 棄用并在后續(xù)版本移除不應(yīng)使用它判斷請求類型。若業(yè)務(wù)確實需要特定標記可以檢查自定義請求頭但接口應(yīng)以響應(yīng)格式和 HTTP 約定為準而不是把“是否 Ajax”作為安全邊界。五、確認彈窗與安全刪除確認彈窗只能改善用戶體驗不能代替后端權(quán)限校驗。刪除操作必須使用 POST 或 DELETE不能使用 GET因為 GET 應(yīng)保持安全且冪等不應(yīng)改變服務(wù)器數(shù)據(jù)。tableidbook-tabletrdata-book-id1td西游記/tdtdbuttonclassdelete-booktypebutton刪除/button/td/tr/table$(#book-table).on(click,.delete-book,function(){constrow$(this).closest(tr);constbookIdrow.data(book-id);if(!window.confirm(確定刪除這本書嗎)){return;}$.ajax({url:/books/${bookId}/delete/,type:POST,headers:{X-CSRFToken:$([namecsrfmiddlewaretoken]).val()},dataType:json,}).done(function(data){if(data.ok)row.remove();}).fail(function(xhr){alert(xhr.responseJSON?.error||刪除失敗);});});fromdjango.contrib.auth.decoratorsimportlogin_requiredfromdjango.httpimportJsonResponsefromdjango.views.decorators.httpimportrequire_POSTfrom.modelsimportBooklogin_requiredrequire_POSTdefdelete_book(request,book_id):bookBook.objects.filter(pkbook_id).first()ifbookisNone:returnJsonResponse({ok:False,error:圖書不存在},status404)# 此處還應(yīng)校驗 request.user 是否有刪除該圖書的權(quán)限。book.delete()returnJsonResponse({ok:True})代碼說明頁面中重復(fù)項應(yīng)使用 class 而不是重復(fù)的 id。事件委托綁定到表格父元素即使后續(xù)動態(tài)添加按鈕也能響應(yīng)點擊。SweetAlert、layer 等組件可以替代window.confirm()但后端的登錄、權(quán)限、CSRF 和請求方法限制始終不可省略。六、批量插入bulk_create()逐條調(diào)用create()會執(zhí)行大量 INSERT 語句導(dǎo)入大量數(shù)據(jù)時bulk_create()可以顯著減少數(shù)據(jù)庫往返次數(shù)。它應(yīng)使用分批寫入避免一次性創(chuàng)建過多 Python 對象或超出數(shù)據(jù)庫參數(shù)限制。fromdecimalimportDecimalfromdjango.dbimporttransactionfrom.modelsimportBookdefimport_books(rows):batch_size1000batch[]withtransaction.atomic():forindex,rowinenumerate(rows,start1):batch.append(Book(namerow[name],priceDecimal(str(row[price])),))iflen(batch)batch_size:Book.objects.bulk_create(batch,batch_sizebatch_size)batch.clear()ifbatch:Book.objects.bulk_create(batch,batch_sizebatch_size)代碼說明bulk_create()通常不會調(diào)用每個對象的save()也不會發(fā)送pre_save、post_save信號依賴這些鉤子的業(yè)務(wù)邏輯需要額外處理。示例使用Decimal(str(...))避免浮點數(shù)精度問題。百萬級數(shù)據(jù)導(dǎo)入還應(yīng)考慮后臺任務(wù)、進度反饋、失敗重試和數(shù)據(jù)庫鎖影響不能直接阻塞普通 Web 請求。七、把 QuerySet 序列化為 JSON模型實例和QuerySet不能直接交給JsonResponse。接口應(yīng)明確選擇要公開的字段轉(zhuǎn)換為基礎(chǔ)數(shù)據(jù)類型后再返回這樣既能控制響應(yīng)結(jié)構(gòu)也能避免泄露敏感字段。fromdjango.httpimportJsonResponsefrom.modelsimportBookdefbook_list_api(request):bookslist(Book.objects.values(id,name,price)[:100])returnJsonResponse({results:books})代碼說明values()返回字典形式的QuerySetlist()觸發(fā)查詢并得到可 JSON 序列化的列表。返回對象包一層results可在以后添加分頁、統(tǒng)計信息或錯誤字段而不破壞接口結(jié)構(gòu)。django.core.serializers.serialize(json, queryset)也可將模型序列化為 JSON但輸出結(jié)構(gòu)包含模型標簽、主鍵和fields嵌套通常不適合作為面向前端的穩(wěn)定 API。復(fù)雜 API 更適合使用 Django REST Framework 的 Serializer 明確控制字段和驗證規(guī)則。八、分頁使用 Django Paginator分頁避免一次性向數(shù)據(jù)庫和頁面加載所有記錄。最基礎(chǔ)的切片公式是第page頁、每頁per_page條數(shù)據(jù)對應(yīng)[ (page - 1) * per_page : page * per_page ]。但業(yè)務(wù)項目應(yīng)優(yōu)先使用 Django 的Paginator它處理頁碼、總頁數(shù)、邊界與異常更可靠。fromdjango.core.paginatorimportEmptyPage,PageNotAnInteger,Paginatorfromdjango.shortcutsimportrenderfrom.modelsimportBookdefbook_list(request):booksBook.objects.order_by(id)paginatorPaginator(books,20)page_numberrequest.GET.get(page,1)try:page_objpaginator.page(page_number)exceptPageNotAnInteger:page_objpaginator.page(1)exceptEmptyPage:page_objpaginator.page(paginator.num_pages)returnrender(request,book/list.html,{page_obj:page_obj})!-- book/templates/book/list.html --ul{% for book in page_obj.object_list %}li{{ book.name }} - {{ book.price }}/li{% empty %}li暫無圖書/li{% endfor %}/ulnavaria-label圖書分頁ulclasspagination{% if page_obj.has_previous %}liahref?page1首頁/a/liliahref?page{{ page_obj.previous_page_number }}上一頁/a/li{% endif %} {% for page in page_obj.paginator.get_elided_page_range %} {% if page page_obj.paginator.ELLIPSIS %}liclassdisabledspan{{ page }}/span/li{% elif page page_obj.number %}liclassactivespan{{ page }}/span/li{% else %}liahref?page{{ page }}{{ page }}/a/li{% endif %} {% endfor %} {% if page_obj.has_next %}liahref?page{{ page_obj.next_page_number }}下一頁/a/liliahref?page{{ page_obj.paginator.num_pages }}尾頁/a/li{% endif %}/ul/nav代碼說明Paginator會對QuerySet做切片從而生成帶LIMIT和OFFSET的查詢。get_elided_page_range可在頁數(shù)很多時顯示省略號避免模板手寫大量嵌套判斷。深頁碼的 OFFSET 查詢在超大表上可能變慢這時應(yīng)考慮基于游標或主鍵的“鍵集分頁”。九、實踐要點Ajax 請求仍是 HTTP 請求后端必須校驗方法、權(quán)限、CSRF 與輸入數(shù)據(jù)。jQuery 普通對象默認發(fā)的是表單編碼發(fā)送 JSON 時需JSON.stringify()和contentType: application/json。上傳文件使用FormData文件從request.FILES讀取并在服務(wù)端限制大小、類型和存儲位置。所有刪除、創(chuàng)建和更新操作使用非 GET 方法確認彈窗不能替代服務(wù)器權(quán)限控制。大批量寫入分批bulk_create()理解它不會觸發(fā)save()和模型信號。接口只返回必要字段分頁優(yōu)先使用Paginator而不是拼接帶safe的 HTML 字符串。掌握這些做法后頁面交互、數(shù)據(jù)導(dǎo)入和列表展示可以在保持響應(yīng)速度的同時維持清晰的安全與維護邊界。