restfull规范、DRF视图和路由

一、restfull规范的简单介绍

1、介绍

REST：表述性状态转移，是一种web交互方案

资源：在web中只要有被引用的必要都是资源

URI：
　　URI 统一资源标识符
　　URL 统一资源定位符

统一资源接口
　　根据HTTP请求方式的不同对资源进行不同的操作
　　遵循HTTP请求方式的语义

前后端传输的叫资源的表述

前端展现的叫资源的状态

通过超链接的指引告诉用户接下来有哪些资源状态可以进入

2、restfull规范

核心思想
    -- 面向资源去编程
        每个url就是资源的体现 尽量用名词不要用动词
    -- 根据HTTP请求方式的不同对资源进行不同的操作

URL体现
    -- 版本
        https://v3.bootcss.com
        https://bootcss.com/v3
    -- 体现是否是API
        https://v3.bootcss.com/api
    -- 过滤信息
        https://v3.bootcss.com?page=1
    -- 尽量用HTTPS

返回值体现
    -- 携带状态码
    -- 携带错误信息
    -- 返回值
        get  返回查看的所有或者单条信息
        post 返回新增的那条数据
        put/patch 返回更新那条数据
        delete  返回空
    -- 携带超链接

二、DRF的视图的封装

1、为什么要封装

当有很多个表进行增删改查时，实际上很多代码都是相同的，只是要获取的queryset和序列化器等不同，这就导致我们的视图有特别多重复的代码，
因此对视图进行封装，可减少代码的冗余。

2、要封装的原视图

class BookView(APIView):
    def get(self, request):
        book_queryset = Book.objects.all()
        ser_obj = BookSerializer(book_queryset, many=True)
        return Response(ser_obj.data)

    # 新增书籍
    def post(self, request):
        book_obj = request.data
        ser_obj = BookSerializer(data=book_obj)
        if ser_obj.is_valid():
            ser_obj.save()
            print(ser_obj.validated_data)
            return Response(ser_obj.data)
        # 校验不通过返回错误信息
        return Response(ser_obj.errors)

# 编辑书籍
class BookEditView(APIView):
    def get(self, request, id):
        book_obj = Book.objects.filter(pk=id).first()
        ser_obj = BookSerializer(book_obj)
        return Response(ser_obj.data)

    def put(self, request, id):
        book_obj = Book.objects.filter(id=id).first()
        ser_obj = BookSerializer(instance=book_obj, data=request.data, partial=True)
        if ser_obj.is_valid():
            ser_obj.save()
            return Response(ser_obj.data)
        return Response(ser_obj.errors)

    def delete(self, request, id):
        book_obj = Book.objects.filter(id=id).first()
        if book_obj:
            book_obj.delete()
            return Response('')
        return Response('删除对象不存在')

3、第一次封装

# 获取query_set和序列化器的类
class GenericAPIView(APIView):
    query_set = None
    serializer_class = None

    def get_queryset(self):
        return self.query_set

    def get_serializer(self, *args, **kwargs):
        return self.serializer_class(*args, **kwargs)

# 实现get方法的类
# 小知识点：一般Mixin代表的是混合类，单独继承ListModelMixin你去哪里找get_queryset方法
# 因此，其他类继承Mixin类的时候，还应该多继承其他的某些类
class ListModelMixin(object):
    def list(self, request):
        queryset = self.get_queryset()
        ser_obj = self.get_serializer(queryset, many=True)
        return Response(ser_obj.data)

# 实现post方法的类
class CreateModelMixin(object):
    def create(self, request):
        # 获取前端传过来的数据
        obj = request.data
        # 用序列化器做校验
        ser_obj = self.get_serializer(data=obj)
        if ser_obj.is_valid():
            # 校验通过，新增书籍
            ser_obj.save()  # 这里的save方法会去调用序列化器的create方法
            print(ser_obj.validated_data)  # validated_data是通过校验的数据，也会封装到data里面
            return Response(ser_obj.data)
        # 校验不通过返回错误信息
        return Response(ser_obj.errors)

# 实现编辑的get方法的类
class RetrieveModelMixin(object):
    def retrieve(self, request, id):
        book_obj = self.get_queryset().filter(pk=id).first()
        ser_obj = self.get_serializer(book_obj)
        return Response(ser_obj.data)

# 实现编辑的put方法的类
class UpdateModelMixin(object):
    def update(self, request, id):
        book_obj = self.get_queryset().filter(id=id).first()
        ser_obj = self.get_serializer(instance=book_obj, data=request.data, partial=True)
        if ser_obj.is_valid():
            ser_obj.save()
            return Response(ser_obj.data)
        return Response(ser_obj.errors)

# 实现删除delete方法的类
class DestroyModelMixin(object):
    def destroy(self, request, id):
        book_obj = self.get_queryset().filter(id=id).first()
        if book_obj:
            book_obj.delete()
            return Response("")
        return Response("删除的对象不存在")

# 书籍列表
class BookView(GenericAPIView,ListModelMixin, CreateModelMixin):
    query_set = Book.objects.all()
    serializer_class = BookSerializer

    def get(self, request):
        return self.list(request)

    def post(self, request):
        return self.create(request)

