DRF之过滤排序分页异常处理

一、过滤

对于列表数据要通过字段来进行过滤，就需要添加 django-filter 模块

使用方法：

# 1、注册，在app中注册 settings.py
INSTALLED_APPS = [
    'django_filters',
]

# 2、settings.py 配置
REST_FRAMEWORK = {
    'DEFAULT_FILTER_BACKENDS': (
        'django_filters.rest_framework.DjangoFilterBackend',
    )
}

# 3、在视图中添加filter_fields属性，指定过滤的字段
class BooksView(ModelViewSet):
    queryset = Books.objects.all()
    serializer_class = BooksSerializer

    filter_fields = ('title',)	# 配置可以按照哪个字段来过滤

# http://127.0.0.1:8000/books/?title=红楼梦

二、排序

排序可以使用 Rest Framework 提供的 OrderingFilter 来快速指明数据按指定字段进行排序

使用方法：

# 1、首先视图中设置filter_backends=[OrderingFilter]
# 2、然后再视图中添加 ordering_fields 属性，指定排序字段

from rest_framework.filters import OrderingFilter
class BooksView(ModelViewSet):
    queryset = Books.objects.all()
    serializer_class = BooksSerializer

    filter_backends = [OrderingFilter]	# 第一步
    ordering_fields = ['price','id']	# 第二步

# http://127.0.0.1:8000/books/?ordering=id	通过ordering查看有无指明排序的字段，并通过字段来排序
# -id 表示针对id字段进行倒序排序
# id  表示针对id字段进行升序排序

三、分页

首先 Rest Framework 提供了三种分页方式，并且

• PageNumberPagination
• LimitOffsetPagination
• CursorPagination

使用方式一：可以直接继承使用，但是配置参数需要在settings.py里面配置

使用方式二：通过子类继承父类分页器使用，直接在子类中修改父类的参数（推荐）

PageNumberPagination

子类中的属性：

• page_size：每页数目
• page_query_param：前端发送的页数关键字，默认“page”
• page_size_query_param：前端发送每页数目关键字名，默认None
• max_page_size：前端最多能设置的每页数量

如何使用：

from rest_framework.generics import ListAPIView
from rest_framework.pagination import PageNumberPagination
from app01.models import Books
from app01.ser import BooksSerializer

# 第一步：
class BookPageNumberPagination(PageNumberPagination):
    page_size = 3         # 每页条数
    page_query_param = 'page'   # 查询第几页的key
    page_size_query_param = 'size'  # 每一页显示的条数
    max_page_size = 5   # 每页最大条数

class BookView(ListAPIView):
    queryset = Books.objects.all()
    serializer_class = BooksSerializer

    # 第二步：分页配置
    pagination_class = BookPageNumberPagination

# url：http://127.0.0.1:8000/books/?page=1&size=5	查询第1页，一共显示五条数据

LimitOffsetPagination

子类中的属性：

• default_limit：默认限制，默认值与PAGE_SIZE设置一致
• limit_query_param：limit参数名，默认’limit’
• offset_query_param：offset参数名，默认’offset’
• max_limit：最大limit限制，默认None

如何使用：

from rest_framework.generics import ListAPIView
from rest_framework.pagination import LimitOffsetPagination
from app01.models import Books
from app01.ser import BooksSerializer

# 第一步：
class BookLimitOffsetPagination(LimitOffsetPagination):
    default_limit = 3           # 每页条数
    limit_query_param = 'limit'     # 往后拿几条
    offset_query_param = 'offset'   # 从第几条往后拿几条的标杆
    max_limit = 5       # 每页最大拿几条

class BookView(ListAPIView):
    queryset = Books.objects.all()
    serializer_class = BooksSerializer

    # 第二步：分页配置
    pagination_class = BookLimitOffsetPagination

# url：http://127.0.0.1:8000/books/?limit=3&offset=4 	从第三条开始往后拿4条数据

CursorPagination

子类中的属性：

• cursor_query_param：默认查询字段，不需要修改
• page_size：每页数目
• ordering：按什么排序，需要指定

如何使用：

CursorPagination的查询速度快，但是却不能定位到第几页这样查，要么往前查，要么往后查。

from rest_framework.generics import ListAPIView
from rest_framework.pagination import CursorPagination
from app01.models import Books
from app01.ser import BooksSerializer

# 第一步：
class BookCursorPagination(CursorPagination):
    cursor_query_param = 'cursor'   # 每页查询的key
    page_size = 3       # 每页显示条数
    ordering = 'id'    # 排序字段

