1. 版本管理组件源码分析
注意点:
- 不同的versioning_class区别:实例化后得到的对象versioning_scheme里面的方法不同(函数同名,但是处理逻辑不同)
- def determine_version :获取版本信息
- def reverse : 反向生成url;
- QueryParameterVersioning:代表版本信息在查询参数中
- URLPathVersioning:代表版本信息在URL中
- AcceptHeaderVersioning:代表版本信息在请求头中
- versioning_class变量只能输入一个版本管理类,不能像其他组件一样写一个列表
2. 实践
# settings.py
REST_FRAMEWORK = {
# 版本配置
"DEFAULT_VERSIONING_CLASS": "rest_framework.versioning.QueryParameterVersioning", # 使用的版本管理类
"DEFAULT_VERSION": "v1", # 默认的版本
"ALLOWED_VERSIONS": ["v1"], # 支持的版本
"VERSION_PARAM": "version" # 版本参数名
}
# views.py
class HomeView(APIView):
# 自动从请求中获取版本信息,封装到request.version参数中
versioning_class = QueryParameterVersioning
def get(self, request):
# 获取版本信息
print(request.version)
# 通过versioning_scheme反向生成带版本的url
url = request.versioning_scheme.reverse("home", request=request)
return Response({"code": 0, "detail": "django_rest_framework"})