django rest framework框架中用到的组件_rest_framework.schemas.autoschema

---

1、Authentication：认证类

可以提供全局认证或者在具体的视图中通过设置authentication_classes类属性来设置来设置。

2、Permissions：权限类

在继承了APIView的类视图中定义permission_classes = [permissions.IsAuthenticated]

AllowAny 允许所有用户
IsAuthenticated 仅通过登录认证的用户
IsAdminUser 仅管理员用户
IsAuthenticatedOrReadOnly 已经登陆认证的用户可以对数据进行增删改操作，没有登陆认证的只能查看数据。

3、Throttling：限流类

可以对接口访问的频次进行限制，以减轻服务器压力，或者实现特定的业务。

4、Filtering：过滤类

对于列表数据可能需要根据字段进行过滤，我们可以通过添加django-fitlter扩展来增强支持。

5、OrderingFilter：排序类

对于列表数据，REST framework提供了OrderingFilter过滤器来帮助我们快速指明数据按照指定字段进行排序

6、Pagination：分页类

REST framework提供了分页的支持。我们可以在配置文件中设置全局的分页方式。也可通过自定义Pagination类（继承PageNumberPagination），来为视图添加不同分页行为。在视图中通过pagination_class属性来指明。

7、Exceptions：异常处理类

REST framework提供了默认常处理，我们也可以自定义的方式来编写异常处理函数。 在主应用的配置文件settings.py中声明自定义的异常处理。

DRF中默认的异常

ParseError 解析错误
AuthenticationFailed 认证失败
NotAuthenticated 尚未认证
PermissionDenied 权限受限
NotFound 未找到路由
MethodNotAllowed 请求方式不支持
NotAcceptable 要获取的数据格式不支持
Throttled 超过限流次数
ValidationError 校验失败

8、自动生成接口文档：

DRF 需要安装 coreapi库的支持。

pip install coreapi
1

1） 设置接口文档访问路径

REST_FRAMEWORK = { # 。。。 其他选项 # 接口文档 
	'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema', }
1
2

2）路由配置

from rest_framework.documentation import include_docs_urls 
urlpatterns = [ 
	... 
	path('docs/', include_docs_urls(title='站点页面标题')) 
	]
1
2
3
4
5

3） 访问接口文档网页

浏览器访问 127.0.0.1:8000/docs/，即可看到自动生成的接口文档。