drf路由（routers）

1. 路由Routers()
   1. 必须是继承ModelViewSet的视图类才能自动生成路由
2. 代码演示
3. 视图集中附加action的声明
4. 路由router形成URL的方式
5. 详解（笔记）
   1. 路由
   2. ction的使用

 

一 路由Routers

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

REST framework提供了两个router

• SimpleRouter 只生成2个路由
• DefaultRouter 生成的路由比较多

1.1 使用方法

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

# 导入routers模块
from rest_framework import routers
# 实例化得到对象
router = routers.SimpleRouter()
# 注册
router.register（prefix, viewset, base_name）     代码演示在下面（只需要前缀即可后面自动生成的）

register(prefix, viewset, base_name)

• prefix 该视图集的路由前缀
• viewset 视图集
• base_name 路由别名的前缀（用来反向解析的）

2）添加路由数据

# 自动生成的路由,加入到原路由中
# print(router.urls)
# 第一种方式
urlpatterns = [
    ...
]
urlpatterns+=router.urls
# 第二种方式
urlpatterns = [
    ...
    url(r'^',include(router.urls))
]

1.2 代码演示

使用路由类给视图生成路由地址    

-views.py
from rest_framework.viewsets import ModelViewSet
from app01.models import Book
from app01.ser import BookSerializer
# 必须是继承ModelViewSet的视图类才能自动生成路由
class BookViewSet(ModelViewSet):
    queryset =Book.objects
    serializer_class = BookSerializer

路由代码

# 第一步：导入routers模块
from rest_framework import routers

# 第二步：有两个类,实例化得到对象
# routers.DefaultRouter 生成的路由更多
# routers.SimpleRouter
router=routers.DefaultRouter()

# 第三步：注册
# router.register('前缀','继承自ModelViewSet视图类','别名')
router.register('books',views.BookViewSet) # 不要加斜杠了

# 第四步
urlpatterns+=router.urls

上面的代码就成功生成了路由地址[增/删/改/查一条/查多条的功能]，但是不会自动我们在视图集自定义方法的路由。

所以我们如果也要给自定义方法生成路由，则需要进行action动作的声明。

二 视图集中附加action的声明

在视图集中，如果想要让Router自动帮助我们为自定义的动作生成路由信息，需要使用rest_framework.decorators.action装饰器。

以action装饰器装饰的方法名会作为action动作名，与list、retrieve等同。

action装饰器可以接收两个参数： 带pk和不带pk

• methods: 声明该action对应的请求方式，列表传递
• detail:声明该action的路径是否与单一资源对应，True或False
  • True 表示路径格式是xxx/<pk>/action方法名/ 
  • False 表示路径格式是xxx/action方法名/

举例：

-views.py
class Bookview(ModelViewSet):
    queryset = models.book.objects.all()
    serializer_class = BookSerializers

    @action(methods=['GET', 'POST'], detail=False)            运行的话需要http://127.0.0.1:8000/bookall/get_10/自动生成这样使用
    def get_10(self,request):  #取出前10条数据
        book = self.get_queryset()[:10]  # 从0开始截取一条
        ser = self.get_serializer(book, many=True)
        return Response(ser.data)

-urls.py
from rest_framework import routers
router = routers.SimpleRouter()
router.register('books',views.Bookview)
urlpatterns = [
    url(r'^admin/', admin.site.urls),
]
urlpatterns+=router.urls

由路由器自动为此视图集自定义action方法形成的路由会是如下内容：

^books/get_10/$   #detail=False
^books/(?P<pk>[^/.]+)/get_10/$   #detail=True

三 路由router形成URL的方式

3.1 SimpleRouter

3.2 DefaultRouter

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

 

详解

 

1 路由

 

# 1 在urls.py中配置
    path('books4/', views.Book4View.as_view()),
    re_path('books4/(?P<pk>\d+)', views.Book4DetailView.as_view()),
# 2 一旦视图类，继承了ViewSetMixin，路由
     path('books5/', views.Book5View.as_view(actions={'get':'list','post':'create'})), #当路径匹配，又是get请求，会执行Book5View的list方法
    re_path('books5/(?P<pk>\d+)', views.Book5View.as_view(actions={'get':'retrieve','put':'update','delete':'destroy'})),
 
# 3 继承自视图类，ModelViewSet的路由写法（自动生成路由）
    -urls.py
        # 第一步：导入routers模块
        from rest_framework import routers
        # 第二步：有两个类,实例化得到对象
        # routers.DefaultRouter 生成的路由更多
        # routers.SimpleRouter
        router=routers.DefaultRouter()
        # 第三步：注册
        # router.register('前缀','继承自ModelViewSet视图类','别名')
        router.register('books',views.BookViewSet) # 不要加斜杠了
​
        # 第四步
        # router.urls # 自动生成的路由,加入到原路由中
        # print(router.urls)
        # urlpatterns+=router.urls
        '''
    -views.py
        from rest_framework.viewsets import ModelViewSet
        from app01.models import Book
        from app01.ser import BookSerializer
        class BookViewSet(ModelViewSet):
            queryset =Book.objects
            serializer_class = BookSerializer

 

1.1 action的使用

 

# action干什么用？为了给继承自ModelViewSet的视图类中定义的函数也添加路由
# 使用
class BookViewSet(ModelViewSet):
    queryset =Book.objects.all()
    serializer_class = BookSerializer
    # methods第一个参数，传一个列表，列表中放请求方式，
    # ^books/get_1/$ [name='book-get-1'] 当向这个地址发送get请求，会执行下面的函数
    # detail：布尔类型 如果是True
    #^books/(?P<pk>[^/.]+)/get_1/$ [name='book-get-1']
    @action(methods=['GET','POST'],detail=True)
    def get_1(self,request,pk):
        print(pk)
        book=self.get_queryset()[:2]  # 从0开始截取一条
        ser=self.get_serializer(book,many=True)
        return Response(ser.data)
    
# 装饰器，放在被装饰的函数上方，method：请求方式，detail：是否带pk