Django - RESTful使用指南

Django - RESTful使用指南

按照 Django 的常规方法当然也可以实现REST,但有一种更快捷、强大的方法,那就是 Django REST framework.它是python的一个模块,通过在 Django 里面配置就可以把 app 的 models 中的各个表实现 RESTful API。具体实现方法如下:

安装配置

# 实现restful的模块
pip install djangorestframework==3.4.6
# 实现restful过滤功能的模块
pip install django-filter

注意:这里使用的是3.4.6版本的 djangorestframework ,不同版本之间的 djangorestframework 有所不同,可以故意打错版本号来查看 djangoframework 来查看有哪些版本。

安装完毕以上两个模块后,还需要将 rest_framework 作为 APP 添加到 settings.py 文件中。

INSTALLED_APPS = [
    ....
    'rest_framework',
]

创建model

在 stu APP中创建两张表,学生表和学生拓展信息表:

from django.db import models


# Create your models here.


class Student(models.Model):
    s_name = models.CharField(max_length=10)
    s_tel = models.CharField(max_length=11)

    class Meta:
        db_table = 'stu'


class StudentInfo(models.Model):
    i_addr = models.CharField(max_length=50)
    sid = models.OneToOneField(Student)

    class Meta:
        db_table = 'stu_info'

创建序列化类(Serializer)

创建序列化类的作用就是从你传入的参数中提取出你需要的数据,并把它转化为 json 格式返回。这里在stu文件夹下创建serializers.py,并添加如下内容:

from rest_framework import serializers
from stu.models import Student


class studentserializer(serializers.ModelSerializer):
    class Meta:
        model = Student
        fields = ['id', 's_name', 's_tel']

    def to_representation(self, instance):
        data = super().to_representation(instance)
        try:
            data['i_addr'] = instance.studentinfo.i_addr
        except:
            data['i_addr'] = ''
        return data

添加url路由

创建一个能够获取学生模型中数据的 API 接口路由:

from django.conf.urls import url
from rest_framework.routers import SimpleRouter

from stu import views

# 创建一个一个Simplerouter对象
routers = SimpleRouter()

# 注册获取数据的API接口路由,执行的视图为'views.showallstu'
routers.register(r'student', views.showallstu)
urlpatterns = []

# 将注册路由添加到django路由系统中
urlpatterns += routers.urls

url视图处理

对于普通的url请求我们是在views.py中定义的一个函数,但是对于RESTful是定义一个类,定义的showallstu类如下:

from django.shortcuts import render
from rest_framework import mixins, viewsets

# Create your views here.
from stu.models import Student
from stu.serializers import studentserializer


class showallstu(mixins.CreateModelMixin,  # 用于创建数据
                 mixins.DestroyModelMixin,  # 用于删除数据
                 mixins.UpdateModelMixin,   # 用于更新数据
                 mixins.RetrieveModelMixin, # 用于显示单个数据
                 mixins.ListModelMixin, # 用于显示所有数据
                 viewsets.GenericViewSet):
    # 设置要返回的内容queryset
    queryset = Student.objects.all()
    # 指定序列化类,将返回的内容序列化为json格式       
    serializer_class = studentserializer

到这里一个支持对学生表进行增、删、查、改的数据接口就做好了,我们可以使用接口调试神器POSTMAN来进行测试。

结果如下图:

Django - RESTful使用指南_第1张图片
postman调试结果


其他

自定义返回的json格式

通常对于一个请求,无论是否成功,我们都应该返回一些东西来告知其请求的结果,对于上面的这种如果没有数据,那么返回的便是一个空列表,因此我们需要自定义JSONRenderer。

自定义JSONRenderer的方法很简单,通过创建一个类去继承JSONRenderer,并重构其render方法,然后在settings.py文件中修改默认使用的renderer类为我们自定义的类即可。

在项目目录下创建文件夹utils,在utils目录下创建rendererresponse.py文件,添加如下代码自定义返回的json数据:

# 导入控制返回的JSON格式的类
from rest_framework.renderers import JSONRenderer


class customrenderer(JSONRenderer):
    # 重构render方法
    def render(self, data, accepted_media_type=None, renderer_context=None):
        if renderer_context:
            # 获取需要返回的msg和code信息,没有则赋值
            if isinstance(data, dict):
                msg = data.pop('msg', '请求成功')
                code = data.pop('code', 0)
            else:
                msg = '请求成功'
                code = 0
            # 重新构建返回的JSON字典
            ret = {
                'msg': msg,
                'code': code,
                'data': data,
            }
            # 返回JSON数据
            return super().render(ret, accepted_media_type, renderer_context)
        else:
            return super().render(data, accepted_media_type, renderer_context)

settings.py文件中,修改默认renderer类:

REST_FRAMEWORK = {

    # 修改默认返回JSON的renderer的类
    'DEFAULT_RENDERER_CLASSES': (
        'utils.rendererresponse.customrenderer',
    ),
}

返回的json数据格式为:

Django - RESTful使用指南_第2张图片
自定义返回json格式

异常处理

