12. 结论
本文档介绍了使用 [Django] 框架开发 MVC Web 应用程序的过程:该应用程序的 HTML 页面由服务器使用 [Django] 模板生成,没有使用浏览器端的 [JavaScript] 框架。读者按部就班地学完了 [Symfony] 课程,而该课程本身又建立在 [Laravel]、[Flask]、[Spring MVC]、[ASP.NET Core MVC]和 [NestJS] 课程的基础之上:从视图和路由到模板、表单、国际化、安全和数据访问,最后是一个完整的案例研究。
因此,同样的 28 个示例和同一个应用程序,使用七种框架编写:使用 [TypeScript] 一次、[C#] 一次、[Java] 一次、[PHP] 两次、[Python] 两次。概念是相同的;只有名称和机制不同。[Symfony] 与 [Django] 之间的对应关系:
[Symfony] | [Django] |
核心([src/Kernel.php])、包(bundle)、服务容器、依赖注入 | 设置([config/settings.py])、应用([INSTALLED_APPS])、导入的模块、提供者([functools.cache]) |
[composer.json],文件夹 [vendor],[php bin/console] | [requirements.txt],虚拟环境([.venv]),[python manage.py] |
文件 [.env],文件夹 [config/packages] (YAML 文件),[%env(...)%] | 文件 [config/settings.py] (来自 [Python]),环境变量([os.environ]),[.env] ,由我们读取 |
[#[Route]] 控制器的属性 | 列表 [urlpatterns] ([path]、[re_path]、[include]),命名路由,[app_name] |
[render]、[redirectToRoute]、[generateUrl];[path] 用于视图 | [render]、[redirect]、[reverse];[{% url %}] 用于模板 |
对象 [Request]、[requirements] ([{id<\d+>}]),参数解析器,[#[MapQueryString]] | 对象 [HttpRequest] ([GET]、[POST]、[headers]、[COOKIES]),转换器([<int:id>]),作为验证器的表单 |
验证器组件(属性约束)、表单组件(类型、[handleRequest]、[isValid]) | [django.forms] 表单(字段、验证器、[clean]、[error_messages]、[is_valid]、[cleaned_data]) |
表单主题 [Bootstrap] 5 | 渲染引擎([FORM_RENDERER]),字段模板,[as_field_group] |
视图 [Twig]、[{{ }}]、[{% for %}]、[{% if %}] | DTL 模板,[{{ }}]、[{% for %}] …… [{% empty %}]、[{% if %}] |
[{% extends %}] 和块,[{% include %}],宏 | [{% extends %}] 和块,[{% include %}],命名片段([{% partialdef %}]) |
全局变量,扩展 [Twig] (函数、过滤器) | 上下文处理器,标签库([templatetags]:过滤器、简单标签、包含标签) |
闪存消息([addFlash]、[app.flashes]),基于文件的会话 | [messages] 应用(签名 Cookie),会话(文件、签名 Cookie、数据库等) |
内核事件监听器([kernel.request]、[kernel.controller]、[kernel.response]等) | 中间件([__call__]、[process_view]、[process_exception]),信号([request_started]、[request_finished]) |
监听器:[kernel.exception]、[HttpException]、[createNotFoundException] | [Http404]、[PermissionDenied]、[BadRequest],视图 [handler404]……、[process_exception] |
防火墙、认证器、[access_control]、[#[IsGranted]]、投票器 | 由我们编写的身份验证和访问控制中间件、装饰器;或 [django.contrib.auth] 应用 |
表单组件的防 CSRF 令牌,[csrf_token()]、[isCsrfTokenValid] | [CsrfViewMiddleware] 中间件,[{% csrf_token %}] 标签,[CSRF_FAILURE_VIEW] (403 响应,在我们的应用程序中为 419) |
组件 [RateLimiter] | 基于缓存编写的限流器 |
文件 [translations] (YAML、ICU),过滤器 [trans]、[TranslatorInterface] | 文件 [locale] ([gettext]:[.po]、[.mo]),[gettext]、[gettext_lazy]、[ngettext]、[{% translate %}]、[{% blocktranslate %}] |
[intl] 扩展:[IntlDateFormatter]、[NumberFormatter] | 基于当前语言的格式化(过滤器 [date]、[floatformat]),[Babel] |
缓存组件(PSR-6 及契约)、锁组件 | 缓存:[Django] ([LocMemCache]、[FileBasedCache]等),[get_or_set] |
[Doctrine]:数据映射器(Data Mapper)实体、实体管理器、DQL 和 QueryBuilder | ORM:[Django] 的 Active Record 模型、管理器([objects])、[QuerySet]、[select_related]、[F()] |
[wrapInTransaction(...)]、[flush] | [transaction.atomic()]、[select_for_update()] |
[#[ORM\Version]],由 [Doctrine] 管理([OptimisticLockException]) | [update()],依赖版本([filter(version=...)]),写在 DAO 层中 |
[php -S localhost:8000 -t public],或 [symfony server:start] | [python manage.py runserver] |
关于 [Symfony],需要注意的要点是:
- 该 [Django] 应用程序在服务器启动时加载一次,然后一直留在内存中处理所有请求(示例 01):启动时创建的对象(设置、路由、中间件、服务)由所有请求共享。这既简单又快速,但需要区分属于应用程序的内容(共享的,因此不含特定于某个请求的状态)和属于请求的内容([request] 对象、视图的局部变量),并且要记住,生产服务器会运行多个进程,这些进程只共享存储在进程之外的内容(数据库、文件缓存);
- 没有服务容器:服务是被导入的 [Python] 模块,以及在第一次请求时创建唯一对象的提供者函数。模块的依赖关系在其 [import] 语句中清晰可见;为测试目的替换它们是通过设置来完成的(示例 06);
- 配置是一个 [Python] 文件,即 [config/settings.py] :一系列可以计算、添加注释或拆分的赋值语句。命令 [python manage.py diffsettings] 显示与默认值不同的内容;
- 请求的处理会按照 [MIDDLEWARE] 列表中指定的顺序依次经过一系列中间件组件,然后在响应时按相反顺序经过:语言设置、防 CSRF 保护、身份验证、访问控制和错误页面都在这里处理。该机制比 [Symfony] 中的内核事件更简单:列表的顺序就是执行的顺序;
- 视图是接收请求并返回响应的简单函数;装饰器([@require_POST]、[@registration_pass_required])包装它们以添加控制。我们编写了好几个这样的装饰器,甚至还写了一个其方法就是视图的类([PersonManagement]),而无需 [Django] 提供任何特殊支持;
- 表单是由类描述的对象:字段、值转换、验证器、输入内容的重新显示以及错误消息。它们通过可替换的模板(渲染引擎、字段模板)进行渲染:整个应用程序中的字段都以相同的方式渲染,使用来自 [Bootstrap] 的类和无障碍属性;
- [Django] “开箱即用”:会话、消息、翻译、缓存、防 CSRF 保护、静态文件、ORM——一应俱全,文档集中在一处,无需额外安装。我们只添加了三个库:[MySQL] 驱动、[PyJWT]、和 [bcrypt]。功能非常全面的 [django.contrib.auth] 身份验证应用被舍弃了:案例研究的数据库有自己的用户,而且我们希望像应用程序的其他版本一样使用 JWT 令牌。用大约一百行代码从头编写身份验证代码,恰好展示了它究竟做了什么;
- 来自 [Django] 的 ORM 遵循 Active Record 模式:模型是与表相关联的类,每个对象都知道如何保存自己。它比 [Doctrine] 的数据映射器(Data Mapper)更直接,并且与现有数据库配合得也非常好([managed = False],此时表名和列名是预先确定的)。它惰性求值的 [QuerySet]、[select_related]、[F()] 表达式以及带条件的 [update()] 语句,使你能够编写高效而安全的查询,而且开发模式下的控制台会显示发送到数据库的每一条 SQL 命令;
- DTL 模板使用一种刻意受限的语言:没有算术运算,也不能带参数调用函数。模板只能显示提供给它的数据:这既是一种约束,也是一种保证,它把逻辑推向视图和视图模型。任何缺少的信息都通过用 [Python] 编写的过滤器和标签来补充。模板会自动转义它所显示的一切内容。
案例研究表明,一个不依赖 [JavaScript] 的经典 HTML 应用程序,仍然是一种简单而稳健的解决方案:每个页面就是一个 URL,浏览器的“后退”按钮可以正常工作,一切都由服务器控制。对 [JavaScript] 的极简使用(确认窗口)改善了用户体验,而功能并不依赖它。[Django] 也可以在不脱离其模板的情况下支持交互性更强的应用程序(例如使用 [htmx] 库,[Django] 6 的命名片段与之配合得非常好),或者配合浏览器端的 [JavaScript] 框架,为其提供 JSON API([Django REST framework]、[Django Ninja]):这将在其他文档中介绍。
如需进一步了解,请参阅 [Django] 的文档(docs.djangoproject.com,有法语译本),特别是有关视图和 URL、表单、模板、中间件、国际化、ORM 和安全的页面;还可参阅它的教程(涵盖管理界面和迁移,这些内容本文未涉及)、[Python] 教程(docs.python.org/fr),并将本应用程序与它的姊妹应用程序 [Symfony]、[Laravel]、[Flask]、[Spring MVC]、[ASP.NET Core MVC]和 [NestJS] 进行比较。