class BookView(ListAPIView):
    queryset = Books.objects.all()
    serializer_class = BooksSerializer

    # 第二步：分页配置
    pagination_class = BookCursorPagination

# url：http://127.0.0.1:8000/books/?cursor=cD0z

继承APIView使用方法

像方式一，方式二这样使用的话，就要视图类是继承 ListAPIView 然后直接配置就可以了

但是如果视图类继承的是 GenericAPIView 或者 APIView 的话，就需要用另一种方式了：

使用方法：

# 1、定义一个分页器
class BookPageNumberPagination(PageNumberPagination):
    page_size = 3         # 每页条数
    page_query_param = 'page'   # 查询第几页的key
    page_size_query_param = 'size'  # 每一页显示的条数
    max_page_size = 5   # 每页最大条数

class BookView(APIView):

    def get(self, request, *args, **kwargs):
        book_list = Books.objects.all()

        # 2、实例化得到一个分页器对象
        page_obj = BookPageNumberPagination()

        # 3、调用paginate_queryset返回每一页的数据
        book_list = page_obj.paginate_queryset(book_list, request, view=self)

        # 4、获取上一页下一页链接
        next_url = page_obj.get_next_link()
        previous_url = page_obj.get_previous_link()

        # 5、序列化
        book_ser = BooksSerializer(book_list, many=True)

        # 6、加入响应信息中
        data = {'next_url': next_url, 'previous_url': previous_url, 'data': book_ser.data}
        return Response(data=data)

四、异常处理

异常处理主要是用来统一接口返回

源码分析

异常处理在APIView的api_settings已经配置好了

'EXCEPTION_HANDLER': 'rest_framework.views.exception_handler',

def exception_handler(exc, context):
    # 先判断是不是404
    if isinstance(exc, Http404):	# exc是异常信息的异常对象
        exc = exceptions.NotFound()
    # 然后判断是不是权限的问题
    elif isinstance(exc, PermissionDenied):
        exc = exceptions.PermissionDenied()		# 比如权限问题会返回一个字典

	# 在判断你抛出的是不是API的异常——>认证权限这些都是继承了API的异常
    if isinstance(exc, exceptions.APIException):
        headers = {}
        if getattr(exc, 'auth_header', None):
            headers['WWW-Authenticate'] = exc.auth_header
        if getattr(exc, 'wait', None):
            headers['Retry-After'] = '%d' % exc.wait

        if isinstance(exc.detail, (list, dict)):
            data = exc.detail
        else:
            data = {'detail': exc.detail}

        set_rollback()
        return Response(data, status=exc.status_code, headers=headers)
    # 只要是上面这些异常都做了处理

    return None		# 意味有些异常它没有处理，就会交给Django自己处理

如何处理

因为dir有些异常它不做处理，Django处理的又不符合我们的标准，所以就要写一个统一的异常类来替换掉它，把所有情况都处理，只要前端出异常看到的都是固定的东西。

如何写：

重写一个类，和它基本上差不多，配置的时候在 settings.py 里面全局配置

#  app01_auth.py
from rest_framework.views import exception_handler
from rest_framework.response import Response

def app01_exception_handler(exc, context):
    response = exception_handler(exc, context)  # 原来的drf处理的我们也需要
    # 两种情况，一个是None，drf没有处理，Django处理了，但是处理的不符合需求
    # response对象，drf处理了我们需要的

    if not response:
        # 如果没处理，那么我们自己处理
        return Response(data={'status': 400, 'error': str(exc)}, status=400)
    else:
        # drf 处理了，那么取出它处理的信息，重新处理一下
        return Response(data={'status': 400, 'error': response.data.get('detail')}, status=400)

然后再全局配置一下：settings.py

REST_FRAMEWORK = {
    'EXCEPTION_HANDLER': 'app01.app_auth.app01_exception_handler',
}

五、封装Response对象

class APIResponse(Response):
    def __init__(self,code=100,msg='成功',data=None,status=None,headers=None,**kwargs):

        dic = {'code': code, 'msg': msg}

        if  data:
            dic = {'code': code, 'msg': msg,'data':data}

        dic.update(kwargs)

        super().__init__(data=dic, status=status,headers=headers)

# 使用
return APIResponse(data={"name":'xiaoyang'},token='dsafsdfa',aa='dsafdsfdee')
return APIResponse(data={"name":'xiaoyang'})
return APIResponse(code='101',msg='错误',data={"name":'xiaoyang'},token='dsafsdfa',aa='dsafdsfdee',header={})