189 8069 5689
在开发一个网站的过程中，前端页面需要使用后端框架的模板语法（DTL) 来渲染，比如 Django 自带的模板语法或者 jinjia2，这种前端页面在后端渲染完成之后才会把页面文档传送给前端
创新互联建站专注于利川企业网站建设,响应式网站建设,商城网站开发。利川网站建设公司,为利川等地区提供建站服务。全流程按需网站设计，专业设计，全程项目跟踪，创新互联建站专业和态度为您提供的服务
目前主流的开发模式，这种模式中前端先在后端的静态文件服务器（nfs）中获取静态文件（static 中的HTML、CSS、JS代码），需要数据的时候向后端发送请求只获取json格式的数据，再在前端运用js的BOM与DOM操作对页面进行渲染。
这样便实现了前后端分离，前端只需要从后端获取一定格式的数据，那么前端就可以是一个网页、app或者小程序，提高开发水平。
简介： api 接口是前后端交互数据的媒介
api 接口包含：
过去我们开发网站开放出来的接口一般使用浏览器发送get请求来进行测试，但基于api接口的restful设计规范，我们还需要使用 post请求、put请求等，而浏览器只能发送 get请求
postman 是一种测试接口共组，在 postman 中可以满足我们的测试需求
市面上也有许多测试软件（postwoman），我们使用主流的postman
下载地址： https://www.getpostman.com/downloads/
使用：
前后端数据交互的编码格式：
发起请求时，可以在 body 中书写请求体：
同时，这个批量测试也支持导出文件，然后发送给别人，再从文件中导出
REST与技术无关，代表的是一种软件架构风格，REST是Representational State Transfer的简称，中文翻译为“表征状态转移”或“表现层状态转化”。它首次出现在2000年Roy Fielding的博士论文中。
在前后端分离的开发模式中，为了方便数据交互，我们在设计前后端进行数据交互的 api 接口时，需要符合 restful 规范，它是一种写前后端分离的标准
对于REST这种面向资源的架构风格，有人提出一种全新的结构理念，即：面向资源架构（ROA：Resource Oriented Architecture）
1、通信协议一般使用 https 协议，为保障数据安全
2、设计的接口地址是可以让人一眼看出来是 api 接口（在接口中带api字眼）
3、多数据版本共存
接口更新之后，老版本的接口依旧一起使用，等过了期限才弃用老版本（维护老版本接口），以便可以留存更多用户。
4、交互数据即是资源，使用名词（可以是复数）
不建议使用动词，如 get_resource ，除非是 login 或者 register 这种接口
5、用不同的请求方式表示不同的资源操作
6、过滤，通过在url上传参的形式传递搜索条件
7、响应状态码（http的响应状态码，响应体的json数据中带状态码）
http 协议的状态码：
更多状态码请参考： https://www.cnblogs.com/elijah-li/p/.html
1xx：请求正在处理
200 OK - [GET]：服务器成功返回用户请求的数据，该操作是幂等的（Idempotent）。
201 CREATED - [POST/PUT/PATCH]：用户新建或修改数据成功。
202 Accepted - [*]：表示一个请求已经进入后台排队（异步任务）
204 NO CONTENT - [DELETE]：用户删除数据成功。
400 INVALID REQUEST - [POST/PUT/PATCH]：用户发出的请求有错误，服务器没有进行新建或修改数据的操作，该操作是幂等的。
401 Unauthorized - [*]：表示用户没有权限（令牌、用户名、密码错误）。
403 Forbidden - [*] 表示用户得到授权（与401错误相对），但是访问是被禁止的。
404 NOT FOUND - [*]：用户发出的请求针对的是不存在的记录，服务器没有进行操作，该操作是幂等的。
406 Not Acceptable - [GET]：用户请求的格式不可得（比如用户请求JSON格式，但是只有XML格式）。
410 Gone -[GET]：用户请求的资源被永久删除，且不会再得到的。
422 Unprocesable entity - [POST/PUT/PATCH] 当创建一个对象时，发生一个验证错误。
500 INTERNAL SERVER ERROR - [*]：服务器发生错误，用户将无法判断发出的请求是否成功。
更多状态码请参考： https://www.cnblogs.com/elijah-li/p/.html
服务端自定义的状态码
响应体中返回json格式数据，数据中有 服务端自定义的状态码（code，status）
8、返回错误信息（错误处理）
返回数据是json格式，带状态码和错误信息
{
code: 1002
error: "Invalid API key"
}
9、不同的请求方式（不同操作）应该返回不同的资源
10、返回资源中要跳转的链接地址
{"link": {
"rel": "collection https://www.example.com/zoos",
"href": "https://api.example.com/zoos", '''连接地址'''
"title": "List of zoos",
"type": "application/vnd.yourformat+json"
}}
1、安装 djangorestframework
pip install djangorestframework==3.10.3
2、在 settings.py 文件中 注册 rest_framework
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'app01.apps.App01Config',
'rest_framework',
]
3、在 models.py 中写表模型
class Book(models.Model):
name = models.CharField(verbose_name='书名', max_length=32)
price = models.DecimalField(verbose_name='价格', max_digits=5, decimal_places=2)
author = models.CharField(verbose_name='作者', max_length=32)
class Meta:
verbose_name_plural = '书籍表'
4、新建一个序列化类
在应用文件夹下创建一个 ser.py 作为序列化模块
from rest_framework.serializers import ModelSerializer
from app01.models import Book
class BookModelSerializer(ModelSerializer): # 继承的是 ModelSerializer
class Meta:
model = Book
fields = '__all__' # 注意别漏写 fields
5、书写视图函数（CBV）
from rest_framework.viewsets import ModelViewSet
from .ser import BookModelSerializer, Book
# Create your views here.
class BookModelViewSet(ModelViewSet): # 继承的是 ModelViewSet
queryset = Book.objects.all()
serializer_class = BookModelSerializer
6、书写 url
from app01 import views
from rest_framework.routers import DefaultRouter
router = DefaultRouter()
router.register('books', views.BookModelViewSet)
urlpatterns = [
path('admin/', admin.site.urls),
]
urlpatterns += router.urls
9、迁移数据库
python manage.py makemigrations
python manage.py migrate
10、在浏览器中测试接口
11、在 postman 中测试接口
注意： 在发送 put 请求（修改资源）、patch 请求（修改资源）、delete 请求（删除资源）时，得在名词后面添加具体的资源 id 值，并且要加上 “/” ，因为 postman 不会自动加斜杆
获取资源：
新增资源：
修改资源：
删除资源：
从路由文件 urls.py 的调用语句中看起
urlpatterns = [
path('CBV/', views.MyClass.as_view()),
]
# as_view() 函数加括号优先调用 as_view函数
按住 ctrl 键，鼠标点击查看 as_view 源码
@classonlymethod
def as_view(cls, **initkwargs):
def view(request, *args, **kwargs):
self = cls(**initkwargs) # self 是我们自定义类产生的对象
if hasattr(self, 'get') and not hasattr(self, 'head'):
self.head = self.get
self.setup(request, *args, **kwargs)
if not hasattr(self, 'request'): # 自定义类必须接收 request 对象，否则主动报错
raise AttributeError(
"%s instance has no 'request' attribute. Did you override "
"setup() and forget to call super()?" % cls.__name__
)
return self.dispatch(request, *args, **kwargs) # view 函数调用 View 类中的dispath函数
# ... 中间省略部分源码
return view # 返回view函数对象
从源码中可以看出，as_view 调用之后得到的是 view 函数对象，这是个闭包函数，当视图函数被触发，调用的是 view函数，view函数return一个 dispatch 函数调用结果
我们再查看 dispatch 的源码：
http_method_names = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']
def dispatch(self, request, *args, **kwargs):
# Try to dispatch to the right method; if a method doesn't exist,
# defer to the error handler. Also defer to the error handler if the
# request method isn't on the approved list.
if request.method.lower() in self.http_method_names: # 如果是request中的属性，则用反射调用自身的响应的函数
handler = getattr(self, request.method.lower(), self.http_method_not_allowed)
else:
handler = self.http_method_not_allowed
return handler(request, *args, **kwargs)
APIView 是 rest_framework.views 中的一个类，是 drf 提供给我们更多功能的视图函数类，也继承了 Django 的 View
基于 CBV 先定义一个视图函数
views.py :
from rest_framework.views import APIView
class BookAPIView(APIView):
def get(self, request):
pass
def post(self, request):
pass
urls.py :
urlpatterns = [
path('admin/', admin.site.urls),
path('book/',views.BookAPIView.as_view()) # 调用 as_view() 返回的是 view 函数的内存地址
]
调用的是 APIView 的 as_view 方法：
APIView 类继承的是 Django 的 View，所以 super().as_view(**initkwargs) 调用了父类（View）中的 as_view，返回的是 View 中 as_view 返回的 view，在 view 函数里调用的 self.dispatch(request, *args, kwargs) 根据类的查找顺序，调用的就是 APIView 中的 dispatch
class APIView(View):
@classmethod
def as_view(cls, **initkwargs):
view = super().as_view(**initkwargs)
view.cls = cls
view.initkwargs = initkwargs
return csrf_exempt(view) # 所有继承了 APIView 的视图函数都忽略了 csrf 认证
csrf_exempt(index) 相当于
@csrf_exempt
def index(request)
pass
# index=csrf_exempt(index)
APIView 中的 dispatch:
def dispatch(self, request, *args, **kwargs):
# 重写了 Django 传过来的 request 请求数据对象，给request增添了新属性
request = self.initialize_request(request, *args, **kwargs)
self.request = request
try:
# 进行三大认证
self.initial(request, *args, **kwargs)
# 反射机制调用视图函数类中的方法，与原生 dispatch 一致
if request.method.lower() in self.http_method_names:
handler = getattr(self, request.method.lower(),
self.http_method_not_allowed)
else:
handler = self.http_method_not_allowed
response = handler(request, *args, **kwargs)
except Exception as exc:
response = self.handle_exception(exc)
# 处理放回数据，具有 drf 特色的页面
self.response = self.finalize_response(request, response, *args, **kwargs)
return self.response
APIView 中的 initialize_request：
对原生的 request 进行处理，新增了一些功能和属性
def initialize_request(self, request, *args, **kwargs):
return Request(
request,
parsers=self.get_parsers(),
authenticators=self.get_authenticators(),
negotiator=self.get_content_negotiator(),
parser_context=parser_context
)
initialize_request 中的 Request()：
把原生的 request 赋给了 _request，原 request 请求对象的方法在 _request 中获取就可以
class Request:
def __init__(self, request, parsers=None, authenticators=None,
negotiator=None, parser_context=None):
self._request = request
self._data = Empty
request 的变化
新的：
老的：
三大认证：
# 三大认证人如何走的
self.initial(request, *args, **kwargs)---》APIView的
核心代码：
self.perform_authentication(request) # 认证
self.check_permissions(request) #权限
self.check_throttles(request) # 频率
重写了 request 请求数据对象之后，原生的 request 方法一样能用，因为 Request 类中的 getattr 方法（对象的 '.' 点拦截）中用放射机制获取了原生 request 的所有属性
Request --> __getattr__
def __getattr__(self, attr):
try:
return getattr(self._request, attr)
except AttributeError:
return self.__getattribute__(attr)
前端post请求传入的数据，在原来的request.POST中只能处理urlencoded和formdata编码格式，json格式不能处理。
而 Request 类实例化之后，提供了一个 data 方法，无论前端用什么编码post提交的数据，都从 request.data 中获取。
@property
def data(self):
if not _hasattr(self, '_full_data'):
self._load_data_and_files()
return self._full_data