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),
- 1
可以写作:
path('articles/<int:year>/', views.year_archive),
- 1
新语法支持强制定义参数类型。例子中只接收整数型年份参数,不再接收字符串类型,同时“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及其子类的表单输入为空;
三、重要的向后不兼容
-
某些地方删除对bytestrings的支持
例如,对于reverse(),现在使用str()代替force_text()。 -
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)
- 1
- 2
- 3
如果你需要在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)
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
3 . QuerySet.reverse()和last()不
能用于切片后的查询集
对切片后的查询集使用反转和获取最近对象的操作将弹出异常,如下所示:
Traceback (most recent call last):
...
TypeError: Cannot reverse a query once a slice has been taken.
- 1
- 2
- 3
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', ...)
- 1
- 2
7 . SQLite现在支持外键约束
另外,Django2.0还废弃和移除了一些方法和属性