Django DRF版本号的处理

在restful规范中,后端的API中需要体现版本。如果项目比较大,需要些很多的视图类,在每一个类中都写一遍会比较麻烦,所以drf中也支持了全局配置。在每个版本处理的类中还定义了`reverse`方法,他是用来反向生成URL并携带相关的的版本信息用的。

python 复制代码
REST_FRAMEWORK = {
    "DEFAULT_VERSIONING_CLASS": "rest_framework.versioning.QueryParameterVersioning",  # 处理版本的类的路径
    "VERSION_PARAM": "version",  # URL参数传参时的key,例如:xxxx?version=v1
    "ALLOWED_VERSIONS": ["v1", "v2", "v3"],  # 限制支持的版本,None表示无限制
    "DEFAULT_VERSION": "v1",  # 默认版本
}

一、基于GET传递参数

1、settings.py

python 复制代码
REST_FRAMEWORK={
    "UNAUTHENTICATED_USER": None,

    "VERSION_PARAM":"version",  # 决定url中版本的参数值;不设置默认也是这个值,可以通过修改这里修改,例如改为"v";
    "DEFAULT_VERSION":"v1", # 默认版本
    "ALLOWED_VERSIONS":["v1","v2"] #支持的版本范围
}

2、urls.py

python 复制代码
urlpatterns = [
    # path('admin/', admin.site.urls),
    path('home/', views.HomeView.as_view(),name="hh"),
]

3、views.py

python 复制代码
from rest_framework.versioning import   QueryParameterVersioning

class HomeView(APIView):
    # 传递过程中可以携带版本信息
    # http://127.0.0.1:8000/home/?version=v1 ,会自动读出版本赋值给request.version
    versioning_class = QueryParameterVersioning

    def get(self,request):
        print(request.version)
        print(request.versioning_scheme)

        url = request.versioning_scheme.reverse("hh",request=request)
        print("反向生产URL:",url)

        return Response("...")

二、基于路由传递参数

1、urls.py

python 复制代码
urlpatterns = [
    # 下面这两种写法都可以,一种是基于re_path的路由
    # path('api/<str:version>/home/', views.HomeView.as_view(), name="hh"),
    re_path(r'^api/(?P<version>\w+)/home/',views.HomeView.as_view(),name="hh"),

]

2、settings.py

python 复制代码
REST_FRAMEWORK={
    "UNAUTHENTICATED_USER": None,

    "VERSION_PARAM":"version",  # 决定url中版本的参数值;不设置默认也是这个值,可以通过修改这里,修改;
    "DEFAULT_VERSION":"v1", # 默认版本
    "ALLOWED_VERSIONS":["v1","v2"] #支持的版本范围
}

3、views.py

python 复制代码
from rest_framework.versioning import   URLPathVersioning

class HomeView(APIView):
    # 传递过程中可以携带版本信息
    # http://127.0.0.1:8000/home/?version=v1 ,会自动读出版本赋值给request.version
    versioning_class = URLPathVersioning

    def get(self,request,*args,**kwargs):
        print(request.version)
        print(request.versioning_scheme)

        url = request.versioning_scheme.reverse("hh",request=request)
        print("反向生产URL:",url)

        return Response("...")

三、基于请求头传递参数

1、urls.py

python 复制代码
urlpatterns = [
    # 基于请求头传递参数
    path('api/home/', views.HomeView.as_view(), name="hh"),
]

2、views.py

python 复制代码
from rest_framework.versioning import   QueryParameterVersioning,URLPathVersioning,AcceptHeaderVersioning

class HomeView(APIView):
    versioning_class = AcceptHeaderVersioning

    def get(self,request,*args,**kwargs):
        print(request.version)
        print(request.versioning_scheme)

        url = request.versioning_scheme.reverse("hh",request=request)
        print("反向生产URL:",url)

        return Response("...")

四、在实际项目中,第二种通过URL传递版本号的方式还是比较常用,在使用的时候,可以通过全局配置,在views中就不需要在引入和单独设置了,可以直接使用,案例如下:

1、settings.py

python 复制代码
REST_FRAMEWORK={
    # 版本号传递全局设置
    "VERSION_PARAM":"version",  # 决定url中版本的参数值;不设置默认也是这个值,可以通过修改这里,修改;
    "DEFAULT_VERSION":"v1", # 默认版本
    "ALLOWED_VERSIONS":["v1","v2"], #支 持的版本范围
    "DEFAULT_VERSIONING_CLASS":"rest_framework.versioning.URLPathVersioning",
}

2、urls.py

python 复制代码
  # 基于URL传递参数
    path('api/<str:version>/home/', views.HomeView.as_view(), name="hh"),

3、views.py

python 复制代码
from rest_framework.views import APIView
from rest_framework.response import Response

class HomeView(APIView):
    def get(self,request,*args,**kwargs):
        print(request.version)
        print(request.versioning_scheme)
        url = request.versioning_scheme.reverse("hh",request=request)
        print("反向生产URL:",url)
        return Response("...")
相关推荐
Deng94520131438 分钟前
基于Python的职位画像系统设计与实现
开发语言·python·文本分析·自然语言处理nlp·scrapy框架·gensim应用
好奇的菜鸟3 小时前
Spring Boot 事务失效问题:同一个 Service 类中方法调用导致事务失效的原因及解决方案
数据库·spring boot·sql
岁岁岁平安4 小时前
Redis基础学习(五大值数据类型的常用操作命令)
数据库·redis·学习·redis list·redis hash·redis set·redis string
FreakStudio5 小时前
一文速通 Python 并行计算:13 Python 异步编程-基本概念与事件循环和回调机制
python·pycharm·协程·多进程·并行计算·异步编程
小光学长6 小时前
基于vue框架的防疫科普网站0838x(程序+源码+数据库+调试部署+开发环境)带论文文档1万字以上,文末可获取,系统界面在最后面。
数据库
极限实验室6 小时前
使用 Docker Compose 简化 INFINI Console 与 Easysearch 环境搭建
数据库·docker·devops
飞翔的佩奇6 小时前
Java项目:基于SSM框架实现的旅游协会管理系统【ssm+B/S架构+源码+数据库+毕业论文】
java·数据库·mysql·毕业设计·ssm·旅游·jsp
豌豆花下猫7 小时前
让 Python 代码飙升330倍:从入门到精通的四种性能优化实践
后端·python·ai
夏末蝉未鸣017 小时前
python transformers库笔记(BertForTokenClassification类)
python·自然语言处理·transformer
float_六七9 小时前
SQL六大核心类别全解析
数据库·sql·oracle