Migration Guide

Migrating from 1.3 to 1.4

由于django-rest-framework-jwt项目缺乏维护,Djoser已切换为使用django-rest-framework-simplejwt . 此更新包括一些向后不兼容的更改:

  1. 来自JWT创建端点的响应包括访问令牌和刷新令牌. 访问本质上与旧令牌相同,可用于验证请求. refresh用于获取新的访问令牌.

  2. JWT Refresh端点需要刷新令牌并返回新的访问令牌.

  3. JWT验证端点不再返回令牌 .

  4. django-rest-framework-simplejwt使用授权:Bearer <token> . 可以通过在Django设置中添加以下内容来覆盖它:

    SIMPLE_JWT = {
        'AUTH_HEADER_TYPES': ('JWT',),
    }
    

Migrating from 1.1 to 1.2

由于保留了向后兼容性,因此无需紧急更改任何内容. 话虽这么说,我们要求您将使用方式从旧的端点更改为新的端点,以便获得更加RESTful的温暖模糊感:)

Migrating from 0.x to 1.0

稳定版引入了许多向后不兼容的更改,本指南的目的是允许开发人员快速适应给定的项目.

Removal of UserEmailFactoryBase and its subclasses

如" 电子邮件"页面中所述,自从Djoser删除1.0电子邮件支持以来,对于以前由djoser电子邮件支持处理的用例,建议使用django-templated-mail . 您可以在项目文档中找到有关它的更多信息. 请记住,如设置页面中所述, DOMAINSITE_NAME设置也已移至django-templated-mail.

Base URLs are no longer included with other URLs

以前djoser.urls.basedjoser.urls.authtoken捆绑在一起,但是在某些情况下开发人员可能不需要它们,因此,如果需要基本URL,则现在必须显式包括它们,例如:

urlpatterns = [
    (...),
    url(r'^auth/', include('djoser.urls')),
    url(r'^auth/', include('djoser.urls.authtoken')),
]

Dropped support for Django < 1.10

Django REST Framework 3.7中已删除了对Django 1.8和1.9的支持,因此没有理由将其保留在djoser中. 建议升级到Django 1.11,因为1.10将于2017年12月停产.Django弃用时间表Django发行说明在此过程中非常有帮助.

Some View class names and URLs has been updated

另外请注意,为了保持一致,所有URL现在都以斜杠结尾. 斜杠是可选的,以确保与去除斜杠的前端工具(例如Google的Chrome浏览器和Angular框架)兼容.

查看课程名称:

  • RegistrationView已重命名为UserCreateView
  • LoginView已重命名为TokenCreateView
  • LogoutView已重命名为TokenDestroyView

基本网址:

  • register/已重命名为users/create/
  • register网址名称已重命名为user-create
  • activate/已重命名为users/activate/
  • activate URL名称已重命名为user-activate

基于令牌的身份验证URL:

  • login/已重命名为token/create/
  • login URL名称已重命名为token-create
  • logout/ has been renamed to token/destroy/
  • logout URL名称已重命名为token-destroy