DRF的认证、权限、限流、序列化、反序列化
一、认证
1、直接用,用户授权
-
实现方法
-
编写 ->认证组件
-
应用组件
-
-
编写 ->认证组件
from rest_framework.authentication import BaseAuthentication
from rest_framework.exceptions import AuthenticationFailed
class 认证类(BaseAuthentication):def authenticate(self,request):1、 获取用户信息1.1 可以从URL中获取,xx/xx/xx/?token=....request.query_params(token) 来获取token值1.2 可以从请求头中获取request.META.get("HTTP_AUTHORIZATION")# AUTHORIZATION传递过来的key1.3 可以从请求体中获取request.data.get(token)2、校验用户信息的合法性3、返回结果- 3.1 正确,返回元组(用户信息,认证信息如token)- 3.2 错误,raise抛出错误信息raise AuthenticationFailed({key:vaule})#注:可以用字典提示错误- 3.3 错误返回None->多个认证类 [类1,类2,....]return user,authdef authenticate_header(self,request):return "token"#认证失败状态应该是401,如果authenticate_header不返回值,就是403
BaseAuthentication源码是:
class BaseAuthentication:#注:只要在django中出现raise NotImplementedError(),就必须使用该方法,不然会出错!(重定义方法)。子类约束。def authenticate(self,request):raise NotImplementedError("必顺要写的函数。")def authenticate_header(self,request):pass
- 应用组件
- 局部
from rest_framework.views import APIView
from rest_framework.response import Response
#在视图类中添加
class 视图类名(APIView):authentication_classes = [认证类1,认证类2,认证类3.....]
-
全局(在setting中设置)
REST_FRAMEWORK = {"UNAUTHENTICATED_USER":None,#是让没有用户时为None,默认是AnyOne,"DEFAULT_AUTHENTICATION_CLASSES":["自定义认证类的位置"] } # 注:在配置全局时,不能写在视图类中。视图类还没有加载完。
在全局配置时,如果要让某个视图不进行认证,就在视图类中把authentication_classes=[]
-
注:
-
多个认证类
多个认证类是或的关系,但返回的值是None,前面的认证成功,后面的就不认证了。如果都不认证成功,一般最后一个为抛出异常类。
抛出异常类class NoAuthentictions(BaseAuthentication):def authenticate(self,request):raise AuthenticationFailed({key:vaule})def authenticate_header(self,request):return 'Token'
-
回顾
2、认证组件源码
二、权限
1. 直接使用,用户权限
- 权限组件说明
- 权限组件编写
from rest_framework.permissions import BasePermissionclass 权限类名(BasePermission):messge={.....}#权限失败是返回的错误信息def has_permission(self,request,view):1. 获取请求中的数据2. 校验3. 返回值3.1 返回True 表示校验通过3.2 返回False 表示校验没通过return True | False
-
权限组件的使用
- 局部使用(在视图中添加)
from rest_framework.views import APIViewclass 视图类名(APIView):permission_classes = [权限类名1,权限类名2,权限类名3,....]#权限类名是一个且的关系,前面的是False后面的就不再执行了。
-
全局(setting.py)中
-
REST_FRAMEWORK = {"UNAUTHENTICATED_USER":None,#是让没有用户时为None,默认是AnyOne,"DEFAULT_AUTHENTICATION_CLASSES":["自定义认证类的位置"],"DEFAULT_PERMISSION_CLASSES":["自己定义的权限类位置"]#可以是一个列表 } # 注:在配置全局时,不能写在视图类中。视图类还没有加载完。
-
权限或组件的编写
系统默认的是且关系,而不是或的关系,以下是或的关第编写
#要在APIView中编写代码
from rest_framework.views import APIViewclass 自定义或权限关系类名(APIView):def check_permission(self,request):permission_objects = self.get_permissions()for permission in permission_objects:if permission.has_permission(request,self):returnelse:self.permission_denied(request,message=getattr(permission_objects[0],'message',None),code=getattr(permission_objects[0],'code',None))
for...in...:....
else:....
#当循环完后,有返回False时,才执行else
在视图类中,继承自定义或权限关系类名
2.权限组件源码
三、序列化
1. 序列化
序列化,从数据库获取Query_Set或数据对像 ->JSON
序列化的流程
路由->视图->去数据库获取对象或QuerySet -> 序列化器的类转换成列表、字典、有序字典 -> JSON处理
1.1 自定义Serailizer类序列化
from rest_framework import serializers
class 序列化类名(serializers.Serializer):字段 = serializers.类型()...#字段要与数据库中的一致
1.2 在视图APIView中使用
from rest_framework.views import APIView
frrom rest_framework.response import Response
class 视图类名(APIView):1. 获取数据库的数据instance2. 序列化数据ser = 序列化类名(instance = instance,many=True | False)#True是Query_Set,False是数据对像#ser.data才是真正的将数据对象或Query_set转化为JSON格式3.返回JSON数据return Response(ser.data)
关于序列化类many的说明
- many=False是单个对象的序列化
- many=True时是Query_set的序列化,它是加了下个for循环,再调用单个对象序列化
1.3 自定义ModelSerializer类序列化
由于序列化时,字段与模型中的字段是一样的,所以将其集中
from from rest_framework.serializers import ModelSerializer
class 自定义ModelSerializer类名(ModelSerializer):class Meta:model = 模型类名fields = [字段类名列表] | "__all__"#所有字段都返回
1.4 不同格式的字段序列化
1.4.1 自定义字段
在modelserializer的字段自定制
from from rest_framework.serializers import ModelSerialize
from from rest_framework.serializers
class 自定义ModelSerializer类名(ModelSerializer):字段 = serailizes.类型(source="数据库的字段")#自定义字段,要在field中添加自定义字段名class Meta:model = 模型类名fields = [字段类名列表] | "__all__"#所有字段都返回
注:
- source是数据库的字段
- source支持对象的访问,如obj.字段.外键字段名 | obj.get_字段_display#get_字段_display运行时会自动加上括号
- 在fields中要添加自定义字段名,可以不与数据名一致
1.source对接的是数据库。2.支持orm对数据库的操作。3.带有函数的不用加括号。
1.4.2 日期自定义格式
from from rest_framework.serializers import ModelSerialize
from from rest_framework.serializers
class 自定义ModelSerializer类名(ModelSerializer):日期字段 = serailizes.DateTimeField(format="%y-%m-%d") #日期格式显式class Meta:model = 模型类名fields = [字段类名列表] | "__all__"#所有字段都返回
1.4.3 自定义方法字段
from from rest_framework.serializers import ModelSerialize
from from rest_framework.serializers
class 自定义ModelSerializer类名(ModelSerializer):自定义方法字段 = serailizes.SerializerMethodField()class Meta:model = 模型类名fields = [字段类名列表] | "__all__"#所有字段都返回def get_自定义方法字段(self,obj):obj是对象值retrun 序列化的值
1.4.4 嵌套,针对:一对多,多对多的情况
from from rest_framework.serializers import ModelSerialize
from from rest_framework.serializers class 一对多类名(ModelSerializer):class Meta:model = 模型类名fields = [字段类名列表] | "__all__"#所有字段都返回class 多对多类名(ModelSerializer):class Meta:model = 模型类名fields = [字段类名列表] | "__all__"#所有字段都返回class 自定义ModelSerializer类名(ModelSerializer):一对多字段名 = 一对多类名()多对多字段名 = 多对多类名()class Meta:model = 模型类名fields = [字段类名列表]
1.4.5 继承
from from rest_framework.serializers import ModelSerialize
from from rest_framework.serializers class 继承类名(ModelSerializer):class Meta:model = 模型类名fields = [字段类名列表] | "__all__"#所有字段都返回class 自定义ModelSerializer类名(ModelSerializer,继承类名):class Meta:model = 模型类名fields = [字段类名列表,可以添加自定义类名中的字段]
2. 序列化-源码流程
四、反序列化
1. 反序列化流程
路由-> 视图-> request.data ->校验(序列化器的类)->操作(数据库db,序列化器的类)
2. 数据校验
2.1数据校验是要在视图中校验的。但要在序列化类中写好校验规则。
from rest_framework.views import APIView
frrom rest_framework.response import Response
class 视图类名(APIViewdef post(self,request,*arg,**kwarg)1. 获取数据库的数据2. 数据校验ser = 序列化类名(data = request.data)ser.is_valid()#返回的是True或False业务编写校验通过后,可以能完ser.validated_data获取校验后的数据,返回是OrderadDict数据集。校验失败后,可以能完ser.errors获取错误信息,返回字典{字段:[ErrorDetail(错误提示)]}3.返回JSON数据return Response(ser.data)ser.is_valid(raise_exception=True)#成功可以利用值。抛出异常 raise ValidationError(self.errors)
注:不用判断,直接返回值,或返回错误值。
2.2序列化类校验规则
内置校验规则与正则校验规则
2.2.1内置校验规则
required = True | False 是否必须校验规则。
max_length = nu 最大长度
min_length = nu 最小长度
2.2.2 正则校验规则
var = serializers.CharField(validators=[RegesValidator(正则表达式,messege = "错误提示语!"),])
2.2.3 钩子函数
from rest_framework import serializer
from rest_framework import exceptions
#在序列化式子中编写
class 钩子函数类名(serilizers.Serializer):字段 = serializer.类型()...def validate_字段名(self,value):业务逻辑#value是传过来的值raise exceptions.ValidationError("校验失败时,错误提示语!")return value#也可以改变相关的值,返回给ser.validated_data中相应字段值defm validate(self,attr):attr是ser.validated_data的值所有字段校验通过了,最后校验这个函数。raise excptions.ValidationError("全局钩子校验失败时提示语。")#返回为{"non_field_errors":[ErrorDetail(string='....',code='invalid')]}#api_setting.NON_FIELD_ERRORS_KEYF表示指定全局,错误提示语Key可以setting.py 中添加"NON_FIELD_ERRORS_KEYF":'字符串'return attr#也可以对attr中的字典数据进行操作
2.24 ModelSerializer校验规则
from rest_framework import serializer
from rest_framework import exceptions
#在序列化式子中编写
class 钩子函数类名(serilizers.ModelSerializer):class Meta:model = 数据库名fields = [字段列表] | "__all__"extra_keargs = {字段:{"validators":[RegexValidator(正则,messegs:"错误提示语")]},字段:{内置规则}如:{"max_length":50},...}
在ModelSerializer中model对应的是数据库的字段,但不会把django模型中的限定语句加到序列化类中来,这时我们要自己加。可以用extra_kwargs={
字段:{…}
…
}
ModelSerializer的主要功能:
- 可以简化模型字段与序列化字段的编写。
- 可以将校验通过的数据,直接保存到数据库中。ser.save()
- ser.save()有两个小问题(字段少了,字段多了)
- 字段少了,可以在ser.save(少了的字段=value,…)
- 字段多了,可以用ser.validated_data.pop(字段名)删除多余的字段数据。注:用pop删除后会返回删除的值。也可以用del ser.validated_data.get(字段名),用del 不返回值。
- 用ser.save()是要序列化validated_data中的字段名与模型中的必存字段要一致。
- ser没有使用save()时,ser.validated_data中没有id,但保存后就有了id。所以ser.data就可以序列化取值了。
2.2.5 字段属性(read_only,write_only)
- read_only=Ture表示只序列化,不反序列化。
- write_only=True表示只反序列化,不序列化。
- 注:不能同时使用read_only、write_only。
- 对于嵌套类时,也可以用read_only、write_only。
2.2.6对校验的总结
3.序列化字段与模型字段的总结
- 序列化与模型取值这二个是独立的过程,模型取出的值后,再与序列化对接。序列化依据模型取出的数来进行操作,得到想要的结果。
- 序列化时每一个字段依据模型取出的值操作来得到想要的结果。字段要与模型字段为依据来操作,就与source有关。注:默认source与序列化字段一致,特别指定时,可以不一样。为了得到想要的值就拓展了以下方法:
- source=模型取值操作的方法一样
- 自定义方法字段 = serailizes.SerializerMethodField()->def get_自定义方法字段(self,value)->返回就是JSON想要的结果。(注:默认read_only=True)
- 嵌套类->使用时要关联模型类字段如:source=关联模型类字段
- 反序列化与模型存值这二个是独立的过程,先获得前端传来的数据request.data.再校验->校验的过程,其实就是将取到的值与自身的校验规则是否合法,如果合法相应字段再与模型实例化,注模型实例化可以少字段。这就带来两个问题,反序列化的字段多了或少了。多了、少了都不能存入数据库中。所以要注意以下三个方面:
- 多了要删除,可以看前面的(ModelSerializer的主要功能)
- 少了要添加,可以看前面的(ModelSerializer的主要功能)
- 保证ser.validated_data与模型中必存字段一致。
其实反序列化——>数据校验——>数据存储与模型数据存储是两个过程。它们只用ser.save()连结起来了。
3.1 对于chioces与序列化、反序列化、模型字段名一致
from collections import OrdereDict
from rest_framework.fields import SkipField
from rest_framework.relations import PKOnlyObjectclass NbHookSerializer(object):def to_representation(self,instance):ret = OrderedDcit()fields = self._readable_fieldsfor field in fields:if hasattr(self,"nb_%s"% field.field_name):value = getattr(self,'nb_%s'%field.field_name)(instance)ret[field.field_name] = valueelse:try:attribute = field.get_attribute(instance)except SkipField:continuecheck_for_none = attribute.pk if isinstance(attribute,PKOnlyObject) else attributeif check_for_none is None:ret[field.field_name] = Noneelse:ret[field.field_name] = field.to_representation(attribute)return ret
使用时,可以用类的继承-在写序列化时使用。继承要注意,要写在先,因为类的继承优先级是先到后。
4. 数据校验-源码流程
五、模型查询的常规操作
- 对象.get_字段_display() #chioces显示后面的字段
- 对象.字段.字段#针对于一对多、多对多的情况
- filter(id__in=id列表)对于多个值的查询
- 对象添加值->对象.字段.set([id列表])#多对多的情况使用。