第四十八章：django restfrom work (1)

序列化基础

 

什么是序列化与反序列化

"""
序列化：对象转换为字符串用于传输
反序列化：字符串转换为对象用于使用
"""

 

drf序列化与反序列化

"""
序列化：Model类对象转换为字符串用于传输
反序列化：字符串转换为Model类对象用于使用
"""

 

Model类

创建数据库：终端

>: mysql -uroot -p密码
>: create database 数据库名 charset=utf8

 

配置数据库：settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': '数据库名',
        'USER': 'root',
        'PASSWORD': '密码'
   }
}

 

修改操作数据库的模块：项目init文件

import pymysql
pymysql.install_as_MySQLdb()

 

创建model类：models.py

from django.db import models
class User(models.Model):
    CHOICE_SEX = (
       (0, '男'),
       (1, '女')
   )
    name = models.CharField(max_length=32, verbose_name='姓名')
    password = models.CharField(max_length=64, verbose_name='密码')
    sex = models.SmallIntegerField(choices=CHOICE_SEX, default=0)
    create_time = models.DateTimeField(auto_now_add=True, blank=True)
​
    class Meta:
        # 自定义创建的表名
        db_table = 'o_user'
        # admin界面中显示的表面与表名复数形式
        verbose_name = '用户'
        verbose_name_plural = verbose_name
​
    def __str__(self):
        return self.name

 

注册model类：admin.py

from django.contrib import admin
from api.models import User
admin.site.register(User)

 

数据库迁移：在项目目录下的终端

>: python3 manage.py makemigrations
>: python3 manage.py migrate

 

注册超级用户：在项目目录下的终端

>: python3 manage.py createsuperuser

 

登陆admin页面添加数据：浏览器

http://localhost:8000/admin/

 

 

路由分发

项目urls.py

from django.conf.urls import url, include
from django.contrib import admin
​
urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^api/', include('api.urls'))
]

 

api应用urls.py

from django.conf.urls import url
urlpatterns = [
​
]

 

 

获取多资源 接口

序列化类：serializers.py

from rest_framework import serializers
​
# 为每一个Model类至少配一个Serializer类
class UserSerializer(serializers.Serializer):
    # 序列化一个Model类对象，其实就是序列化该类的每一个属性
    name = serializers.CharField()
    password = serializers.CharField()
    sex = serializers.IntegerField()
    create_time = serializers.DateTimeField()

 

视图类：views.py

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import User
from .serializers import UserSerializer
​
# 对应路由：/users/
# 功能：get获取所有 | post新增一个 | put修改一个 | delete删除一个
class UsersAPIView(APIView):
    def get(self, request, *args, **kwargs):
        user_list = User.objects.all()
  
        # instance存放的是queryset对象，many需要设置为True
        user_data = UserSerializer(instance=user_list, many=True).data
        return Response(
           {
                'status': 0,
                'msg': 'ok',
                'results': user_data
           }
       )

 

 

序列化字段操作（自定义字段）

序列化类修订：serializers.py

from rest_framework import serializers
​
# 为每一个Model类至少配一个Serializer类
class UserSerializer(serializers.Serializer):
    # 序列化一个Model类对象，其实就是序列化该类的每一个属性
    # 注意1：Model类与Serializer类是通过属性名建立关联的 - 属性名必须依照
    name = serializers.CharField()
    password = serializers.CharField()
    # sex = serializers.IntegerField()
    # 注意2：不需要通过给前台的数据，不需要提供该属性的序列化
    # create_time = serializers.DateTimeField()
​
    # 注意3：serializers.SerializerMethodField()可以产生自定义序列化属性(不需要和Model类属性同步)，
    #       但要为其绑定一个提供值的函数，函数名为 get_属性(self, obj) (obj为参与序列化的Model类对象)
    gender = serializers.SerializerMethodField()
    def get_gender(self, obj):
        # 该函数的返回值就作为对应自定义数据序列化后的值
        return obj.get_sex_display()

 

 

新增单资源 接口

序列化类(反序列化类)：serializers.py

