drf-路由组件

Posted baicai37

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了drf-路由组件相关的知识,希望对你有一定的参考价值。

目录:

 

1 路由Routers

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

REST framework提供了两个router

  • SimpleRouter
  • DefaultRouter

1.1 使用方法

1) 创建router对象,并注册视图集,例如

from rest_framework import routers

router = routers.SimpleRouter()
router.register(rrouter_stu, StudentModelViewSet, base_name=student)

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))
]

1.2 代码演示

views.py

from django.shortcuts import render
from  rest_framework.viewsets import ModelViewSet
from app01.models import Book
from app01.serializers import BookSerializer

# Create your views here.
class BookViewSet(ModelViewSet):
    queryset = Book.objects.all()
    serializer_class = BookSerializer

urls.py

from django.contrib import admin
from django.urls import path, re_path
from app01 import views

urlpatterns = [
    path(admin/, admin.site.urls),
]

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

# 第二步:有两个类,实例化得到对象
# routers.DefaultRouter 生成的路由更多
# routers.SimpleRouter
router = routers.SimpleRouter()
# 第三步:注册
# router.register(‘路由前缀‘,‘继承自ModelViewSet视图类‘,‘别名‘)
router.register(books, views.BookViewSet)  # 不要加斜杠了

# 第四步
# router.urls # 自动生成的路由,加入到原路由中
# print(router.urls)
# urlpatterns+=router.urls
‘‘‘
[
<URLPattern ‘^books/$‘ [name=‘book-list‘]>, 
<URLPattern ‘^books/(?P<pk>[^/.]+)/$‘[name=‘book-detail‘]>
]

‘‘‘
urlpatterns += router.urls

‘‘‘
两个类路由区别:
SimpleRouter
<URLPattern ‘^books/$‘ [name=‘book-list‘]>, 
<URLPattern ‘^books/(?P<pk>[^/.]+)/$‘[name=‘book-detail‘]>


DefaultRouter
^books/$ [name=‘book-list‘]
^books/(?P<pk>[^/.]+)/$ [name=‘book-detail‘]  这两条跟simple一样

^$ [name=‘api-root‘]  根,根路径会显示出所有可以访问的地址
^.(?P<format>[a-z0-9]+)/?$ [name=‘api-root‘]


^books.(?P<format>[a-z0-9]+)/?$ [name=‘book-list‘]  http://127.0.0.1:8000/books.json
^books/(?P<pk>[^/.]+).(?P<format>[a-z0-9]+)/?$ [name=‘book-detail‘]  http://127.0.0.1:8000/books/1.json


‘‘‘

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

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

1.3 视图集中附加action的声明

action是为了给继承自ModelViewSet的视图类中定义的函数也添加路由

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

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

action装饰器可以接收两个参数:

  • methods: 声明该action对应的请求方式,列表传递

  • detail

    : 声明该action的路径是否与单一资源对应,及是,不是

xxx/<pk>/action方法名/
  • True 表示路径格式是xxx/<pk>/action方法名/
  • False 表示路径格式是xxx/action方法名/

举例:

# 使用
from rest_framework.decorators import action  # 装饰器

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

1.4 路由router形成URL的方式

1) SimpleRouter

技术图片

 

 技术图片

 

 2)DefaultRouter

技术图片

 

技术图片

 

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

 

以上是关于drf-路由组件的主要内容,如果未能解决你的问题,请参考以下文章

DRF框架路由组件

drf-路由组件

05 drf路由组件

DRF--路由组件和版本控制

DRF路由组件

自定义路由组件,Django的admin后台管理,DRF的三大认证,jwt认证