Django 2.0 新特性

---

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从句；

Pagination分页

• 增加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个字符的限制，可以如下使用自定义表单：

from django.contrib.auth.forms import UserChangeForm

class MyUserChangeForm(UserChangeForm):
    last_name = forms.CharField(max_length=30, required=False)

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

from django.contrib.auth.admin import UserAdmin
from django.contrib.auth.models import User

class MyUserAdmin(UserAdmin):
    form = MyUserChangeForm

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

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

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

>>> Model.objects.all()[:2].reverse()
Traceback (most recent call last):
...
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属性，如下所示：

class MyCommand(BaseCommand):
    stealth_options = ('option_name', ...)

7. SQLite现在支持外键约束

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