1.APIWiew
ModelVIewSet 是对 APIView 的封装
ModelSerializer 是对 Serializer
1.1在user/urls.py 中添加路由
urpatterns = [
path('apiview/', views.UserInfoViewSet.as_view()),
]
1.2创建user/serializers.py写序列化器
· serializers.ModelSerializer 和 serializers.Serializer field参数说明
''' field参数 '''
# 1.read_only
read_only=True 表示不允许用户自己上传,只能用于api的输出,序列化的时候也不用对这个数据进行验
证,序列化返回是有改字段
# 2.write_only
write_only=True 表示在更新或创建实例时可以使用该字段,但在序列化返回时不包括该字段。
# 3.required:该字段是必需的,不能为空
required=True 反序列化(前端返回数据必须包含此字段)的时候必须提供这个字段 设置False 可以
不提供
# 4.allow_null/allow_blank:该字段允许为null/空
allow_null=True 可以为null 设置False则不能为null
# 5.label:标签,用于对字段显示设置
# 6.help_text:对字段进行解释的一段文本,用于提示
# 7.style:说明字段的类型
# 8.error_messages:字段出错时,信息提示
· 创建user/serializers.py写序列化器
# class User(AbstractUser): # phone = models.CharField('手机号',max_length=20) # img = models.ImageField(upload_to='user',null=True) # nick_name = models.CharField('昵称',max_length=20) # address = models.CharField('地址',max_length=255) class UserInfoSerializer(serializers.Serializer): id = serializers.CharField(read_only=True) # 普通字段,设置id为只读字段,不能修改 username = serializers.CharField(min_length=3, max_length=20, error_messages= {'required': '该字段必填'}) # 显示普通字段 img = serializers.ImageField(required=False) nick_name = serializers.CharField(max_length=20) address = serializers.CharField(max_length=255) xxx = serializers.SerializerMethodField(read_only=True) # 自定义显示(显示多对多) class Meta: model = User # 自定义显示 多对多 字段 def get_xxx(self, row): '''row: 传过来的正是 User表的对象''' users = row.username # 获取用户名 return users # 定义创建语法:ser.save()执行,就会立刻调用create方法用来创建数据 def create(self, validated_data): '''validated_data: 表单或者vue请求携带的json: {"username":"zhangsan","password":"123456"}''' # https://www.cnblogs.com/xiaonq/p/7978409.html return User.objects.create(**validated_data) # 定义更新方法 def update(self, instance, validated_data): ''' instance : 查询的对象 validated_data : postman提交的json数据 {"username":"zhangsan","password":"123456"} ''' if validated_data.get('username'): instance.username = validated_data['username'] instance.save() return instance # 定义单一字段验证的方法 def validate_name(self, value): if value == 'root': raise serializers.ValidationError('不能创建root管理员账号') return value # 定义多字段验证方法 def validate(self, attrs): print(attrs) if attrs.get("username") == 'admin': raise serializers.ValidationError('不能创建admin用户') return attrs
1.3 在 user/views.py 中添加视图函数
from user.serializers import UserInfoSerializer class UserInfoViewSet(APIView): # 查询用户信息 def get(self, request, *args, **kwargs): # 一对多、多对多查询都是一样的语法 obj = User.objects.all() ser = UserInfoSerializer(instance=obj,many=True) # 关联数据多个 # ser = UserInfoSerializer(instance=obj[0]) # 关联数据一个 return Response(ser.data, status=200) # 创建用户 '''创建用户''' def post(self,request): ser = UserInfoSerializer(data=request.data) # 判断提交数据是否合法 if ser.is_valid(): ser.save() return Response(data=ser.data, status=201) return Response(data=ser.errors,status=400) # 更新用户信息 def put(self, request): pk = request.query_params.get('pk') try: userinfo = User.objects.get(id = pk) except Exception as e: return Response(data='用户不存在', status=201) # 创建序列化对象,并将要反序列化的数据传递给data构造参数,进而进行验证 ser = UserInfoSerializer(userinfo,data=request.data) if ser.is_valid(): ser.save() return Response(data=ser.data, status=201) return Response(data=ser.errors,status=400)
2.测试接口
2.1查询所有用户
http://192.168.56.100:8888/user/apiview/
2.2创建用户
http://192.168.56.100:8888/user/apiview/
2.3更新用户信息
http://192.168.56.100:8888/user/apiview/?pk=7
2.4限流功能测试
http://192.168.56.100:8888/user/apiview/
'''修改syl/settings.py配置限速设置'''
REST_FRAMEWORK = {
#3.1 限流策略
'DEFAULT_THROTTLE_RATES': {
'user': '3/hour', # 认证用户每小时10次
'anon': '3/day',
},
}