from rest_framework import serializers
from .models import User
​
​
class UserDeserializer(serializers.Serializer):
    name = serializers.CharField(label='姓名', max_length=32, min_length=3, error_messages={
        'max_length': '姓名太长',
        'min_length': '姓名太短'
   })
    password = serializers.CharField(label='密码', max_length=64, min_length=3, error_messages={
        'max_length': '密码太长',
        'min_length': '密码太短'
   })
    sex = serializers.IntegerField()
    # required=False该字段前台可以不用传(不参与校验)
    create_time = serializers.DateTimeField(required=False)
​
    # 完成ORM的操作
    # def save(self): # 不能直接重写save，因为系统的save可以完成新增或修改
    #     # print(self.validated_data)
    #     User.objects.create(**self.validated_data)
​
    # 为post接口提供新增Model类对象的功能
    def create(self, validated_data):
        # 返回值：Model类要新增的对象
        return User.objects.create(**validated_data)

 

视图类：views.py

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import User
from .serializers import UserSerializer
​
# 对应路由：/users/
# 功能：get获取所有 | post新增一个 | put修改一个 | delete删除一个
class UsersAPIView(APIView):
    # 新增一个资源
    def post(self, request, *args, **kwargs):
        user_deser = UserDeserializer(data=request.data)
        # raise_exception值为True，当校验失败，直接返回校验失败的错误信息
        # result = user_deser.is_valid(raise_exception=True)
        result = user_deser.is_valid()
        if result:
            new_user_obj = user_deser.save()
            return Response({
                'status': 0,
                'msg': 'success',
                'result': UserSerializer(new_user_obj).data
           })
        else:
            return Response({
                'status': 1,
                'msg': 'failed',
                'results': user_deser.errors
           })
​
​

 

 

更新单资源 接口

序列化类(反序列化类)：serializers.py

from rest_framework import serializers
from .models import User
​
​
class UserDeserializer(serializers.Serializer):
    name = serializers.CharField(label='姓名', max_length=32, min_length=3, error_messages={
        'max_length': '姓名太长',
        'min_length': '姓名太短'
   })
    password = serializers.CharField(label='密码', max_length=64, min_length=3, error_messages={
        'max_length': '密码太长',
        'min_length': '密码太短'
   })
    sex = serializers.IntegerField()
    # required=False该字段前台可以不用传(不参与校验)
    create_time = serializers.DateTimeField(required=False)
​
    # 完成ORM的操作
    # def save(self): # 不能直接重写save，因为系统的save可以完成新增或修改
    #     # print(self.validated_data)
    #     User.objects.create(**self.validated_data)
​
    # 为post接口提供新增Model类对象的功能
    def create(self, validated_data):
        # 返回值：Model类要新增的对象
        return User.objects.create(**validated_data)
    
    # 为put接口提供更新Model类对象的功能
    def update(self, instance, validated_data):
        # 操作model对象
        # instance.name = validated_data.get('name')
        # instance.password = validated_data.get('password')
        # instance.sex = validated_data.get('sex')
        # instance.save()
        # 操作queryset对象
        instance.update(**validated_data)
        return instance

 

视图类：views.py

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import User
from .serializers import UserSerializer
​
# 对应路由：/users/
# 功能：get获取所有 | post新增一个 | put修改一个 | delete删除一个
class UsersAPIView(APIView):
 # 更新一个资源
    def put(self, request, *args, **kwargs):
        # 要更新的资源的主键
        pk = kwargs.get('pk')
  
        # 操作更新时可以选择操作 queryset对象 或 model对象
  # 操作model对象
        # old_user_obj = User.objects.get(pk=pk)
        # user_deser = UserDeserializer(instance=old_user_obj, data=request.data)
​
        # 操作queryset对象
        old_user_query = User.objects.filter(pk=pk)
        user_deser = UserDeserializer(instance=old_user_query, data=request.data)
​
        # raise_exception值为True，当校验失败，直接返回校验失败的错误信息
        # result = user_deser.is_valid(raise_exception=True)
        result = user_deser.is_valid()
        if result:
            # new_user_obj = user_deser.save() # 操作model对象
            new_user_query = user_deser.save()  # 操作queryset对象
            new_user_obj = new_user_query.first()
            return Response({
                'status': 0,
                'msg': 'success',
                'result': UserSerializer(new_user_obj).data
           })
        else:
            return Response({
                'status': 1,
                'msg': 'failed',
                'results': user_deser.errors
           })

 

