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个字符的限制,可以如下使用自定义表单:
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还废弃和移除了一些方法和属性。