HTTP中put，patch，post的区别(DRF)

最近在学习restful的过程中，偶遇put和patch，甚为不解。查阅资料后在此总结如下：

HTTP协议中请求的8中方法

• OPTIONS获取服务器支持的HTTP请求方法；
• HEAD跟get很像，但是不返回响应体信息，用于检查对象是否存在，并获取包含在响应消息头中的信息。
• GET向特定的资源发出请求，得到资源。
• POST向指定资源提交数据进行处理的请求，用于添加新的内容。
• PUT向指定资源位置上传其最新的内容，用于修改某个内容。
• DELETE请求服务器删除请求的URI所标识的资源，用于删除。
• TRACE回馈服务器收到的请求，用于远程诊断服务器。
• CONNECT用于代理进行传输，如使用ssl
  

其中GET、POST最为常见，GET\POST\PUT\DELETE\HEAD\OPTIONS最为常用，trace和connect暂且不谈。

GET：用于请求服务器上的数据，理解为读取就好了。DRF中generics.ListAPIView源码如下：

class ListAPIView(mixins.ListModelMixin,
                  GenericAPIView):
    """
    Concrete view for listing a queryset.
    """
    def get(self, request, *args, **kwargs):
        return self.list(request, *args, **kwargs)

class ListModelMixin(object):
    """
    List a queryset.
    """
    def list(self, request, *args, **kwargs):
        queryset = self.filter_queryset(self.get_queryset())

        page = self.paginate_queryset(queryset)
        if page is not None:
            serializer = self.get_serializer(page, many=True)
            return self.get_paginated_response(serializer.data)

        serializer = self.get_serializer(queryset, many=True)
        return Response(serializer.data)

说明PUT/POST/PATCH方法前先引入一个概念，幂等，来帮助我们更好地理解这几种方法的区别。

幂等idempotent :如果一个方法重复执行多次，产生的效果是一样的，那就是幂等的。幂等的意思是如果相同的操作再执行第二遍第三遍，结果还是一样。

关于POST/PUT/PATCH/的区别

POST：用来创建一个子资源

如 /api/users，会在users下面创建一个user，如users/1；POST方法不是幂等的，多次执行，将导致多条相同的条目被创建。（比如在提交表单时刷新，会POST多个相同的表单给服务器）。重点：POST不是幂等的。

PUT：比较正确的定义是Create or Update
例如 PUT /items/1 的意思是替换 /items/1 ，存在则替换，不存在则创建。
所以，PUT方法一般会用来更新一个已知资源。

PATCH：是对PUT方法的补充，用来对已知资源进行局部更新，PATCH是幂等的。

POST /api/articles
PUT /gists/:id/stars
如果产生两个资源，就说明这个服务不是idempotent（幂等的），因为多次使用产生了副作用；如果后一个请求把第一个请求覆盖掉了，那这个服务就是idempotent的。
前一种情况，应该使用POST方法；
后一种情况，应该使用PUT方法。

搞清楚这个概念我们再来看看源码。

POST:向服务器提交数据，常见的提交表单都是POST方法。DRF中generics.ListAPIView源码如下：

class CreateAPIView(mixins.CreateModelMixin,
                    GenericAPIView):

    """
    Concrete view for creating a model instance.
    """
    def post(self, request, *args, **kwargs):
        return self.create(request, *args, **kwargs)

class CreateModelMixin(object):
    """
    Create a model instance.
    """
    def create(self, request, *args, **kwargs):
        serializer = self.get_serializer(data=request.data)
        serializer.is_valid(raise_exception=True)
        self.perform_create(serializer)
        headers = self.get_success_headers(serializer.data)
        return Response(serializer.data, status=status.HTTP_201_CREATED, headers=headers)

    def perform_create(self, serializer):
        serializer.save()

    def get_success_headers(self, data):
        try:
            return {'Location': data[api_settings.URL_FIELD_NAME]}
        except (TypeError, KeyError):
            return {}

PUT/PATCH:

class UpdateAPIView(mixins.UpdateModelMixin,
                    GenericAPIView):

    """
    Concrete view for updating a model instance.
    """

    def put(self, request, *args, **kwargs):
        return self.update(request, *args, **kwargs)

    def patch(self, request, *args, **kwargs):
        return self.partial_update(request, *args, **kwargs)

class UpdateModelMixin(object):
    """
    Update a model instance.
    """
    def update(self, request, *args, **kwargs):
        partial = kwargs.pop('partial', False)
        instance = self.get_object()
        serializer = self.get_serializer(instance, data=request.data, partial=partial)
        serializer.is_valid(raise_exception=True)
        self.perform_update(serializer)
        return Response(serializer.data)

DELETE:删除服务器上的某个资源。DRF中源码如下：

class DestroyAPIView(mixins.DestroyModelMixin,
                     GenericAPIView):

    """
    Concrete view for deleting a model instance.
    """
    def delete(self, request, *args, **kwargs):
        return self.destroy(request, *args, **kwargs)

class DestroyModelMixin(object):
    """
    Destroy a model instance.
    """
    def destroy(self, request, *args, **kwargs):
        instance = self.get_object()
        self.perform_destroy(instance)
        return Response(status=status.HTTP_204_NO_CONTENT)

    def perform_destroy(self, instance):
        instance.delete()

这段代码就完全可以对应CRUD，DRF还是封装的很好的

class RetrieveUpdateDestroyAPIView(mixins.RetrieveModelMixin,
                                   mixins.UpdateModelMixin,
                                   mixins.DestroyModelMixin,
                                   GenericAPIView):
    """
    Concrete view for retrieving, updating or deleting a model instance.
    """
    def get(self, request, *args, **kwargs):
        return self.retrieve(request, *args, **kwargs)

    def put(self, request, *args, **kwargs):
        return self.update(request, *args, **kwargs)

    def patch(self, request, *args, **kwargs):
        return self.partial_update(request, *args, **kwargs)

    def delete(self, request, *args, **kwargs):
        return self.destroy(request, *args, **kwargs)

最后是OPTIONS和HEAD

HEAD：只请求页面的首部

OPTIONS:它用于获取当前URL所支持的方法。如果请求成功，会有一个Allow的头包含类似“GET,POST”这样的信息