# restful是一种定义web API接口的设计风格,适用于前后端分离的应用模式中

# 关于restful的10个规范

   -1.数据的安全保障，通常使用https协议（http+ssl/tsl）

        url链接一般都采用https协议进行传输，https协议可以提高数据交互过程中的安全性

   -2.接口中带api标识

        https://api.lqz.com/books

        https://www.lqz.com/api/books

   -3.多版本共存，路径中带版本信息

        https://api.lqz.com/v1/login

        https://www.lqz.com/api/v2/login

   -4.数据就是资源，均使用名词，尽量不出现动词(核心)

        - 1).接口一般都是前后台数据的交互，交互的数据我们称之为资源

        - 2).接口形式： https://api.baidu.com/users

                         https://api.baidu.com/books

        - 3).特殊的接口可以出现动词，因为这些接口一般没有一个明确的资源，或者动词就是接口的核心含义

                         https://api.baidu.com/login

   -5.资源操作由请求方式决定(method)

        - 我们一般提供请求方式来标识增删改查动作

           https://api.baidu.com/books     - get请求：获取所有书

           https://api.baidu.com/books/1  - get请求：获取主键为1的书

           https://api.baidu.com/books     - post请求：新增一本书书

           https://api.baidu.com/books/1  - put请求：修改主键为1的书

           https://api.baidu.com/books/1  - delete请求：删除主键为1的书

   -6.在请求地址中带过滤条件

        https：//api.baidu.com/books?name=xxx&price=xx

   -7.响应中状态码：两套

        1).http响应状态码：

             1xx：请求正在处理

             2xx：成功响应

             3xx：重定向

             4xx:  客户端错误

             5xx：服务端错误

        2).公司内部自己规定的状态码：

             放在响应体里  ： {code:0}

   -8.返回数据中带错误信息

        {

             code:0

             msg:"ok/用户名错误"

        }

   -9.返回的结果应该符合以下规范

         -1).GET 获取所有数据：返回资源对象的列表（数组）[{name:红楼梦，price：99}，{name:红楼梦，price：99}，{name:红楼梦，price：99}]

         -2).GET 单个对象：返回单个资源对象：{name:红楼梦，price：99}

         -3).POST 新增对象：返回新生成的资源对象：{name:西游记，price：99}

         -4).PUT 修改对象：返回完整的资源对象 ：{name:西游记，price：100}

         -5).DELETE 删除：返回一个空文档

    -10.响应数据中带链接  

# 序列化：把我们识别的数据转换成指定格式提供给别人

    - read

    字典，列表以json格式存到文件中

    例：在django中获取到的数据默认是模型对象，无法直接提供给前端等使用，所以需要把数据序列化，变成字符串或json数据，提供给别人

# 反序列化：把别人提供的数据转换/还原成我们需要的格式

    - write

    例：前端js提供过来的json数据，对于python就是字符串，我们需要反序列化成模型类对象，才能将其保存到数据库中

# 以后所遇到的所有的接口都是五个接口及其变形

    1.查询单个

    2.查询所有

    3.新增单个

    4.修改单个

    5.删除单个

# 给予books表写5个接口

    -1.创建book表

    -2.表迁移

    -3.录入假数据：直接录，后台管理录

    -4.写查询所有接口---》遵循restful规范，使用cbv

    -5.新增一个数据---》

    -6.查询一个

    -7.修改一个：put提交的数据，不能从requets.POST中取

    -8.删除一个

# 代码实操

- 1.views.py

from django.http import JsonResponse

from django.views import View

from .models import Book

import json

class BookView(View):

    def get(self,request):

        books = Book.objects.all()

        book_list = []

        for book in books:

            book_list.append({'name': book.name, 'price':book.price, 'publish':book.publish})

        return JsonResponse(book_list, safe=False, json_dumps_params={'ensure_ascii': False})

    def post(self,request):

        name = request.POST.get('name')

        price = request.POST.get('price')

        publish = request.POST.get('publish')

        book = Book.objects.create(name=name,price=price,publish=publish)

        return JsonResponse({'name':book.name, 'price':book.price,'publish':book.publish})

class BookDetailView(View):

    # 获取单条

    def get(self,request,pk):

        book = Book.objects.filter(pk=pk).first()

        return JsonResponse({'id':book.id,'name':book.name,'price': book.price, 'publish':book.publish})

    # 修改单条

    def put(self,request,pk):

        # 先查到要改的

        book = Book.objects.filter(pk=pk).first()

        print(request.body)

        book_dic = json.loads(request.body)

        book.name = book_dic.get('name')

        book.price = book_dic.get('price')

        book.publish = book_dic.get('publish')

        book.save()

    # 删除单条

    def delete(self,request,pk):

        Book.objects.filter(pk=pk).delete()

        return JsonResponse(data={})

-2.urls.py

urlpatterns = [

    path('api/v1/books/', views.BookView.as_view())

]

# drf 全称djangorestramework，可以帮助我们快速实现符合restful规范的接口

# drf最新支持到djagno 3.x ，最新不支持2.x

# 安装drf

    pip3 install djangorestframework -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com/simple/

# 由于你是django2.x 它发现它不支持，它会自动写在dajgno，安装最新的django 4.x

# drf编写5个接口

- 1.views.py:

from rest_framework.viewsets import ModelViewSet

from .serializer import BookSerializer

class BookView(ModelViewSet):

    queryset = Book.objects.all()

    serializer_class = BookSerializer

- 2.urls.py

from django.contrib import admin

from django.urls import path

from drf01 import views

from rest_framework.routers import SimpleRouter

router =SimpleRouter()

router.register('books',views.BookView, 'books')

urlpatterns = [

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

]

urlpatterns += router.urls

- 3.serializer.py

from rest_framework import serializers

from .models import Book

class BookSerializer(serializers.ModelSerializer):

    class Meta:

        model=Book

        fields = '__all__'

# 1.路由中写的：path('api/v1/books/',views.BookView.as_view()),

     第二个参数无论是fbv还是cbv放的都是函数内存地址

    - 1.当请求来了。匹配成功就会成功执行view(request)

       def view(request, *args, **kwargs):

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

    - 2. self.dispatch view类方法

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

           # request.method请求方式转成小写，必须在列表中才能往下走

           if request.method.lower() in self.http_method_names:

                # 反射,去self[视图类的对象：BookView，通关get字符串，反射出属性或方法]

                handler = getattr(self, request.method.lower(), self.http_method_not_allowed)

           else:

                handler = self.http_method_not_allowed

           # BookView的get方法，加括号，传入request

           return handler(request, *args, **kwargs)