django rest framework框架中用到的组件

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) 设置接口文档访问路径

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

2)路由配置

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

3) 访问接口文档网页

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

在这里插入图片描述

猜你喜欢

转载自blog.csdn.net/YZL40514131/article/details/125461473
今日推荐