drf-router和authenticate認證源碼分析
一、路由Routers
在 Rest Framework 中提供瞭兩個 router , 可以幫助我們快速的實現路由的自動生成。
必須是繼承 ModelViewSet 的視圖類才能自動生成路由
SimpleRouter
使用方法:
urls.py
# 第一步:導入routers模塊 from rest_framework import routers # 第二步:實例化得到對象 router = routers.SimpleRouter() # 第三步:註冊( register('前綴', viewset視圖集, 路由的別名) ) router.register('books', views.BooksViewset) # 第四步:生成路由加入到原路由中 # 方式一: urlpatterns = [ ... ] urlpatterns += router.urls # 方式二: urlpatterns = [ ... url(r'^', include(router.urls)) ] # 形成路由如下 <URLPattern '^books/$' [name='books-list']> <URLPattern '^books/(?P<pk>[^/.]+)/$' [name='books-detail']>
DefaultRouter
DefaultRouter與SimpleRouter的區別是,DefaultRouter會多附帶一個默認的API根視圖,返回一個包含所有列表視圖的超鏈接響應數據。
# 前兩條和SimpleRouter一樣 <URLPattern '^books/$' [name='books-list']> <URLPattern '^books/(?P<pk>[^/.]+)/$' [name='books-detail']> # 效果也和前兩條類似, # 如:http://127.0.0.1:8000/books.json <URLPattern '^books\.(?P<format>[a-z0-9]+)/?$' [name='books-list']> # http://127.0.0.1:8000/books/1.json <URLPattern '^books/(?P<pk>[^/.]+)\.(?P<format>[a-z0-9]+)/?$' [name='books-detail']> # 多瞭個根路由http://127.0.0.1:8000/ <URLPattern '^$' [name='api-root']>, <URLPattern '^\.(?P<format>[a-z0-9]+)/?$' [name='api-root']>
action的使用
action是為瞭給繼承自 ModelViewSet 的視圖類中自定義的函數也添加路由
例如下面這樣:
from rest_framework.viewsets import ModelViewSet from rest_framework.response import Response from app01.ser import BooksSerializers from app01.models import Books class BooksViewSet(ModelViewSet): queryset = Books.objects.all() serializer_class = BooksSerializers # 這種方法不會自動生成,需要用action配置 def get_num(self, request, pk): book = self.get_queryset()[:int(pk)] ser = self.get_serializer(book, many=True) return Response(ser.data)
使用示例:
action是一個裝飾器,放在被裝飾的函數上方,
method:請求方式
detail:是否帶pk ——>True 表示路徑格式是xxx/<pk>/action方法名/
——False 表示路徑格式是xxx/action方法名/
from rest_framework.viewsets import ModelViewSet from rest_framework.response import Response from rest_framework.decorators import action from app01.ser import BooksSerializers from app01.models import Books class BooksViewSet(ModelViewSet): queryset = Books.objects.all() serializer_class = BooksSerializers @action(methods=['GET', 'POST'], detail=True) def get_num(self, request, pk): book = self.get_queryset()[:int(pk)] # 獲取前幾條數據 ser = self.get_serializer(book, many=True) return Response(ser.data) # 生成路由如下 http://127.0.0.1:8000/books/2/get_num/ <URLPattern '^books/(?P<pk>[^/.]+)/get_num/$' [name='books-get-num']>
二、認證
認證的寫法
- 寫一個認證類,繼承 BaseAuthentication,重寫 authenticate, 認證的邏輯寫在裡面,認證通過,返回兩個值,一個值給Request對象的user, 認證失敗,拋異常:APIException或者AuthenticationFailed
- 將認證類添加到需要認證視圖類的
authentication_classes = [認證類1]
中 - 全局使用,還是局部使用
# 全局使用,在setting.py中配置 REST_FRAMEWORK={ "DEFAULT_AUTHENTICATION_CLASSES":["app01.app_auth.MyAuthentication",] } # 局部使用,在視圖類上寫 authentication_classes=[MyAuthentication] # 局部禁用 authentication_classes=[]
認證源碼分析
1、APIView重寫as_view方法使之沒有csrf認證——>但還是正常執行 dispatch 方法,但是 dispatch方法被 APIView重寫瞭——>dispatch 中執行瞭 self.initial 認證方法——>有認證,權限,頻率
2、現在隻是看認證源碼self.perform_authentication(request)
3、但是self.perform_authentication(request)
就一句話:request.user
,那麼就需要去 drf 的 Request 對象中找 user 屬性(方法)
@property def user(self): # 先去判斷當前對象中有沒有'_user'這個屬性,一開始肯定是沒有的,因為用戶是沒有登錄的 if not hasattr(self, '_user'): with wrap_attributeerrors(): # 沒有用戶,認證出用戶 self._authenticate() # 有用戶,直接返回用戶 return self._user
4、Request 類中的 user 方法,剛開始來,沒有_user
,走 self._authenticate()
5、核心,就是Request類中的 _authenticate(self)
def _authenticate(self): # 遍歷拿到一個認證器,進行認證 # self.authenticators 配置的一堆認證類產生的認證類對象組成的 list # self.authenticators 就是在視圖類中配置的:authentication_classes = [認證類1,認證類2] 的一個個認證類的對象: ————>self.authenticators ==》 [認證類1對象,認證類2對象] for authenticator in self.authenticators: try: # 認證器調用認證方法authenticate(認證類對象self,request對象) """ def authenticate(self, request): return (self.force_user, self.force_token) """ # 返回值:登錄的用戶與認證的信息組成的 tuple # 並且該方法被try包裹,就代表該方法會拋異常,拋異常就代表認證失敗 user_auth_tuple = authenticator.authenticate(self) # self是request對象 except exceptions.APIException: self._not_authenticated() raise # 返回值的處理 if user_auth_tuple is not None: self._authenticator = authenticator # 如果有返回值,就將 "登錄用戶" 與 "登錄認證" 分別保存到 request.user / request.auth self.user, self.auth = user_auth_tuple return # 如果返回值user_auth_tuple為空,代表認證通過,但是沒有 "登錄用戶" 與 "登錄認證信息",代表遊客 self._not_authenticated()
認證組件的使用
1、寫一個認證類,繼承 BaseAuthentication,重寫 authenticate
# app01_auth.py from rest_framework.authentication import BaseAuthentication from rest_framework.exceptions import AuthenticationFailed from app01.models import UserToken class TokenAuthentication(BaseAuthentication): def authenticate(self, request): # 認證邏輯,如果認證通過,返回兩個值 # 如果認證失敗,拋出AuthenticationFailed異常 token = request.data.get('token') if token: user_token = UserToken.objects.filter(token=token).first() # 認證通過 if user_token: return UserToken.user, token else: raise AuthenticationFailed('認證失敗') else: raise AuthenticationFailed('請求地址中需要帶token')
2、將認證類添加到需要認證視圖類的authentication_classes = [認證類1]
中
# views.py from rest_framework.viewsets import ModelViewSet from rest_framework.views import APIView from rest_framework.response import Response from app01.models import Books, UserInfo, UserToken from app01.ser import BooksSerializer from app01.app01_auth import TokenAuthentication import uuid # 查看Books需要經過認證才能查看 class BooksView(ModelViewSet): authentication_classes = [TokenAuthentication] queryset = Books.objects.all() serializer_class = BooksSerializer # 登錄視圖,登錄後獲得token,後續用token認證 class LoginView(APIView): def post(self, request): response_msg = {'status': 200, 'msg': ''} username = request.data.get('username') password = request.data.get('password') user_obj = UserInfo.objects.filter(username=username, password=password).first() if user_obj: # 登錄成功生成一個隨機字符串 token = uuid.uuid4() # 存到UserToken表中,update_or_create有就更新,沒有就新增 UserToken.objects.update_or_create(defaults={'token': token}, user=user_obj) response_msg['msg'] = '登錄成功' response_msg['token'] = token else: response_msg['msg'] = '賬戶或密碼錯誤' response_msg['status'] = 204 return Response(response_msg)
到此這篇關於drf-router和authenticate認證源碼分析的文章就介紹到這瞭,更多相關drf-router和authenticate內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!
推薦閱讀:
- DRF過濾排序分頁異常處理的過程記錄
- django restframework使用redis實現token認證
- python-jwt用戶認證食用教學的實現方法
- Django開發RESTful API實現增刪改查(入門級)
- Python編程使用DRF實現一次性驗證碼OTP