删除单资源 接口

重构Model新增字段：models.py

class User(models.Model):
    CHOICE_SEX = (
       (0, '男'),
       (1, '女')
   )
    name = models.CharField(max_length=32, verbose_name='姓名')
    password = models.CharField(max_length=64, verbose_name='密码')
    sex = models.SmallIntegerField(choices=CHOICE_SEX, default=0)
    create_time = models.DateTimeField(auto_now_add=True, blank=True)
    # 新增：数据删除不是从数据库删除记录，而是修改记录状态，标示为已删除即可
    is_delete = models.BooleanField(default=False)
​
    class Meta:
        # 自定义创建的表名
        db_table = 'o_user'
        # admin界面中显示的表面与表名复数形式
        verbose_name = '用户'
        verbose_name_plural = verbose_name
​
    def __str__(self):
        return self.name

数据库迁移：在项目目录下的终端

>: python3 manage.py makemigrations
>: python3 manage.py migrate

视图类接口：views.py

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import User
from .serializers import UserSerializer
​
# 对应路由：/users/
# 功能：get获取所有 | post新增一个 | put修改一个 | delete删除一个
class UsersAPIView(APIView):
 # 删除一个资源
    def delete(self, request, *args, **kwargs):
        pk = kwargs.get('pk')
        try:
            delete_user_obj = User.objects.get(pk=pk, is_delete=False)
            # 完成删除信息的更新
            delete_user_obj.is_delete = True
            delete_user_obj.save()
            return Response()
        except:
            return Response({
                'status': 1,
                'msg': '数据删除失败'
           })

 

获取单资源 接口

序列化类：serializers.py

from rest_framework import serializers
​
# 为每一个Model类至少配一个Serializer类
class UserSerializer(serializers.Serializer):
    # 序列化一个Model类对象，其实就是序列化该类的每一个属性
    name = serializers.CharField()
    password = serializers.CharField()
    sex = serializers.IntegerField()
    create_time = serializers.DateTimeField()

 

视图类：views.py

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import User
from .serializers import UserSerializer
​
# 对应路由：/users/
# 功能：get获取所有 | post新增一个 | put修改一个 | delete删除一个
class UsersAPIView(APIView):
    def get(self, request, *args, **kwargs):
         pk = kwargs.get('pk', None)
​
        if not pk:
            user_query = User.objects.filter(is_delete=False).all()
        else:
            user_query = User.objects.filter(is_delete=False, pk=pk)
            # 如果只操作一个对象，many参数需要为False(默认值)
            # user_obj = User.objects.filter(is_delete=False, pk=pk).first()
            # user_data = UserSerializer(instance=user_obj, many=False).data
​
        user_data = UserSerializer(instance=user_query, many=True).data
        return Response(
           {
                'status': 0,
                'msg': 'ok',
                'results': user_data
           }
       )

 

 

序列化基础：重点内容

模型类：models.py

from django.db import models
​
# Create your models here.
​
class User(models.Model):
    CHOICE_SEX = (
       (0, '男'),
       (1, '女')
   )
    name = models.CharField(max_length=32, verbose_name='姓名')
    password = models.CharField(max_length=64, verbose_name='密码')
    sex = models.SmallIntegerField(choices=CHOICE_SEX, default=0)
    create_time = models.DateTimeField(auto_now_add=True, blank=True)
    # 数据删除不是从数据库删除记录，而是修改记录状态，标示为已删除即可
    is_delete = models.BooleanField(default=False)
​
    class Meta:
        # 自定义创建的表名
        db_table = 'o_user'
        # admin界面中显示的表面与表名复数形式
        verbose_name = '用户'
        verbose_name_plural = verbose_name
​
    def __str__(self):
        return self.name

 

序列化类：

