Skip to content

12. 结论

本文档介绍了使用 [Flask] 框架开发 MVC Web 应用程序的过程:该应用程序的 HTML 页面由服务器使用 [Jinja2] 视图生成,不使用浏览器端的 [JavaScript] 框架。本文档分步遵循 [Spring MVC] 课程,而该课程本身又建立在 [ASP.NET Core MVC] 和 [NestJS] 课程的基础之上:从操作和路由到视图、表单、国际化、安全和数据访问,最后是一个完整的案例研究。

同样的 28 个示例和同一个应用程序,就这样用四种语言编写了出来:[TypeScript]、[C#]、[Java]和 [Python]。概念是相同的;不同的只是名称和机制。[Spring MVC] 与 [Flask] 之间的对应关系:

Spring MVC
Flask
类 [@SpringBootApplication],类 [@Configuration],方法 [@Bean]
工厂 [create_app],对象存放在 [app.extensions]
文件 [pom.xml],starter [Maven]
文件 [requirements.txt],虚拟环境,[pip]
[application.properties],配置文件(profile),[@ConfigurationProperties]
[config.py],[config_<profile>.py],变量 [FLASK_...] ([app.config])
依赖注入:单例 bean,[@Service],[@Component]
由工厂手动创建的对象,通过 [current_app] 获取
[@Controller],[@GetMapping],[@PostMapping],视图名称,或 [redirect:...]
蓝图,[@bp.get],[@bp.post],[render_template],[redirect]
模型绑定,[@RequestParam],转换器
[request.args],[request.form],[Werkzeug] 转换器([<int:id>])
[Bean Validation]:[@NotBlank],[@Min],[@Max]……,[@Valid],[BindingResult]
[Pydantic] (参数、JSON);[WTForms]:验证器,[form.validate()],[form.errors]
视图 [Thymeleaf] ([.html]),[th:text],[th:each],[th:if]
视图 [Jinja2],[{{ }}],[{% for %}],[{% if %}]
模板和片段([th:replace],[th:fragment])
[{% extends %}] 和块,[{% include %}],宏
[@ControllerAdvice] 和 [@ModelAttribute]
上下文处理器([@app.context_processor])
闪现属性([RedirectAttributes])
闪现消息([flash],[get_flashed_messages]),存放在会话 Cookie 中
Servlet 过滤器,拦截器
WSGI,[before_request],[after_request],[teardown_request] 中间件
[@ControllerAdvice] / [@ExceptionHandler],[ErrorController]
[@app.errorhandler]
[Spring Security]:[SecurityFilterChain],资源服务器,[@PreAuthorize]
[before_request] 和手写的装饰器([PyJWT],[bcrypt])
CSRF 防护,来自 [Spring Security]
[CSRFProtect] 来自 [Flask-WTF]
由 [MessageSource] 读取的 JSON 字典,[#{...}],或 [LocaleResolver]
JSON 字典,[t(...)] 视图函数,[g.language] 由 [before_request] 设置
[Spring Data JPA] 和 [Hibernate],[JpaRepository],派生查询,[JPQL]
[SQLAlchemy]:映射的实体,[select(...)],会话,手写的 DAO 类
[@Transactional],[TransactionTemplate]
[with sessions.begin() as session:]
[@Version],由 [Hibernate] 管理
[version_id_col],由 [SQLAlchemy] 管理
[mvnw spring-boot:run],[Spring Boot DevTools]
[python app.py] 在调试模式下(自动重新加载)
可执行归档文件([java -jar]),包含 [Tomcat] 在内
WSGI 服务器:[Waitress],[Gunicorn]

与 [Spring MVC] 相比,需要注意的要点有:

  • [Flask] 是一个微框架:它提供路由、请求和响应、[Jinja2] 视图以及会话管理,仅此而已。其他一切(验证、表单、安全、数据访问、翻译)都由开发者选择的库来处理,或由开发者自己编写。这意味着要编写更多的代码,但这些代码是透明的:没有任何事情是“靠魔法”发生的,你可以追踪每个对象,从它的创建(在 [create_app] 中)到它的使用;
  • 没有依赖注入容器:共享对象由工厂创建,存放在 [app.extensions] 中,并通过 [current_app] 获取。对于这种规模的应用程序,这简单而且够用;
  • 对象 [request]、[g]、[session] 和 [current_app] 是代理 ,在请求期间指向该请求的对象。它们省去了在函数之间传递请求的麻烦,但只能在处理请求期间(或在手动创建的应用程序上下文中)使用;
  • [Python] 的装饰器 与 [Java] 的注解作用相同:路由、标记([@public])和访问控制([@roles_required])。但装饰器只是一个函数,你自己只需几行就能写出来;
  • [Python] 是一种动态类型语言:类型注解([list[Doctor]]、[Protocol]、泛型类)为代码提供文档并指导编辑器,但不会在运行时检查。[Pylance] (在 [Visual Studio Code] 中)或 [mypy] 之类的工具会在执行前检查它们;
  • [SQLAlchemy] 需要编写 DAO 层(每个请求几行代码),但它的查询是用 [Python] 对象构造的,仍然贴近它所生成的 SQL,而显示 SQL([SQL_ECHO])命令可以让你验证发送给数据库的是什么。关系的加载是显式控制的,逐个查询地控制;
  • [Jinja2] 视图把 HTML 与 [{{ }}] / [{% %}] 标签混合在一起:它们不像 [Thymeleaf] 的视图那样是有效的 HTML 页面,但它们的语言类似于 [Python],功能强大(过滤器、宏、模板继承),并且自动转义可防止 HTML 注入。

案例研究表明,不依赖 [JavaScript] 的经典 HTML 应用程序,仍然是一种简单而稳健的解决方案:每个页面都是一个 URL,浏览器的“后退”按钮可以正常工作,服务器掌控一切。对 [JavaScript] 的有限使用(确认窗口)改善了用户体验,而应用程序的运行并不依赖它。

如需了解更多信息,可以查阅 [Flask] (flask.palletsprojects.com)、[Jinja2] (jinja.palletsprojects.com)、[Werkzeug](werkzeug.palletsprojects.com)、[WTForms] (wtforms.readthedocs.io)和 [Flask-WTF](flask-wtf.readthedocs.io)、[SQLAlchemy] (docs.sqlalchemy.org)、[Pydantic](docs.pydantic.dev)的文档,并将本应用程序与其对应版本 [Spring MVC]、[ASP.NET Core MVC]、和 [NestJS] 进行比较。