from rest_framework import serializers
python
先后端交互主要有get
,post
,puch
,put
,deleter
数据库
其中用到序列化的get
django
用到反序列化的剩下四中后端
serializers.Serializer
的类class UserSerializer(serializers.Serializer): username = serializers.CharField() #不须要的字段=serializers.CharField(write_only=True) sex = serializers.IntegerField() gender = serializers.SerializerMethodField() def get_gender(self, user_obj): return user_obj.get_sex_display() icon = serializers.SerializerMethodField() #SerializerMethodField为自定义字段 def get_icon(self, user_obj): icon_url = 'http://127.0.0.1:8000{}{}'.format(settings.MEDIA_URL, user_obj.icon) return icon_url
自定义字段,拿gander
字段举例在models中是框架
SEX_CHOICES = [ (0, '男'), #choices选择中,括号里前者表示填写的值,后者表示对应的值 (1, '女'), ] # 为choices的字段,获取值后的映射关系 get_字段名_display() sex = models.IntegerField(choices=SEX_CHOICES, default=0)
def get_gender(self, user_obj): return user_obj.get_sex_display()
基于GET请求的get_固定写法 def get_model类中有字段(self,obj): #逻辑处理 return 修改后的代码
须要序列化字段
函数
在不作任何处理的状况下
咱们定义的类里面的字段必须在model类中必须存在该字段read_only=True
SerializerMethodField
及自定义字段类型不用遵照类里面的字段必须在model类中必须存在该字段
不须要序列化字段
post
write_only=True
from rest_framework.views import APIView class UserAPIView(APIView): def get(self, request, *args, **kwargs): user_obj = models.User.objects.all().frist user_obj_data = '''咱们自定义的Serializer类'''(user_obj).data return APIResponse(0, 'ok', results=user_obj_data)
.data
many=True
还需传入这个参数many
这个参数默认是False全部咱们序列化单个参数时候不须要传入many
单列集合
,不能是多列集合注
:ui
[a,b,c.....]
|{a,b,c.....}
|(a,b,c.....)
|QuerySet
{k1:v1,k2:v2.......}
serializers.Serializer
的类class UserDeserializer(serializers.Serializer): username = serializers.CharField( min_length=3, error_messages={ 'min_length': '用户名过短' } ) password = serializers.CharField( min_length=3, error_messages={ 'min_length': '密码过短' } ) re_password = serializers.CharField( min_length=3, required=True, error_messages={ 'min_length': '确认密码过短', 'required': '确认密码不能为空' } )
相较于序列化定义
反序列化中增长了条件的筛选url
注意点
:若是类的字段值应用在反序列化,咱们能够在他的字段的属性上加上write_only=True
rest
里面所说起的字段必须传入
经常使用的约数条件与django中from组件约数条件有点相似
:
error_messages
错误信息的属性required
是否为空max_length
最长min_length
最短invalid
格式class UserDeserializer(serializers.Serializer): ....... def validate_字段名称(self,value): #代码块 if 状况不知足: raise serializers.ValidationError('异常信息') #抛出异常 return value #也就是对字段数据进行二次处理
class UserDeserializer(serializers.Serializer): ....... def validate(self, attrs): #attrs是全部字段的一个相似字典的集合 #咱们要其中某个字段 attrs.get('字段名') return attrs # 最终结果抛出异常或者返回attrs
咱们若是想自定义create的相关内容咱们能够Serializer类中
再加个create
方法
class UserDeserializer(serializers.Serializer): ....... def create(self, validated_data): try: return modles中的类.objects.create(**validated_data) except: raise IOError('数据库入库失败')
咱们更具需求能够先自定义一个APIResponse,继承rest_framework中的Response也能够直接使用他自带的
自定义APIResponse,建议自定义
from rest_framework.response import Response """ Response({ 'status': 0, 'msg': 'ok', 'results': [], 'token': '' }, headers={}, status=200, content_type="") APIResponse(0, 'ok', results, status, headers, content_type) """ class APIResponse(Response): def __init__(self, data_status, data_msg, results=None, status=None, headers=None, content_type=None, **kwargs): data = { 'status': data_status, 'msg': data_msg } if results is not None: data['results'] = results data.update(kwargs) super().__init__(data=data, status=status, headers=headers, content_type=content_type)
在视图函数中的设置
class UserAPIView(APIView): def post(self, request, *args, **kwargs): #通常都是post请求 request_data = request.data user_ser = '''咱们自定义的Serializer类'''(data=request_data) #传入request.data if user_ser.is_valid(): # 自定义处理校验成功的逻辑 user_obj = user_ser.save() return APIResponse(0, 'ok', results=serializers.UserSerializer(user_obj).data ) else: # 自定义返回错误信息 return APIResponse(1, 'failed', results=user_ser.errors)
咱们若是想自定义update的相关内容咱们能够Serializer类中
再加个update
方法
class UserDeserializer(serializers.Serializer): ....... def update(self, instance, validated_data): # instance自定义传入的要更新的原数据(pk | obj | queryset) # validated_data校验经过后的新数据 # instance的值外部反序列化传入要更新的自定义标识决定 instance.update(**validated_data) return instance.first()
在视图函数中的设置
单总体改
class UserV2APIView(APIView): def put(self, request, *args, **kwargs): pk = kwargs.get('pk') if not pk: return APIResponse(1, 'pk error') user_query = models.User.objects.filter(pk=pk, is_delete=False) if not user_query: return APIResponse(1, 'user error') # 第一种:user_query完成数据的更新 # user_query = models.User.objects.filter(pk=pk) # user_query.update(**kwargs) # 第二种:user_obj完成数据的更新 # user_obj = models.User.objects.filter(pk=pk).first() # type: models.User # user_obj.username = 'new_username' # ... # user_obj.save() #这里的instance必须传参(pk | obj | queryset) request_data = request.data user_ser = serializers.UserV2Serializer(instance=user_query, data=request_data) if user_ser.is_valid(): # save的返回值是由update内部自定义的返回值决定 user_obj = user_ser.save() return APIResponse(0, 'ok', results=serializers.UserV2Serializer(user_obj).data ) else: return APIResponse(1, 'failed', user_ser.errors)
单删
或单体修改
如今数据都是很重要的通常状况下不会吧数据删除只会作个标记字段其本质仍是局部更新
def delete(self, request, *args, **kwargs): pk = kwargs.get('pk') if not pk: return APIResponse(1, 'pk error') user_obj = models.User.objects.filter(pk=pk, is_delete=False).first() if not user_obj: return APIResponse(1, '删除失败') user_obj.is_delete = True user_obj.save() return APIResponse(0, '删除成功')
model.py
create_time = models.DateTimeField(auto_now_add=True, null=True) is_delete = models.BooleanField(default=False)
setting.py
时区相关设置
LANGUAGE_CODE = 'zh-hans' #其中 zh-Hans是简体中文 zh-Hant是繁体中文 TIME_ZONE = 'Asia/Shanghai' #上海时间 USE_I18N = True #国际化支持 I18N USE_L10N = True USE_TZ = False #USE_TZ设置为True,Django会使用系统默认设置的时区即America/Chicago,此时的TIME_ZONE无论有没有设置都不起做用。
注意点:
USE_TZ为True
,TIME_ZONE
无论有没有设置都不起做用