版本控制器
简介
API版本控制器可以用于不同的客户端使用不同的行为。而版本控制是由传入的客户端决定的，并且可能基于请求URL，或者基于请求头。有许多有效的方法能达到版本控制的目的。而具有多个客户的长期系统工程进行设计时，没有版本控制也是可以的。
RESTful框架的版本控制
当使用版本控制的时候，request.version属性（字符串）与客户端请求的版本一致。
默认情况下，没有使用版本控制，request.version将会返回None
1 基于不同版本进行不同的行为
def get_serializer_class(self):
if self.request.version == 'v1':
return AccountSerializerVersion1
return AccountSerializer
2改变URL
from rest_framework.reverse import reverse
reverse('bookings-list', request=request)
reverse函数将应用于转换任何请求版本的URL。
NamespacedVersioning：类似命名空间
'v1:bookings-list'
http://example.org/v1/bookings/
3 QueryParameterVersioning：查询参数
http://example.org/bookings/?version=1.0
4 版本控制和超链接序列化器
当使用超链接的序列化器和基于URL的版本控制方案时，确保将请求作为序列化器的上下文。
def get(self, request):
queryset = Booking.objects.all()
serializer = BookingsSerializer(queryset, many=True, context={'request': request})
return Response({'all_bookings': serializer.data})
版本配置
全局版本配置
1.加配置
REST_FRAMEWORK = {
……
'DEFAULT_VERSIONING_CLASS':'rest_framework.versioning.URLPathVersioning',
'ALLOWED_VERSIONS':['v1','v2'], # 允许的版本
'VERSION_PARAM':'version', # 参数
'DEFAULT_VERSION':'v1', # 默认版本
....
}
2.设置路由
CBV/urls.py
urlpatterns = [
#url(r'^admin/', admin.site.urls),
url(r'^api/(?P<version>\w+)/', include('api.urls')),
]
api/urls.py
urlpatterns = [
url(r'^course/$', course.CourseView.as_view()),
]
3.穿传递版本信息
http://127.0.0.1:8000/api/v1/course/
4.获取版本
request.version获取版本
局部配置
如果没有配置，那将会在内置的settings配置文件中找DEFAULT_VERSIONING_CLASS，而默认的值是None，因此request.version将始终返回None
我们可以在单独视图中设置版本控制，但是如非必要，一般不在单独视图上加版本控制方案。
from rest_framework.versioning import QueryParameterVersioning
class Course(APIView):
versioning_class = QueryParameterVersioning
