Skip to content

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] 进行比较。