Python Web後端開發中的增查改刪處理
前言
如果采用前後端分離的架構開發, 後端幾乎不負責任何展現界面的工作,隻負責對數據進行管理 。 數據的管理,主要就是:響應前端的請求, 對數據資源的 增加、修改、刪除、列出 。
一、創建 mgr應用目錄
接口文檔明確說明瞭,這是針對 管理員用戶 的 請求。
前面我們已經為 銷售員
用戶 專門創建瞭一個應用 sales
來處理相關的 請求。
所以,我們可以 再為 管理員
用戶 專門創建一個應用 mgr
來處理相關的 請求 進入根目錄,執行:
python manage.py startapp mgr
此時我們會看見,目錄下已將創建瞭一個mgr的文件夾:
二、添加處理請求模塊 和 url 路由
前面,我們都是在views.py 裡面定義函數,處理 http請求的。 但是可以想象, 以後,這個mgr應用要處理很多類型的http請求。 都用這個views.py
就會讓這個文件非常的龐大, 不好維護。所以,我們可以用不同的 py 文件處理不同類型的http請求。 比如,這裡我們可以新增一個文件 customer.py
, 專門處理 客戶端對 customer
數據的操作。將來如果客戶端有對其他類型數據的操作, 比如 order
數據, 我們就可以添加 orders.py
來處理。 從接口文檔,我們可以發現對資源的增刪改查 操作, 都是同一個URL,都是 /api/mgr/medicine 。
而且我們發現,不同的操作請求,使用不同的 HTTP 請求方法 ,比如 添加是POST, 查詢是 GET, 修改是 PUT, 刪除是 DELETE。且請求的參數中都有 action 參數表明這次請求的操作具體是什麼。 註意: Django 的 url路由
功能 不支持 根據 HTTP 請求的方法 和請求體裡面的參數 進行路由。 就是不能像下面這樣,來根據請求 是 post 還是 get 來 路由:
path('customers/', 'app.views.list_customer', method='get'), path('customers/', 'app.views.add_customer', method='post'),
那麼大傢想想該怎麼辦?
2.1定義函數
一種方式是:自己編寫一個函數, 來 根據 http請求的類型 和請求體裡面的參數 分發(或者說路由)給 不同的函數進行處理。
1.新建customer文件,定義dispatcher函數
我們可以 在 customer.py
中定義如下 dispatcher
函數:
def dispatcher(request): # 將請求參數統一放入request 的 params 屬性中,方便後續處理 # GET請求 參數在url中,同過request 對象的 GET屬性獲取 if request.method == 'GET': request.params = request.GET # POST/PUT/DELETE 請求 參數 從 request 對象的 body 屬性中獲取 elif request.method in ['POST','PUT','DELETE']: # 根據接口,POST/PUT/DELETE 請求的消息體都是 json格式 request.params = json.loads(request.body) # 根據不同的action分派給不同的函數進行處理 action = request.params['action'] if action == 'list_customer': return listcustomers(request) elif action == 'add_customer': return addcustomer(request) elif action == 'modify_customer': return modifycustomer(request) elif action == 'del_customer': return deletecustomer(request) else: return JsonResponse({'ret': 1, 'msg': '不支持該類型http請求'})
首先創建一個custome.py文件:
該函數 把 請求消息中的參數統一放入到 request請求對象的params 屬性中。params 屬性 被 做成一個 dict 類型 , 方便後面的處理函數來獲取消息中的參數。 然後 dispatch函數再根據 請求的 類型 和 action 參數的值 決定由那個函數具體處理該請求消息。比如 action 參數
為 ‘add_customer’
的 請求 就由 addcustomer 函數 進行處理。 當然在文件的開頭,我們需要 先導入 JsonResponse
和 json
的定義,像下面這樣:
from django.http import JsonResponse import json
接下來,根據 API 接口 ,我們發現 凡是 API 請求url為 /api/mgr/customers
的,都屬於 客戶 相關的API, 都應該交由 我們上面定義的dispatch函數進行分派處理。那麼我們需要在Django的url路由文件中加入對應的路由。
2.總路由文件 bysms/urls.py 中定義
我們應該在 總路由文件 bysms/urls.py 中定義瞭如下部分:
# 凡是 url 以 api/mgr 開頭的, # 都根據 mgr.urls 裡面的 子路由表進行路由 path('api/mgr/', include('mgr.urls')),
3.mgr下添加 urls.py 路由文件
在 mgr 目錄下面添加 urls.py 路由文件, 並 加入如下聲明即可, 如下所示:
from django.urls import path from mgr import customer urlpatterns = [ path('customers', customer.dispatcher), ]
這樣,就表示 凡是 API 請求url為 /api/mgr/customers
的,都交由 我們上面定義的dispatch
函數進行分派處理。
三、列出客戶
通常數據資源的 增查改刪 裡面的 查 就是 查看,對應的就是列出數據資源。
根據接口文檔,列出客戶數據接口,後端返回的數據格式如下:
{ "ret": 0, "retlist": [ { "address": "江蘇省常州武進市白雲街44號", "id": 1, "name": "武進市 袁騰飛", "phonenumber": "13886666666" }, { "address": "北京海淀區", "id": 4, "name": "北京海淀區代理 蔡國慶", "phonenumber": "13990123456" } ] }
這裡我們無需 將數據庫中獲取的數據 轉化為 供瀏覽器展示的HTML。 在前後端分離的開發架構中,如何展示數據,那是前端的事情。 我們後端隻需要根據接口文檔, 返回原始數據就行。 我們可以使用如下的函數來返回數據庫的所有的 客戶數據信息:
def listcustomers(request): # 返回一個 QuerySet 對象 ,包含所有的表記錄 qs = Customer.objects.values() # 將 QuerySet 對象 轉化為 list 類型 # 否則不能 被 轉化為 JSON 字符串 retlist = list(qs) return JsonResponse({'ret': 0, 'retlist': retlist})
當然在文件的開頭,我們需要 先導入 Customer 定義,像下面這樣:
# 導入 Customer from common.models import Customer
可以發現,無需轉化數據為HTML, 後端的代碼任務也大大減輕。
四、添加客戶
通常數據資源的 增查改刪 裡面的 增 就是 添加,對應的就是添加數據資源。 根據接口文檔,添加客戶數據接口,前端提供的客戶數據格式如下:
{ "action":"add_customer", "data":{ "name":"武漢市橋西醫院", "phonenumber":"13345679934", "address":"武漢市橋西醫院北路" } }
我們可以使用如下的函數來處理:
def addcustomer(request): info = request.params['data'] # 從請求消息中 獲取要添加客戶的信息 # 並且插入到數據庫中 # 返回值 就是對應插入記錄的對象 record = Customer.objects.create(name=info['name'] , phonenumber=info['phonenumber'] , address=info['address']) return JsonResponse({'ret': 0, 'id':record.id})
Customer.objects.create
方法就可以添加一條Customer
表裡面的記錄。
五、臨時取消 CSRF 校驗
根據接口文檔,添加客戶 請求是個Post請求
POST /網站名/api/mgr/signin HTTP/1.1 Content-Type: application/x-www-form-urlencoded
註意,缺省創建的項目, Django 會啟用一個 CSRF (跨站請求偽造) 安全防護機制。 在這種情況下, 所有的Post、PUT 類型的 請求都必須在HTTP請求頭中攜帶用於校驗的數據。 為瞭簡單起見,我們先臨時取消掉CSRF的 校驗機制
,等以後有需要再打開。 要臨時取消掉CSRF的 校驗機制,非常簡單,隻需要在 項目的配置文件 bysms/settings.py
中 MIDDLEWARE
配置項 裡 註釋掉 ‘django.middleware.csrf.CsrfViewMiddleware’
即可。
六、修改客戶信息
數據資源的 增查改刪 裡面的 改 就是 改動,對應的就是修改數據資源。 根據接口文檔,修改客戶數據接口,前端提供的數據格式如下:
{ "action":"modify_customer", "id": 6, "newdata":{ "name":"武漢市橋北醫院", "phonenumber":"13345678888", "address":"武漢市橋北醫院北路" } }
我們可以使用如下的函數來處理:
def modifycustomer(request): # 從請求消息中 獲取修改客戶的信息 # 找到該客戶,並且進行修改操作 customerid = request.params['id'] newdata = request.params['newdata'] try: # 根據 id 從數據庫中找到相應的客戶記錄 customer = Customer.objects.get(id=customerid) except Customer.DoesNotExist: return { 'ret': 1, 'msg': f'id 為`{customerid}`的客戶不存在' } if 'name' in newdata: customer.name = newdata['name'] if 'phonenumber' in newdata: customer.phonenumber = newdata['phonenumber'] if 'address' in newdata: customer.address = newdata['address'] # 註意,一定要執行save才能將修改信息保存到數據庫 customer.save() return JsonResponse({'ret': 0})
七、刪除客戶
數據資源的 增查改刪 裡面的 刪 就是 刪除,對應的就是刪除數據資源。 根據接口文檔,刪除客戶數據接口,前端隻需要提供要刪除的客戶的ID。
數據格式如下:
{ "action":"del_customer", "id": 6 }
我們可以使用如下的函數來處理:
def deletecustomer(request): customerid = request.params['id'] try: # 根據 id 從數據庫中找到相應的客戶記錄 customer = Customer.objects.get(id=customerid) except Customer.DoesNotExist: return { 'ret': 1, 'msg': f'id 為`{customerid}`的客戶不存在' } # delete 方法就將該記錄從數據庫中刪除瞭 customer.delete() return JsonResponse({'ret': 0})
八、和前端集成
最終我們的產品 前端和後端系統會集成在一起成為一個完整的系統。 部署到生產環境(生產環境就是正式的線上運營環境)運行的架構往往比較復雜。我們在後面有專門的章節講述 一個比較完整的線上環境 如何搭建。
現在,請打開 bysms/urls.py
文件,在末尾 添加一個:
+ static("/", document_root="./z_dist")
並添加如下聲明
# 靜態文件服務 from django.conf.urls.static import static
最終,內容如下:
from django.contrib import admin # 導入一個include函數 from django.urls import path, include # 靜態文件服務 from django.conf.urls.static import static urlpatterns = [ path('admin/', admin.site.urls), # 凡是 url 以 sales/ 開頭的, # 都根據 sales.urls 裡面的 子路由表進行路由 path('sales/', include('sales.urls')), # 凡是 url 以 api/mgr 開頭的, # 都根據 mgr.urls 裡面的 子路由表進行路由 path('api/mgr/', include('mgr.urls')), ] + static("/", document_root="./z_dist")
最後的+ static("/", document_root="./z_dist")
就是在url 路由中加入 前端靜態文件的查找路徑。 這樣如果 http請求的url 不是以 admin/ sales/ api/mgr/ 開頭, Django 就會認為是要訪問 z_dist目錄下面的靜態文件。
好瞭,現在我們 運行如下命令,啟動Django 開發服務器:
python manage.py runserver 0.0.0.0:8080
然後我們打開瀏覽器,輸入如下網址:
http://127.0.0.1:8080/mgr/index.html#/
添加用戶:
這是前端開發的 客戶管理界面,可以在界面上進行客戶的 增查改刪操作, 這些操作會觸發API 請求發送給我們的後端服務。 大傢可以操作一下看看, 後端是否能夠正確的響應。
到此這篇關於Python Web後端開發中的增查改刪處理的文章就介紹到這瞭,更多相關Python 增查改刪處理內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!
推薦閱讀:
- Python3+Django get/post請求實現教程詳解
- Django中url與path及re_path的區別說明
- 如何利用AJAX獲取Django後端數據詳解
- Django前後端分離csrf token獲取方式
- Django框架之路由用法