自定义异常处理,一定需要继承from rest_framework.exceptions import APIException 中的APIException,在编写自己的异常处理的方法:

Django - RESTful使用指南_第3张图片
异常处理

空值处理

除了对异常错误的处理之外,我们还要对传入数据是否是空值做处理。因为传入空值服务器会返回错误,如下图:

Django - RESTful使用指南_第4张图片
传入空值报错

如上图,如果传入的数据时空值的话,那么服务器就会返回一个 "This field may not be blank." 的报错。这时候我们需要在serializer中定义s_name的序列化,指定错误的信息,为空的话,提示响应的错误信息。

Django - RESTful使用指南_第5张图片
修改传入空值后返回结果

实现分页

通常用户获取的数据可能是有很多条的,我们是不可能所有的数据一起返回给用户的,明显那是不理智的,所以我们还需要对返回的数据做分页处理。

用 restful 实现分页很简单,只需要在settings.py中设置默认分页的类和分页的每页显示的条数即可:

REST_FRAMEWORK = {

    # 自定义返回的json格式
    'DEFAULT_RENDERER_CLASSES': (
        'utils.rendererresponse.customrenderer',
    ),

    # 设置分页(固定表达式)
    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',

    # 设置分页每页显示的信息数
    'PAGE_SIZE': 3,
}

分页后效果:

Django - RESTful使用指南_第6张图片
分页

注意: ' count ' 表示总存在的信息的条数, ' next '表示下一页的地址,' pervious ' 表示上一页的地址,null表示没有上一页。可以通过这几个参数知道是否还有下一页上一页。

数据过滤

通常在用户进行搜索和获取数据的时候都需要对数据进行过滤,在 restful 中要实现数据的过滤其实也很简单。先创建一个数据过滤的类,将可能用到的过滤方法都放到这个类下面,然后修改settings.py文件,添加默认过滤规则,然后修改视图函数指定过滤的类。

1.创建过滤的类

在utils目录下创建filters.py文件,并添加如下内容:

import django_filters
from rest_framework import filters
from stu.models import Student

class studentfilter(filters.FilterSet):
    # 表示以模糊搜索student表s_name中包含传入的name参数中的数据
    name = django_filters.CharFilter('s_name', lookup_expr='icontains')

    # 在s_tel字段中精确搜索传过来的tel参数的值,返回符合条件的结果
    tel = django_filters.CharFilter('s_tel')

    # 范围搜索
    max_yuwen = django_filters.NumberFilter('s_yuwen', lookup_expr='lte')
    min_yuwen = django_filters.NumberFilter('s_yuwen', lookup_expr='gte')

    class Meta:
        model = Student
        fields = ['id', 's_name', 's_tel', 's_yuwen']
2.修改配置文件

修改settings.py配置,设置默认过滤规则:

REST_FRAMEWORK = {
    # 设置过滤(固定写法)
    'DEFAULT_FILTER_BACKENDS': ('rest_framework.filters.DjangoFilterBackend',
                                'rest_framework.filters.SearchFilter',),
}

注意:在修改配置文件或者重构rest_framework的这些操作的时候,一定要注意单词拼写一定要正确,这些很多都是固定写法,如果写错了就可能导致不能运行出想要的结果。

3.修改视图文件

修改视图处理类,为其制定默认过滤的类,也可以指定排序规则:

from django.shortcuts import render
from rest_framework import mixins, viewsets

# Create your views here.
from stu.models import Student
from stu.serializers import studentserializer
from utils.filters import studentfilter


class showallstu(mixins.CreateModelMixin,
                 mixins.DestroyModelMixin,
                 mixins.UpdateModelMixin,
                 mixins.RetrieveModelMixin,
                 mixins.ListModelMixin,
                 viewsets.GenericViewSet):
    queryset = Student.objects.all()
    # 定义序列化的类
    serializer_class = studentserializer
    # 定义过滤的类
    filter_class = studentfilter

    # 指定排序规则
    def get_queryset(self):
        query = self.queryset
        return query.order_by('-id')
练习:

1.查名字中包含王的学习信息:

http://127.0.0.1:8000/stu/student/?name=王

Django - RESTful使用指南_第7张图片
王姓的学生信息

2.查找电话号码为911的学生信息:

http://127.0.0.1:8000/stu/student/?tel=911

Django - RESTful使用指南_第8张图片
电话查询结果

3.查找语文成绩小于60的所有学生信息:

http://127.0.0.1:8000/stu/student/?max_yuwen=60

Django - RESTful使用指南_第9张图片
成绩小于60学生信息

4.查找语文成绩在70到90之间的学生信息:

http://127.0.0.1:8000/stu/student/?min_yuwen=70&max_yuwen=90

Django - RESTful使用指南_第10张图片
成绩在70-90分的学生信息

5.查找语文成绩在70到90之间并姓王的学生信息:

http://127.0.0.1:8000/stu/student/?name=王&min_yuwen=70&max_yuwen=90

Django - RESTful使用指南_第11张图片
成绩在70-90之间的王姓学生

你可能感兴趣的:(Django - RESTful使用指南)