版本控制
Posted aizhinong
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了版本控制相关的知识,希望对你有一定的参考价值。
随着程序越来越大,可能通过版本不同,做出不同的处理方式。没用rest_framwork之前,我们可能会这样做:
class UserView(APIView): def get(self,request,*args,**kwargs): version = request.query_params.get(‘version‘) print(version) if version==‘v1‘: #如果版本是v1 ret = { ‘code‘:111, ‘msg‘:‘版本一的内容‘ } elif version==‘v2‘: # 如果是v2 ret = { ‘code‘: 112, ‘msg‘: ‘版本二的内容‘ } else: ret = { ‘code‘: 0, ‘msg‘: ‘不支持其他版本‘ } return Response(ret)
通过rest_framework实现:
先看源码:
进行认证之前,先获取版本
控制类实现方式有多种:局部使用时在CBV添加versioning_class 参数,值为版本控制类名。全局使用在settings中设置即可。
使用方法:
QueryParameterVersioning类:url参数
# 版本测试 path(‘test_version/‘, views.TestVersionsView.as_view(), name=‘test_list‘), # 匿名测试
from rest_framework.versioning import QueryParameterVersioning from rest_framework.response import Response # from django.urls import reverse class TestVersionsView(APIView): versioning_class = QueryParameterVersioning def get(self, request): version = request.version if version == ‘v1‘: return Response(‘版本一‘) elif version == ‘v2‘: versioning_scheme = request.versioning_scheme # 版本类对象,用于反向生成url url = versioning_scheme.reverse(viewname=‘test_list‘, request=request) # 接收一个url别名与request # print(versioning_scheme, type(versioning_scheme)) print(url) return Response(‘版本二‘) else: return Response("ok")
request.version接收版本号,versioning_scheme接收版本控制类对象用来调用版本控制类下的反向解析url方法。django内置的方法同样可以进行反向解析,但只适用使用版本控制类URLPathVersioning
URLPathVersioning类:url路由
# 版本测试URLPathVersioning re_path("test_version_path/(?P<version>[v1|v2]+)", views.TestVersionsPathView.as_view(), name=‘test_list2‘)
from rest_framework.versioning import URLPathVersioning class TestVersionsPathView(APIView): versioning_class = URLPathVersioning def get(self, request, *args, **kwargs): version = request.version versioning_scheme = request.versioning_scheme print(request.version) if version == ‘v1‘: url = reverse(viewname=‘test_list2‘, kwargs={"version": "v1"}) print(url) # /test_version_path/v1 return Response(‘版本一‘) elif version == ‘v2‘: url = versioning_scheme.reverse(viewname=‘test_list2‘, request=request) print(url) # http://127.0.0.1:8000/test_version_path/v2 return Response(‘版本二‘) else: return Response(‘ok‘)
NamespaceVersioning类:include分发
# 版本测试NamespaceVersioning path(‘version1/‘, include(‘app01.urls‘, namespace=‘v1‘)), path(‘version2/‘, include(‘app01.urls‘, namespace=‘v2‘))
from django.urls import path, re_path, include from app01 import views app_name = ‘app01‘ urlpatterns = [ path(‘test_version/‘, views.TestNamespaceVersionsView.as_view(), name=‘users-list‘), ]
from rest_framework.versioning import NamespaceVersioning class TestNamespaceVersionsView(APIView): versioning_class = NamespaceVersioning def get(self, request, *args, **kwargs): version = request.version versioning_scheme = request.versioning_scheme if version == ‘v1‘: return Response(‘版本一‘) elif version == ‘v2‘: url = versioning_scheme.reverse(viewname=‘users-list‘, request=request) print(url) return Response(‘版本二‘) else: return Response(‘ok‘)
HostNameVersioning:子域名
#分发url urlpatterns = [ #url(r‘^admin/‘, admin.site.urls), url(r‘^api/‘, include(‘api.urls‘)), ] urlpatterns = [ url(r‘^users/‘, views.UsersView.as_view(),name=‘u‘), ] class UsersView(APIView): def get(self,request,*args,**kwargs): self.dispatch print(request.version) # QueryParameterVersioning().detemiin_version() print(request.versioning_scheme) # QueryParameterVersioning() REST_FRAMEWORK = { ‘VERSION_PARAM‘:‘version‘, ‘DEFAULT_VERSION‘:‘v1‘, ‘ALLOWED_VERSIONS‘:[‘v1‘,‘v2‘], ‘DEFAULT_VERSIONING_CLASS‘:"rest_framework.versioning.HostNameVersioning" } # C:WindowsSystem32driversetc # vim /etc/hosts 127.0.0.1 v1.luffy.com 127.0.0.1 v2.luffy.com #配置ALLOWED_HOSTS = [‘*‘]
全局设置版本控制:在settings中设置
REST_FRAMEWORK = { ... # 使用那种版本控制来控制版本号 ‘DEFAULT_VERSIONING_CLASS‘: ‘rest_framework.versioning.URLPathVersioning‘, ‘DEFAULT_VERSION‘: ‘v1‘, # 默认的版本 ‘ALLOWED_VERSIONS‘: [‘v1‘, ‘v2‘], # 有效的版本 ‘VERSION_PARAM‘: ‘version‘, # 版本的参数名与URL conf中一致 }
以上是关于版本控制的主要内容,如果未能解决你的问题,请参考以下文章