class BookEditView(GenericAPIView, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin):
    query_set = Book.objects.all()
    serializer_class = BookSerializer

    def get(self, request, id):
        return self.retrieve(request, id)

    def put(self, request, id):
        return self.update(request, id)

    def delete(self, request, id):
        return self.destroy(request, id)

4、第二次封装

由于上面的继承太长了，因此我们细化一点点，其实就是在第一次封装的基础上另外设置一些类来进行了继承。

# 继承上面需要的类，别的类只需继承这个类即可使用这个类继承的方法
class ListCreateModelMixin(GenericAPIView,ListModelMixin, CreateModelMixin):
    pass

class RetrieveUpdateDestroyModelMixin(GenericAPIView, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin):
    pass

# 书籍列表
class BookView(ListCreateModelMixin):
    query_set = Book.objects.all()
    serializer_class = BookSerializer

    def get(self, request):
        return self.list(request)

    def post(self, request):
        return self.create(request)

class BookEditView(RetrieveUpdateDestroyModelMixin):
    query_set = Book.objects.all()
    serializer_class = BookSerializer

    def get(self, request, id):
        return self.retrieve(request, id)

    def put(self, request, id):
        return self.update(request, id)

    def delete(self, request, id):
        return self.destroy(request, id)

5、第三次封装

1. DRF框架的ViewSetMixin类重写了CBV的as_view方法，使其可以接收参数，路由分发的时候会根据参数进行分发，
继承了ViewSetMixin的类，它的路由as_view可以传参

2. urls.py
from django.conf.urls import url
from libsys import views

urlpatterns = [
    url(r'^list/$', views.BookModelView.as_view({"get": "list", "post": "create"})),
    url(r'^retrieve/(?P<id>\d+)/$', views.BookModelView.as_view({"get": "retrieve", "put": "update", "delete": "destroy"})),
]

3. 第三次封装
from rest_framework.viewsets import ViewSetMixin  # 重写as_view使其可以传参

# 继承上面需要的类，别的类只需继承这个类即可使用这个类继承的方法
class ListCreateModelMixin(GenericAPIView,ListModelMixin, CreateModelMixin):
    pass

class RetrieveUpdateDestroyModelMixin(GenericAPIView, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin):
    pass

# 五合一的视图
# ViewSetMixin必须在GenericAPIView前面，因为需要ViewSetMixin先做路由的分发
class ModelViewSet(ViewSetMixin, ListCreateModelMixin, RetrieveUpdateDestroyModelMixin):
    pass

class BookModelView(ModelViewSet):
    # 这里什么都不用写了，因为as_view重写后，某个请求进来会默认去找它对应的方法
    # 这里找不到，就会去父类中找
    query_set = Book.objects.all()
    serializer_class = BookSerializer

6、使用DRF框架帮我们封装好的模块

1. 直接使用DRF自带的ModelViewSet(DRF的ModelViewSet也是继承了ViewSetMixin和那6个方法的类)
注意：
    DRF中使用queryset，我们自定义的是query_set
用框架封装的视图，我们url上的那个关键字参数要用pk，系统默认的

2. urls.py
from django.conf.urls import url
from libsys import views

urlpatterns = [
    url(r'^list/$', views.BookModelView.as_view({"get": "list", "post": "create"})),
    url(r'^retrieve/(?P<pk>\d+)/$', views.BookModelView.as_view({"get": "retrieve", "put": "update", "delete": "destroy"})),
]

3. 视图
from rest_framework.viewsets import ModelViewSet  # 这里的ModelViewSet是DRF给我们的类

class BookModelView(ModelViewSet):
    queryset = Book.objects.all()
    serializer_class = BookSerializer

三、路由

from rest_framework.routers import DefaultRouter
第一步实例化对象
router = DefaultRouter()

第二步把路由以及视图注册到对象
router.register('list', views.BookModelView)  # 路径，视图

第三步生成可传参的路由
urlpatterns += router.urls

注意：用默认生成的路由，必须保证你的视图函数是继承了ViewSetMixin，即你的as_view方法是可以传参的

在浏览器中就可以输入：
list/
list/1
list/2
...

还额外生成了不用模板的数据路由
list.json
list/1.json

四、DRF框架视图类

1、DRF给我们提供的所有视图，都在这几个模块下

from rest_framework import views
from rest_framework import viewsets
from rest_framework import mixins
from rest_framework import generics

2、这几个模块主要封装的类

from rest_framework import views
# 封装了APIView
# class APIView(View)

from rest_framework import viewsets
# 封装了ViewSetMixin
# class ViewSetMixin(object)

from rest_framework import mixins
# 封装了我们请求的5个方法的类
# class CreateModelMixin(object)

# class ListModelMixin(object)

# class RetrieveModelMixin(object)

# class UpdateModelMixin(object)

# class DestroyModelMixin(object)

from rest_framework import generics
# 封装了我们获取queryset和serializer方法的类
# class GenericAPIView(views.APIView):
#     def get_queryset()
#     def get_object()
#     def get_serializer()

3、ModelViewSet