您好,登錄后才能下訂單哦!
restful怎么在Django中使用?相信很多沒有經驗的人對此束手無策,為此本文總結了問題出現的原因和解決方法,通過這篇文章希望你能解決這個問題。
什么是rest
REST是所有Web應用都應該遵守的架構設計指導原則。
Representational State Transfer,翻譯是”表現層狀態轉化”。
面向資源是REST最明顯的特征,對于同一個資源的一組不同的操作。資源是服務器上一個可命名的抽象概念,資源是以名詞為核心來組織的,首先關注的是名詞。
REST要求,必須通過統一的接口來對資源執行各種操作。對于每個資源只能執行一組有限的操作。
GET用來獲取資源,POST用來新建資源(也可以用于更新資源),PUT(PATCH)用來更新資源,DELETE用來刪除資源。
api定義規范
http://xxx.com/api/
資源
在RESTful架構中,每個網址代表一種資源(resource),所以網址中不能有動詞,只能有名詞,而且所用的名詞往往與數據庫的表格名對應。一般來說,數據庫中的表都是同種記錄的”集合”(collection),所以API中的名詞也應該使用復數。
舉例來說,有一個API提供動物園(zoo)的信息,還包括各種動物和雇員的信息,則它的路徑應該設計成下面這樣。
https://api.example.com/v1/zoos https://api.example.com/v1/animals https://api.example.com/v1/employees
http請求方式
GET(SELECT):從服務器取出資源(一項或多項) POST(CREATE):在服務器新建一個資源 PUT(UPDATE):在服務器更新資源(客戶端提供改變后的完整資源) PATCH(UPDATE):在服務器更新資源(客戶端提供改變的屬性) DELETE(DELETE):從服務器刪除資源
filter過濾
?page=2&per_page=100:指定第幾頁,以及每頁的記錄數。 ?sortby=name&order=asc:指定返回結果按照哪個屬性排序,以及排序順序。 ?animal_type_id=1:指定篩選條件
狀態碼
服務端向用戶返回請求api的結果,在結果中包含了status codes 狀態碼的,可以通過狀態碼去判斷請求api的狀態是成功還是失敗
200 OK - [GET]:服務器成功返回用戶請求的數據,該操作是冪等的(Idempotent)。 201 CREATED - [POST/PUT/PATCH]:用戶新建或修改數據成功。 202 Accepted - [*]:表示一個請求已經進入后臺排隊(異步任務) 204 NO CONTENT - [DELETE]:用戶刪除數據成功。 400 INVALID REQUEST - [POST/PUT/PATCH]:用戶發出的請求有錯誤,服務器沒有進行新建或修改數據的操作,該操作是冪等的。 401 Unauthorized - [*]:表示用戶沒有權限(令牌、用戶名、密碼錯誤)。 403 Forbidden - [*] 表示用戶得到授權(與401錯誤相對),但是訪問是被禁止的。 404 NOT FOUND - [*]:用戶發出的請求針對的是不存在的記錄,服務器沒有進行操作,該操作是冪等的。 406 Not Acceptable - [GET]:用戶請求的格式不可得(比如用戶請求JSON格式,但是只有XML格式)。 410 Gone -[GET]:用戶請求的資源被永久刪除,且不會再得到的。 422 Unprocesable entity - [POST/PUT/PATCH] 當創建一個對象時,發生一個驗證錯誤。 500 INTERNAL SERVER ERROR - [*]:服務器發生錯誤,用戶將無法判斷發出的請求是否成功。
具體用法
更多的需要配合postman 因此需要下載一個postman,方便更多的操作
https://www.getpostman.com/apps
使用之前安裝模塊
pip install djangorestframework pip install django-filter
在setting.py中加入參數
INSTALLED_APPS中加入'rest_framework',
在app中創建一個py文件——序列化文件
比如serializers.py然后寫入restful
from rest_framework import serializers from stu.models import Student(導入自己寫的app、models) class StudentSerializer(serializers.ModelSerializer): class Meta: # 關聯數據表(前面不是變量名) model = Student # 確定需要序列化的字段(返回給用戶的具體表中的字段)(前面不是變量名) fields = ['id', 's_name', 's_tel'] def to_representation(self, instance): data = super().to_representation(instance) try: # 得到關聯表中的字段,必須用try,否則如果存在一個沒有定義i_addr的學生時,系統將報錯 data['s_addr'] = instance.studentinfo.i_addr except Exception as e: data['s_addr'] = '' return data
在app中views中創建類
from rest_framework import mixins,viewsets from stu.serializers import StudentSerializer from stu.models import Student class StudentEdit(mixins.ListModelMixin,# 表示可以在Postman類似的軟件中只能查找所有數據 viewsets.GenericViewSet, mixins.RetrieveModelMixin, # 表示可以在Postman類似的軟件中只能查找單一數據 mixins.UpdateModelMixin, # 表示可以在Postman類似的軟件中更新數據 mixins.DestroyModelMixin, # 表示可以在Postman類似的軟件中刪除數據 mixins.CreateModelMixin): # 表示可以在Postman類似的軟件中創建數據 # 查詢所有信息 queryset = Student.objects.all() # 序列化 serializer_class = StudentSerializer
創建urls
這里同時展示了urls不一定每次都寫入進去可以用+=添加進去
注意這里寫的urls不要加‘/'他會自動加載
from stu import views from rest_framework.routers import SimpleRouter router = SimpleRouter() router.register(r'student', views.StudentEdit) urlpatterns = [ # 其他url ] urlpatterns += router.urls #這里表示添加定義的url
對應的方法
在postman中選入某個參數然后傳入某個urls即可
增: POST http://127.0.0.1:8080/stu/addStu/1/ 刪: DELETE http://127.0.0.1:8080/stu/addStu/1/ 改: UPDATE http://127.0.0.1:8080/stu/addStu/1/ 查: GET http://127.0.0.1:8080/stu/addStu/1
看完上述內容,你們掌握restful怎么在Django中使用的方法了嗎?如果還想學到更多技能或想了解更多相關內容,歡迎關注億速云行業資訊頻道,感謝各位的閱讀!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。