路由Routers

路由Routers

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

REST framework提供了两个router

• SimpleRouter
• DefaultRouter

一 、使用方法

1. 建立router对象，并注册视图集，例如

from rest_framework import routers

router = routers.DefaultRouter()
router.register(r'router_stu', StudentModelViewSet, base_name='student')

register ( prefix, viewset, base_name )

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

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

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

1. 添加路由数据

能够有两种方式：

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

或

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

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

from rest_framework.viewsets import ModelViewSet,ReadOnlyModelViewSet

class StudentModelViewSet(ModelViewSet):
    queryset = Student.objects.all()
    serializer_class = StudentModelSerializer

    def login(self,request):
        """学生登陆功能"""
        print(self.action)
        return Response({"message":"登陆成功"})

路由代码：

from django.urls import path, re_path
from . import views

urlpatterns = [
    ...
]

"""使用drf提供路由类router给视图集生成路由列表"""
# 实例化路由类
# drf提供一共提供了两个路由类给咱们使用,他们用法一致,功能几乎同样
from rest_framework.routers import DefaultRouter
router = DefaultRouter()

# 注册视图集
# router.register("路由前缀",视图集类)
router.register("router_stu",views.StudentModelViewSet)

# 把生成的路由列表追加到urlpatterns
print( router.urls )
urlpatterns += router.urls

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

因此咱们若是也要给自定义方法生成路由，则须要进行action动做的声明。

二 、视图集中附加action的声明

在视图集中，若是想要让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.viewsets import ModelViewSet
from rest_framework.decorators import action

class StudentModelViewSet(ModelViewSet):
    queryset = Student.objects.all()
    serializer_class = StudentModelSerializer

    # methods 设置当前方法容许哪些http请求访问当前视图方法
    # detail 设置当前视图方法是不是操做一个数据
    # detail为True，表示路径名格式应该为 router_stu/{pk}/login/
    @action(methods=['get'], detail=True)
    def login(self, request,pk):
        """登陆"""
        ...
        pass

    # detail为False 表示路径名格式应该为 router_stu/get_new_5/
    @action(methods=['put'], detail=False)
    def get_new_5(self, request):
        """获取最新添加的5个学生信息"""
        ...
        pass

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

^router_stu/get_new_5/$    name: router_stu-get_new_5
^router_stu/{pk}/login/$   name: router_stu-login

三 、路由router造成URL的方式

3.1 SimpleRouter

3.2 DefaultRouter

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

为了方便接下来的学习，咱们建立一个新的子应用 opt

python manage.py startapp opt

由于接下来的功能中须要使用到登录功能，因此咱们使用django内置admin站点并建立一个管理员.

python manage.py createsuperuser

建立管理员之后，访问admin站点，先修改站点的语言配置

settings.py

访问admin站点 : http://127.0.0.1:8000/admin/