from rest_framework import serializers
from .models import User
​
class UserSerializer(serializers.Serializer):
    # 序列化和反序列化都可以使用
    name = serializers.CharField(label='姓名', max_length=32, min_length=3, error_messages={
        'max_length': '姓名太长',
        'min_length': '姓名太短'
   })
    password = serializers.CharField(label='密码', max_length=64, min_length=3, error_messages={
        'max_length': '密码太长',
        'min_length': '密码太短'
   })
    # 只有反序列化使用 - 用 write_only=True 标示只参与反序列化
    sex = serializers.IntegerField(write_only=True)
    # 只有序列化使用 - 自定义字段 - 用 read_only=True 标示只参与序列化
    gender = serializers.SerializerMethodField(read_only=True)
    def get_gender(self, obj):
        return obj.get_sex_display()
    # 序列化与反序列化都不使用 - 1）注释 | 2）required=False, write_only=True
    create_time = serializers.DateTimeField(required=False, write_only=True)
​
    # 为全局校验钩子新增校验字段
    re_password = serializers.CharField(label='确认密码', max_length=64, min_length=3, write_only=True, error_messages={
        'max_length': '确认密码太长',
        'min_length': '确认密码太短'
   })
​
​
    # 反序列化两大方法重写 - 新增create | 更新update
    # 为post接口提供新增Model类对象的功能
    def create(self, validated_data):
        # 返回值：Model类要新增的对象
        return User.objects.create(**validated_data)
​
    # 为put接口提供更新Model类对象的功能
    def update(self, instance, validated_data):
        instance.update(**validated_data)
        # 返回更新后的instance
        return instance
​
​
    # 局部钩子
    def validate_sex(self, value):
        if value not in (0, 1):
            raise serializers.ValidationError('未知性别')
        return value
​
    # 全局钩子
    def validate(self, attrs):
        re_password = attrs.pop('re_password')
        password = attrs.get('password')
        if re_password != password:
            raise serializers.ValidationError('二次密码不一致')
        return attrs

 

视图类：

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import User
from .serializers import UserSerializer
​
# 对应路由：/users/ | /users/pk/
# 功能：get获取所有 | post新增一个 | put修改一个 | delete删除一个 | get获取一个
class UsersAPIView(APIView):
    # 获取所有资源 | 单个资源
    def get(self, request, *args, **kwargs):
        # 单个资源的主键
        pk = kwargs.get('pk', None)
        if not pk:
            user_query = User.objects.filter(is_delete=False).all()
        else:
            user_query = User.objects.filter(is_delete=False, pk=pk)
​
        user_data = UserSerializer(instance=user_query, many=True).data
        return Response(
           {
                'status': 0,
                'msg': 'ok',
                'results': user_data
           }
       )
​
    # 新增一个资源
    def post(self, request, *args, **kwargs):
        user_deser = UserSerializer(data=request.data)
​
        # raise_exception值为True，当校验失败，直接返回校验失败的错误信息
        # result = user_deser.is_valid(raise_exception=True)
        result = user_deser.is_valid()
        if result:
            new_user_obj = user_deser.save()
            return Response({
                'status': 0,
                'msg': 'success',
                'result': UserSerializer(new_user_obj).data
           })
        else:
            return Response({
                'status': 1,
                'msg': 'failed',
                'results': user_deser.errors
           })
​
    # 更新一个资源
    def put(self, request, *args, **kwargs):
        pk = kwargs.get('pk')
        old_user_query = User.objects.filter(pk=pk, is_delete=False)
        # 没有数据
        if not old_user_query:
            return Response({
                'status': 1,
                'msg': 'update failed',
           })
​
        user_deser = UserSerializer(instance=old_user_query, data=request.data)
        result = user_deser.is_valid()
        if result:
            new_user_query = user_deser.save()
            new_user_obj = new_user_query.first()
            return Response({
                'status': 0,
                'msg': 'success',
                'result': UserSerializer(new_user_obj).data
           })
        else:
            return Response({
                'status': 1,
                'msg': 'failed',
                'results': user_deser.errors
           })
​
    # 删除一个资源
    def delete(self, request, *args, **kwargs):
        pk = kwargs.get('pk')
        try:
            delete_user_obj = User.objects.get(pk=pk, is_delete=False)
            # 完成删除信息的更新
            delete_user_obj.is_delete = True
            delete_user_obj.save()
            return Response()
        except:
            return Response({
                'status': 1,
                'msg': '数据删除失败'
           })