使用APIView()实现自定义分页和筛选的API视图

APIView是Django Rest Framework提供的一个基类，用于实现基于类的API视图。它提供了常见的HTTP方法（GET、POST、PUT、DELETE）的默认实现，以及针对分页和过滤等功能的扩展。

首先，我们将导入需要的库和模块：

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework.pagination import PageNumberPagination
from myapp.models import MyModel
from myapp.serializers import MyModelSerializer

接下来，我们定义一个自定义的分页类，继承自PageNumberPagination：

class CustomPagination(PageNumberPagination):
    page_size = 10  # 每页默认显示的数据条数
    page_size_query_param = 'page_size'  # 页面参数名称，用于指定每页显示的数据条数

    # 获取当前页数
    def get_page_number(self, request, paginator):
        try:
            page_number = int(request.query_params.get('page', 1))
        except ValueError:
            page_number = 1
        return page_number

    # 获取当前页的数据
    def get_paginated_data(self, data):
        return {
            'count': self.page.paginator.count,  # 总数据条数
            'next': self.get_next_link(),  # 下一页的URL
            'previous': self.get_previous_link(),  # 上一页的URL
            'results': data  # 当前页的数据
        }

然后，我们定义一个自定义的API视图类，继承自APIView，并使用自定义的分页类和筛选条件：

class MyModelAPIView(APIView):
    pagination_class = CustomPagination

    def get(self, request):
        queryset = MyModel.objects.all()  # 查询所有的数据
        serializer = MyModelSerializer(queryset, many=True)  # 序列化数据

        # 根据筛选条件进行过滤
        filters = {
            'field1': request.query_params.get('field1'),
            'field2': request.query_params.get('field2'),
            # ...
        }
        filtered_queryset = self.filter_queryset(queryset, filters)

        # 分页并返回数据
        page = self.paginate_queryset(filtered_queryset)
        serializer = MyModelSerializer(page, many=True)
        return self.get_paginated_response(serializer.data)

    # 筛选数据
    def filter_queryset(self, queryset, filters):
        if filters['field1']:
            queryset = queryset.filter(field1=filters['field1'])
        if filters['field2']:
            queryset = queryset.filter(field2=filters['field2'])
        # ...
        return queryset

    # 分页数据的扩展方法
    def get_paginated_response(self, data):
        return Response(self.pagination_class().get_paginated_data(data))

最后，我们可以在项目的urls.py中使用这个自定义的API视图：

from django.urls import path
from myapp.views import MyModelAPIView

urlpatterns = [
    path('api/mymodel/', MyModelAPIView.as_view()),
]

这样，我们就实现了一个自定义分页和筛选的API视图。当调用/api/mymodel/的GET方法时，可以根据请求的参数进行数据的过滤，并返回分页后的数据结果。例如，调用/api/mymodel/?page=2&page_size=20&field1=value1&field2=value2，将返回第2页，每页20条数据，并根据field1和field2的值进行筛选后的结果。

使用例子：

# 使用curl命令进行测试
$ curl http://localhost:8000/api/mymodel/?page=2&page_size=20&field1=value1&field2=value2

返回结果：

{
    "count": 100, 
    "next": "http://localhost:8000/api/mymodel/?page=3&page_size=20&field1=value1&field2=value2",
    "previous": "http://localhost:8000/api/mymodel/?page=1&page_size=20&field1=value1&field2=value2",
    "results": [
        {
            "field1": "value1",
            "field2": "value2",
            ...
        },
        ...
    ]
}

通过以上示例，我们可以看到，通过自定义分页类和筛选条件，我们可以灵活地实现自己想要的API视图。我们可以根据实际需求，进行分页和筛选的定制，提供更好的用户体验。