DRF初识

目录

• Web API接口
  • 什么是Web API接口
  • 接口四大特征
  • 接口文档的编写测试
• restful接口规范
  • url链接设计
  • 五大请求方式
  • 响应结果
• DRF框架安装
• 基于原生Django实现十大接口
• Django CBV源码分析

Web API接口

什么是Web API接口

我们来看下面的两个url例子：那个看起来更像是接口？

https://www.baidu.com
https://api.map.baidu.com/search

明显第二个网址看起来更像是接口。

第一个url返回网页，叫网址

第二个返回数据，叫接口

那么接口就是通过规定的请求方式访问的url链接

接口规定了提交请求参数的请求方式，访问其可以获取响应的数据

Web API 接口和一般的url链接还是有区别的，Web API接口简单概括有以下四大特点

接口四大特征

• url链接：长得像返回数据的url链接（https://api.map.baidu.com/place/v2/search）
• 请求方式：get、post、put、patch、delete
• 请求参数：请求携带的参数或者数据包（parmas or body）
• 响应数据：json或xml格式的数据

通过访问以下接口并携带参数，可以返回想要的数据：
https://api.map.baidu.com/place/v2/search?ak=hwXbwDEvhyGtKwmh6IMhRWyeOoilo7Uv&region=上海&query=肯德基&output=json

ak：应用唯一标识码
region：搜索地区
query：搜索地点
output：返回数据的格式

{
    "status":0,
    "message":"ok",
    "results":[
        {
            "name":"肯德基(罗餐厅)",
            "location":{
                "lat":31.415354,
                "lng":121.357339
            },
            "address":"月罗路2380号",
            "province":"上海市",
            "city":"上海市",
            "area":"宝山区",
            "street_id":"339ed41ae1d6dc320a5cb37c",
            "telephone":"(021)56761006",
            "detail":1,
            "uid":"339ed41ae1d6dc320a5cb37c"
        }
        ...
        ]
}

接口文档的编写测试

• yapi接口文档工具（web在线接口编写工具）
• postman接口测试工具

restful接口规范

REST：英文representational state transfer直译为表现层状态转移，或者表述性状态转移；Rest是web服务的一种架构风格，一种设计风格，是一种思想；同时Rest不是针对某一种编程语言的。

以webService为例通俗解释，我们需要编写一个功能的时候以往我们都会这么写：

http://localhost:8080/admin/getUser （查询用户）

http://localhost:8080/admin/addUser （新增用户）

http://localhost:8080/admin/updateUser （更新用户）

http://localhost:8080/admin/deleteUser （删除用户）

以不同的URL（主要为使用动词）进行不同的操作。

Rest架构：**

GET http://localhost:8080/admin/user （查询用户）

POST http://localhost:8080/admin/user （新增用户）

PUT http://localhost:8080/admin/user （更新用户）

DELETE http://localhost:8080/admin/user （删除用户）

总结：URL只指定资源，以HTTP方法动词进行不同的操作。用HTTP STATUS/CODE定义操作结果。

Restful：遵守了rest风格的web服务便可称为Restful。

为什么需要Restful？

• url链接具有很强的可读性
• 规范化请求和响应
• 资源描述与视图的解耦合
• 提高交互性，方便为第三方服务提供服务
• 提供无状态的服务接口，降低复杂度，提高应用的水平扩展性。

RESTful作为目前最流行的API设计规范，一定有着它独有的魅力：强大、简洁、易上手

那么RESTful规范有哪些呢？

请往下看：

url链接设计

• 接口采用https协议，保证数据安全
• 接口使用特定关键字（api）表示
• 接口操作的数据称之为资源，体现资源名词，尽量不体现操作资源动词（如特殊的比如登录可以使用动词）
• 接口资源多版本共存使用特定关键字（v1、v2）区分版本
• 接口群操作限制条件使用？

五大请求方式

• get：获取单个或多个资源
• post：新增单个或多个资源
• put：整体修改单个或多个资源
• patch：局部修改单个或多个资源
• delete：删除单个或多个资源，不做任何资源返回

响应结果

• 应包含网络状态码 （200，201）
• 应包含数据状态码（0成功，1失败，2无数据）
• 应包含数据状态信息（对数据的描述）
• 应包含数据结果（results，常量、数组、字典），若存在图片资源则是url的请求链接

DRF框架安装

我们在了解了Web API接口和RESTful接口规范后，我们要在后端使用这个RESTful规范我们要先安装这个框架

DRF即-- django-restframework

DRF是Django的插件，所以必须确保安装了Django

pip3 install djangorestframework

使用DRF时，要在settings中注册

INSTALLED_APPS = (
    ...
    'rest_framework',
)

基于原生Django实现十大接口

我们已经知道了五大请求方式，基于五大请求方式，我们可以对请求进行 单|群 操作

api/urls.py

from django.conf.urls import url

from . import views
urlpatterns = [
    url(r'^books/$', views.BookView.as_view()),
    url(r'^books/(?P<pk>\d+)/$', views.BookView.as_view())
]

api/models.py

from django.db import models

class Book(models.Model):
    name = models.CharField(max_length=64)
    price = models.DecimalField(max_digits=5, decimal_places=2)

api/views.py

from django.http import JsonResponse
from django.views import View

# 一个视图类可以保护常规五个请求方法：get|post|put|patch|delete
# 五个请求方法处理十个资源操作的逻辑：单群查|单群增|单群整体改|单群局部改|单群删

from . import models
class BookView(View):

    def _single_get(self, pk):
        book_dic = models.Book.objects.filter(pk=pk).values('name', 'price').first()
        if not book_dic:
            return JsonResponse({
                'status': 1,
                'msg': '单查 资源不存在',
            })
        return JsonResponse({
            'status': 0,
            'msg': '单查 ok',
            'results': book_dic
        })
    def _many_get(self):
        book_query = models.Book.objects.values('name', 'price')
        book_list = list(book_query)
        return JsonResponse({
            'status': 0,
            'msg': '群查 ok',
            'results': book_list
        })

    def get(self, request, *args, **kwargs):
        pk = kwargs.get('pk')
        if pk:  # 单查
            return self._single_get(pk)
        else:  # 群查
            return self._many_get()

    def post(self, request, *args, **kwargs):
        return JsonResponse({
            'status': 0,
            'msg': 'post ok'
        })

    def put(self, request, *args, **kwargs):
        return JsonResponse({
            'status': 0,
            'msg': 'put ok'
        })

    def patch(self, request, *args, **kwargs):
        return JsonResponse({
            'status': 0,
            'msg': 'patch ok'
        })

    def delete(self, request, *args, **kwargs):
        return JsonResponse({
            'status': 0,
            'msg': 'delete ok'
        })

Django CBV源码分析