# 视图函数中

from rest_framework.views import APIView  # 类视图中使用,集成自该类

from rest_framework.decorators import api_view # 方法视图中使用,是一个装饰器,直接装饰方法视图

from django.contrib.auth.decorators import login_required # 原生django自带的登录验证装饰器

from rest_framework import status

from rest_framework.response import Response # 直接可以将字典数据转换成json数据

from api.models import Snippet

from api.serializers import SnippetSerializer

from rest_framework.request import Request

from rest_framework import exceptions

@api_view(['GET', 'POST', 'PUT', 'DELETE']) # 指明允许那些请求方式进行请求
@login_required
def api_list(request):

    """

    :param request:

    :return: list all snippets or create a new snippet

    """

    if request.method == 'GET':

        # 向数据库查询数据，得到查询集

        try:

            query_set = Snippet.objects.all()

        except Snippet.DoesNotExist:

            return Response(status=status.HTTP_417_EXPECTATION_FAILED)

        # 调用序列化类对象,返回进行了序列化的字段集合,使用serializers.data方式 获取数据

        serializers = SnippetSerializer(query_set, many=True)

        # 取出数据，向客户端进行返回，Response()会将数据转化为json数据.

        return Response(serializers.data, status=status.HTTP_200_OK)

     # 前端提交数据，调用模型，将其保存到数据库中

    elif request.method == 'POST':

        #  从request对象中取出数据，将其反序列化，返回反序列化的对象

        serializer = SnippetSerializer(data= request.data)

        # 如果反序列化的对象存在，就说明数据有效，将数据保存到数据库中

        if serializer.is_valid():

            # 调用save(), 从而调用序列化对象的create()方法,创建一条数据

            serializer.save()

            return Response(serializer.data, status=status.HTTP_200_OK)

        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

    # 修改数据

    elif request.method == 'PUT':

        # 在rest framework 中 request对象是经过封装的

        id = request.query_params.get('id')

        try:

            query_set = Snippet.objects.get(id = id)

        except Snippet.DoesNotExist:

            return Response(status=status.HTTP_417_EXPECTATION_FAILED)

        serializer = SnippetSerializer(query_set,data=request.data)

        # 如果反序列化对象存在,就调用save()方法,从而调用update()方法 更新数据

        if serializer.is_valid():

            serializer.save()

        return Response(serializer.data, status=status.HTTP_200_OK)

    elif request.method == 'DELETE':

        id = request.query_params.get('id')

        try:

            query_set = Snippet.objects.get(id=id)

        except Snippet.DoesNotExist:

            return Response(status=status.HTTP_417_EXPECTATION_FAILED)

        # 如果需要删除数据,直接调用delete()即可以

        query_set.delete()

        return Response(status=status.HTTP_204_NO_CONTENT)

# 请求对象

# REST框架介绍了一个 请求(Request)对象,它扩展了常规的HttpResquest  ，

# 并且，提供更灵活的请求解析。请求(Request)对象的核心功能是 request.data属性，

# 这个属性与原生django的request.POST相似，但是它对Web APIs更加有用。

# request.POST 只处理表单数据。只对'POST'方法起作用。

# drf 的 request.data 可以处理任意数据。对'POST','PUT','PATCH'方法起作用。
# 使用 drf 获取GET请求的请求参数方式为 request.query_params 返回字典

# 响应对象

# REST框架也介绍了Response对象，它是一类用未渲染内容和内容协商来决定正确的内容类型并把它返回给客户端的模板响应(TemplateResponse)  。

# return Response(data) 根据客户端的请求来渲染成指定的内容类型

# 状态码

# 总是在你的视图中用数字的HTTP状态码会更加容易理解，并且如果你用其他错误

# 代码表示错误,就不太容易注意到了。REST框架为每个状态码(status code)提供

# 更明确的标识符，例如在状态(status)模型中的 HTTP_400_BAD_REQUEST 就可以表实请求错误 (from rest_framework import status)

# 装饰API视图

# REST框架提供两个装饰器，你可以用它们来写API视图。

# @api_view  装饰器用在基于视图的方法上。from rest_framework.decorators import api_view
# APIView  类用在基于视图的类上. from rest_framework.views import APIView

# 路由匹配

# 在匹配到应用的urls.py文件中,匹配方式如下:

from django.contrib import admin

from django.urls import path,include

urlpatterns = [

    path('admin/', admin.site.urls),

    path(r'api-auth/',include('rest_framework.urls', namespace='rest_framework')),

    path(r'api/', include('api.urls')), 路由到api 这个 app 的 urls.py

]

# 在匹配到视图urls.py中,匹配方式如下:

from django.conf.urls import url

# 用来添加格式后缀模式

from rest_framework.urlpatterns import format_suffix_patterns

from api.views import api_list,snippet_detail,UserDetail, UserList

urlpatterns = [

    url(r'^snippet/$', api_list),

    url(r'^snippet/(?P<pk>[0-9]+)/$', snippet_detail),

    url(r'users/$', UserList.as_view()),

    url(r'users/(?P<pk>[0-9]+)/$', UserDetail.as_view() name="user_data"), 路由到视图中

]

from rest_framework.views import APIView # 类视图父类

from rest_framework import status # 状态码

from rest_framework.response import Response # 生成响应对象

from rest_framework import permissions # 进行访问用户的验证

class ViewSet(APIView):

    # 进行用户有效性验证

    # permission_classes = [permissions.IsAuthenticated]

    # 允许任何用户进行访问该视图的接口,包括匿名用户, 在某些场景中, 必须设置验证用户的方式,否则会抛出异常

    permission_classes = [permissions.AllowAny]

    def get(self, request):

        return Response(status=status.HTTP_204_NO_CONTENT)

    def post(self, request):

        return Response(status=status.HTTP_204_NO_CONTENT)