Django-路由Routers-SimpleRouter-DefaultRouter使用方法

路由Routers

对于视图集ViewSet，我们除了可以自己手动指明请求方式与动作action之间的对应关系外，还可以使用Routers来帮助我们快速实现路由信息。

REST framework提供了两个router

• SimpleRouter
• DefaultRouter

1. 使用方法

1） 创建router对象，并注册视图集，例如

from rest_framework import routers
 
router = routers.SimpleRouter()
 
router.register(r'books', BookInfoViewSet, base_name='book')
 
register(prefix, viewset, base_name)

• prefix 该视图集的路由前缀
• viewset 视图集
• base_name 路由名称的前缀

如上述代码会形成的路由如下：

^books/$ name: book-list
 
^books/{pk}/$ name: book-detail

　　

2）添加路由数据

可以有两种方式：

 

urlpatterns = [
 
...
 
]
 
urlpatterns += router.urls

　　

或

 

urlpatterns = [
 
...
 
url(r'^', include(router.urls))
 
]

　　

2. 视图集中包含附加action的

class BookInfoViewSet(mixins.ListModelMixin, mixins.RetrieveModelMixin, GenericViewSet):
 
queryset = BookInfo.objects.all()
 
serializer_class = BookInfoSerializer
 
@action(methods=['get'], detail=False)
 
def latest(self, request):
 
...
 
@action(methods=['put'], detail=True)
 
def read(self, request, pk):
 
...

　　

此视图集会形成的路由：

^books/latest/$ name: book-latest
 
^books/{pk}/read/$ name: book-read

　　

3. 路由router形成URL的方式

1） SimpleRouter

2）DefaultRouter

DefaultRouter与SimpleRouter的区别是，DefaultRouter会多附带一个默认的API根视图，返回一个包含所有列表视图的超链接响应数据。