generics.ListCreateAPIView

#源码

class ListCreateAPIView(mixins.ListModelMixin,

                        mixins.CreateModelMixin,

                        GenericAPIView):

    """

    Concrete view for listing a queryset or creating a model instance.

    """

    def get(self, request, *args, **kwargs):

        return self.list(request, *args, **kwargs)

    def post(self, request, *args, **kwargs):

        return self.create(request, *args, **kwargs)

# 使用

# 导入generics

from rest_framework import generics

from ..models.models import Post # 模型类

from ..serializers import postSerializer # 序列化器

class PostList(generics.ListCreateAPIView):

    # 指定查询集

    queryset = Post.objects.all()

    # 指定序列化类

    serializer_class = postSerializer

 

从源码可以看出，generics.ListCreateAPIView继承了mixins.ListModelMixin, mixins.CreateModelMixin,GenericAPIView，里面写好了get和post方法使用了混合类的list和create方法，所以我们使用的时候，只需要定义queryset和serializer_calss，然后直接发送get、post请求就可以完成请求，如果需要功能扩展，可以重写get、post方法

 

GenericAPIView

 GenericAPIView继承APIView，将APIView的属性方法重 写扩展，并提供了一些新的方 属性

 

属性

 queryset

 """

 必须指定，用于从视图返回对象的查询结果集，通常，你必须设置此属性或者重写get_queryset()方法，

 如果你重写了一个视图的方法，你应该调用get_queryset()而不是直接访问该属性，因为queryset将被计算一次

 这些结果将为后续请求存储起来

 """

class PostList(generics.ListCreateAPIView):

    # 指定查询集

    queryset = Post.objects.all()

    # 指定序列化类

    serializer_class = postSerializer

    # 如果需要，可以重写queryset过滤一遍

    def get_queryset(self):

        ...

    def list(self, request):

        queryset = self.get_queryset() # 获queryset查询结果集

 

serializer_class

 """

 用户验证和反序列化输入以及用户序列号输出的serializer类，通常，你必须设置此属性或者重写get_serializer_class()方法

 """

class PostList(generics.ListCreateAPIView):

    # 指定查询集

    queryset = Post.objects.all()

    # 指定序列化类

    serializer_class = postSerializer

    # 如果有需求重写

    def get_serializer_class(self):

        if self.request.user.is_staff:

            return postSerializer

        return gettSerializer

    def list(self,requerst):

        queryset = self.get_queryset()

        serializer = self.get_serializer(queryset,many=True) # 获取serializer序列化器

 

lookup_field

"""

用于执行各个model实例的对下查找的model字段，默认为pk

注意:在使用超链接API时，如果需要使用自定义的值，需要确保在API和序列化类中都设置查找字段

"""

#url

path('run/<int:code>/', PostListDetail.as_view()),

#视图

class PostListDetail(mixins.RetrieveModelMixin,

                     mixins.UpdateModelMixin,

                     mixins.DestroyModelMixin,

                     generics.GenericAPIView):

    queryset = Post

    serializer_class = postSerializer

#不指定lookup_field ，默认就是pk，传值时只能是pk

    def get(self, request, pk):

        #APIView 不能使用get_object()方法获取参数值

        #继承APIView的其他扩展View，可以使用get_objcet()方法获取参数值，也可以直接传值

#指定lookup_field ，传值就是指定的值

lookup_field = 'test'

def get(self, request, test):

lookup_url_kwarg

"""

用于对象查找url关键字参数，他的url conf应该包括这应该与这个指相对于的关键字参数，如果取消设置

默认情况下使用与lookup_field相同的值

"""

#url

path('run/<str:code>/', PostListDetail.as_view()),

#视图

class PostListDetail(mixins.RetrieveModelMixin,

                     mixins.UpdateModelMixin,

                     mixins.DestroyModelMixin,

                     generics.GenericAPIView):

    queryset = Post

    serializer_class = postSerializer

    lookup_url_kwarg = 'code'

# 如果url内不包含lookup_url_kwarg的值，则会报错   

get_queryset()

"""

返回list视图中使用的查询集，该查询集还用做detail视图中的查找基础，默认返回由queryset属性指定的查询集

平时我们应该多使用这个方法，而不是直接访问self.queryset,因为self.queryset只会被提交一次

然后这些结果将为后续请求缓存起来，该方法可能会被重写以提供动态行为

"""

get_object()

"""

返回用于detail视图的对象实例，默认使用look_up_field参数过滤基本的查询集

该方法可以被重写以提供更复杂的行为，例如基于多个url参数的对象查找

"""

 

filter_queryset

"""

给定一个queryset，使用任何过滤器后端进行过滤，返回一个新的queryset

"""