Django 3.2 新功能尝鲜
Django 3 版本系列的 LTS（长期支持版本）马上就要在 4 月份发布，这个版本将会陪伴我们两年之久。在新版本发布前夕来提前了解下有哪些有趣的新功能，这些功能在发布时应该不会变动了。
安装一个 3.2 的 Django 版本
截止到 3 月 9 日，已发布Django beta2版本。Django 3.2 仅支持 Python3.6、3.7、3.8 和 3.9，安装时注意 Python 版本。
1、创建虚拟环境
$ mkdir django3
$ cd django3
$ python3.6 -m venv venv
$ source venv/bin/activate2、安装 django3.2 b1
(venv) $ pip install git+https://github.com/django/django@3.2b13、创建新的项目和 app ，防止你本地环境影响，这里直接使用虚拟环境中的命令来创建
(venv) $ venv/bin/django-admin startproject django3
(venv) $ cd django3
(venv) $ python manage.py startapp blog4、将 app 添加到 settings。
# settings.py
INSTALLED_APPS = [
# ...
'blog',
]
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'django3',
'USER': 'root',
'PASSWORD': 'Root1024',
'HOST': '127.0.0.1',
'PORT': '3306',
}
}5、创建 model 用来测试：
from django.db import models
class Blog(models.Model):
title = models.CharField(max_length=1000)
create_at = models.DateTimeField()6、生成数据表：
(venv) $ python manage.py makemigrations
(venv) $ python manage.py migrate7、随便构造点数据：
import string
import datetime
import random
import pytz
import os
import sys
BASE_DIR = os.path.dirname(os.path.dirname(__file__))
sys.path.append(os.path.join(BASE_DIR, '..'))
os.environ['DJANGO_SETTINGS_MODULE'] = 'django3.settings'
import django
django.setup()
from blog.models import Blog
starting_at = pytz.UTC.localize(datetime.datetime(2020, 1, 1))
DAY = datetime.timedelta(days=1)
Blog.objects.bulk_create((Blog(
title=''.join(random.choices(string.ascii_letters + ' ' * 10, k=random.randint(10, 20))),
create_at=starting_at + (DAY * random.random() * 365),
) for _ in range(10000)))好了，现在我们有 Django3.2 的环境了，下面开始搞起。
新功能体验
模型自增主键的类型修改
在之前的版本中，当模型中没有定义主键时，django 会自动增加一个类型为 AutoField 的字段 id作为主键，它是 IntegerField 的子类，范围为-2147483648 to 2147483647 。
在 Django 3.2 版本中，自增主键的类型替换为 BigAutoField 范围为 1 to 9223372036854775807。除此之外，在settings配置中显式的增加了 DEFAULT_AUTO_FIELD 变量。若你不想修改源数据库的字段类型话，在升级时，在settings中最好显式的添加如下配置：
DEFAULT_AUTO_FIELD = 'django.db.models.AutoField'admin 站点新的装饰器
在自定义 admin 模型展示字段的时候，之前是在所需字段直接赋值，现在使用 display 使代码变得更优雅。
# docs see https://docs.djangoproject.com/en/dev/releases/3.2/#new-decorators-for-the-admin-site
from django.contrib import admin
from .models import Blog
@admin.register(Blog)
class BlogAdmin(admin.ModelAdmin):
list_display = (
'id',
'create_at',
'create_at_year',
'title',
)
# 老的实现方式
# def create_at_year(self, obj: Blog) -> str:
# return obj.create_at.year
# create_at_year.admin_order_field = 'create_at__year'
# create_at_year.short_description = 'Year created'
@admin.display(ordering='create_at__year', description='Year created')
def create_at_year(self, obj: Blog) -> str:
return obj.create_at.yearadmin 后端支持主题配置
admin 的样式颜色采用了 css 变量来定义，我们可以直接重新 base.html 模板，在其中定义 css变量即可，不用再去重新覆盖具体的css文件。官网的例子：
{% extends 'admin/base.html' %}
{% block extrahead %}{{ block.super }}
<style>
:root {
--primary: #9774d5;
--secondary: #785cab;
--link-fg: #7c449b;
--link-selected-fg: #8f5bb2;
}
</style>
{% endblock %}我们会看到如下的 admin 页面。
Model 增加了个 JSONObject 函数
我们可以使用JSONOject功能函数实现自定义 json 字段的功能，如下 blog对象实例多了一个json格式的json_obj字段：
>>> from django.db.models.functions import JSONObject, Lower, TruncDay
>>> import pytz
>>> Blog.objects.annotate(json_obj=JSONObject(title=Lower('title'), creat_year=TruncDay('create_at', tzinfo=pytz.UTC)))
>>> blog = Blog.objects.annotate(json_obj=JSONObject(title=Lower('title'), creat_year=TruncDay('create_at', tzinfo=pytz.UTC))).first()
>>> blog.json_obj
{'title': 'zjy dqaiab ', 'creat_year': '2020-02-12 00:00:00.000000'}带省略号的分页器
Django3.2 分页器 Paginator 对象增加了get_elided_page_range方法 ，它类似page_range ，输出的是页数区间的生成器，会根据配置将中间页数用省略号代替。该方法有两个参数on_each_side和on_ends，省略号前边显示页数个数为on_each_side+1，省略号后边页数个数为on_ends。以后我们在写分页的时候，再也不用自己处理了，期待。
>>> from django.core.paginator import Paginator
>>> page_obj = Paginator(blogs, page_size)
>>> page_obj.get_elided_page_range(on_each_side=3, on_ends=2)
<generator object Paginator.get_elided_page_range at 0x10fb2f620>
>>> list(page_obj.get_elided_page_range(on_each_side=3, on_ends=2))
[1, 2, 3, 4, '…', 999, 1000]其他可能会用到的更新
- 覆盖索引，文档描述「include is ignored for databases besides PostgreSQL. 」，在 mysql 数据库上使用，只会创建单字段索引，mysql 中只能使用联合索引以达到覆盖查询字段的效果。
- 函数索引，文档描述Functional indexes are ignored with MySQL < 8.0.13 and MariaDB as neither supports them.，但我使用 8.0.17 测试仍有语法问题，期待正式版发布吧。
- 文件上传增加新的[FileUploadHandler.upload_interrupted()](https://docs.djangoproject.com/en/dev/ref/files/uploads/#django.core.files.uploadhandler.FileUploadHandler.upload_interrupted "FileUploadHandler.upload_interrupted( "FileUploadHandler.upload_interrupted()")")信号用来通知上传中断，可以做些后续的工作。
QuerySet.select_for_update()查询锁的实现，目前支持不是很好，需要的数据库版本都比较高。「Currently, the postgresql, oracle, and mysql database backends support select_for_update(). However, MariaDB 10.3+ supports only the nowait argument and MySQL 8.0.1+ supports the nowait, skip_locked, and of arguments. The no_key argument is supported only on PostgreSQL.」期待后续更新吧。- PostgreSQL 9.5 的上游支持将于 2021 年 2 月结束。Django3.2 支持 PostgreSQL 9.6 及更高版本。
- 对 MySQL 5.6 的上游支持将于 2021 年 4 月结束。Django 3.2 支持 MySQL 5.7 和更高版本。
总结
总的来说 Django3.2 并没有大的更新，延续了 3.1 的很多功能，对 Model 性能和实用性方面做了不少优化，针对 postgreSQL 偏多，有些功能要求 mysql 版本都在 8.0 以上。期待的异步功能并没有更新，看来“异步 Django”的愿望实现还需要时间。
上边完整代码可从github获取，地址为 https://github.com/pylixm/django_32_demo
好了，今天的分享就到这里吧，欢迎留言讨论你觉着超赞的Django新功能~
我是DeanWu，一个努力成为真正SRE的人。
关注公众号「码农吴先生」, 可第一时间获取最新文章。回复关键字「go」「python」获取我收集的学习资料，也可回复关键字「小二」，加我wx拉你进技术交流群，聊技术聊人生~
