Skip to content

Django 是 Python Web 开发最常用的框架之一,跟进它的最新变化绝对是必须的。

2017年12月2日,Django官方发布了2.0版本,成为多年来的第一次大版本提升,那么2.0对广大Django使用者有哪些变化和需要注意的地方呢?

一、Python兼容性

Django 2.0支持Python3.4、3.5和3.6。Django官方强烈推荐每个系列的最新版本。

最重要的是Django 2.0不再支持Python2!

Django 1.11.x是支持Python2.7的最后版本。

二、2.0新特性

1.简化了URL路由语法

django.urls.path()方法的语法更简单了。

例如以前的: url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),

可以写作: path('articles/<int:year>/', views.year_archive),

新语法支持强制定义参数类型。例子中只接收整数型年份参数,不再接收字符串类型,同时'10000'年也是合法的(虽然是5位数字),而不像先前正则里只能接收4位数字。

以前版本的 django.conf.urls.url()方法变成了 django.urls.re_path(),但为了向后兼容,旧的依然保留,而不是立刻废弃。 django.conf.urls.include()方法现在可以从 django.urls导入,也就是你可以使用 from django.urls import include, path, re_path

2.admin后台对移动端更加友好

Django最受大家欢迎的admin后台,具有响应式特性,支持主流的移动设备。

3.Window 表达式

新的Window表达式允许为查询集添加一个OVER从句。

4.小特性

django.contrib.admin后台

新的 ModelAdmin.autocomplete_fields属性和 ModelAdmin.get_autocomplete_fields()方法现在可以在外键和多对多字段上使用Select2搜索框。

django.contrib.auth用户认证

PBKDF2密码哈希默认的迭代次数从36000增加到100000。

django.contrib.gis地理框架

  • 为AsGeoJSON、GeoHash和GeoHash方法,isvalid和distance查询增加MySQL支持;

  • 添加Azimuth和LineLocatePoint方法,支持PostGIS和SpatiaLite;

  • 所有从GeoJSON导入的GEOSGeometry拥有SRID集合;

  • 添加 OSMWidget.default_zoom属性,用于自定义地图的默认缩放级别;

  • metadata现在是可读可编辑的;

  • 允许在GDAL的内部虚拟文件系统中创建GDALRaster对象;

  • 新的 GDALBand.color_interp()方法返回波段的颜色说明。

django.contrib.postgres数据库

  • ArrayAgg新增distinct参数;

  • 新的RandomUUID函数;

  • django.contrib.postgres.indexes.GinIndex现在支持 fastupdate和 gin_pending_list_limit参数;

  • 新的GistIndex类允许在数据库中创建GiST索引;

  • inspectdb现在可以内省JSONField和RangeFields。

django.contrib.sitemaps站点地图

  • 为GenericSitemap构造器增加protocol参数;

Cache缓存

  • cache.set_many()现在返回一个列表,包含了插入失败的键值;

File Storage文件存储

  • File.open()现在可以用于上下文管理器,例如 with file.open() as f:

Forms表单

  • SplitDateTimeWidget和 SplitHiddenDateTimeWidget增加 date_attrs与 time_attrs参数,用于为 DateInput与 TimeInput指定HTML属性;

  • 新的 Form.errors.get_json_data()方法返回字典类型的表单错误,以适应JSON类型x响应;

Generic Views通用视图

  • 新的 ContextMixin.extra_context属性允许在 View.as_view()中添加上下文;

Management Commands管理命令

  • inspectdb现在将MySQL的无符号整数视作 PositiveIntegerField或者 PositiveSmallIntegerField;

  • 新增 makemessages --add-location选项;

  • loaddata现在可以从标准输入读入;

  • 新增 diffsettings --output选项;

Migrations迁移

  • 新增 squashmigrations --squashed-name选项;

Models模型

  • 新增StrIndex数据库函数;

  • 对于Oracle数据库,AutoField和BigAutoField现在会生成identity列;

  • QuerySet.iterator()新增 chunk_size参数;

  • QuerySet.earliest()、 QuerySet.latest()和 Meta.get_latest_by现在可以根据一些字段进行排序;

  • 增加ExtractQuarter方法,用于DateField和DateTimeField;

  • 新增TruncQuarter方法用于截取DateField和DateTimeField到季度的第一天;

  • 为基于类的索引添加 db_tablespace参数;

  • 为 QuerySet.select_for_update()增加of参数,但只支持PostgreSQL和Oracle数据库;

  • QuerySet.in_bulk()新增 field_name参数;

  • CursorWrapper.callproc()现在接收可选的字典类型关键字参数;

  • QuerySet.values_list()新增named参数,用于获取命名的元组结果;

  • 新的FilteredRelation类允许为查询集增加一个ON从句;

  • 增加 Paginator.get_page(),可以处理各种非法页面参数,防止异常;

Requests and Responses请求和相应

  • 现在,runserver服务器支持HTTP 1.1;

Templates模版

  • 为了提高 Engine.get_default()在第三方模块的用途,现在它将返回配置在TEMPLATES中的多个DjangoTemplates引擎中的第一个,而不是弹出ImproperlyConfigured错误;

  • 自定义模版标签现在接收强制关键字参数;

Tests测试

  • 为LiveServerTestCase添加多线程支持;

Validators验证器

  • 新的ProhibitNullCharactersValidator不允许CharField及其子类的表单输入为空;

三、重要的向后不兼容

1. 某些地方删除对bytestrings的支持

例如,对于reverse(),现在使用str()代替force_text()。

2. AbstractUser.last_name的最大长度增加到150

如果你有一个自定义的用户模型继承了AbstractUser,你需要生成并应用一个数据库迁移,使得 last_name的最大长度变为150。

如果你需要为 last_name保持30个字符的限制,可以如下使用自定义表单:

  1. from django.contrib.auth.forms import UserChangeForm

  2. class MyUserChangeForm(UserChangeForm):

  3.    last_name = forms.CharField(max_length=30, required=False)

如果你需要在admin中也保持这个约束,那么可以如下使用UserAdmin.form:

  1. from django.contrib.auth.admin import UserAdmin

  2. from django.contrib.auth.models import User

  3. class MyUserAdmin(UserAdmin):

  4.    form = MyUserChangeForm

  5. admin.site.unregister(User)

  6. admin.site.register(User, MyUserAdmin)

3. QuerySet.reverse()和last()不能用于切片后的查询集

对切片后的查询集使用反转和获取最近对象的操作将弹出异常,如下所示:

  1. >>> Model.objects.all()[:2].reverse()

  2. Traceback (most recent call last):

  3. ...

  4. TypeError: Cannot reverse a query once a slice has been taken.

4. 表单的字段不再接收可选参数作为位置参数

为了防止运行时错误,提高可靠性。以前类似下面的参数传递方法,现在是错误的了: forms.IntegerField(25, 10)

要这么传递: forms.IntegerField(max_value=25, min_value=10)

5. Index不再接收位置参数

例如下面的用法将导致异常: models.Index(['headline', '-pub_date'], 'index_name')

要提供参数关键字,改写为: models.Index(fields=['headline', '-pub_date'], name='index_name')

6. call_command()将验证它接收的选项

对于使用选项而不是使用 parser.add_argument()进行自定义的管理命令,需要添加一个 stealth_options属性,如下所示:

  1. class MyCommand(BaseCommand):

  2.    stealth_options = ('option_name', ...)

7. SQLite现在支持外键约束

另外,Django2.0还废弃和移除了一些方法和属性。