1. 简介
本文档的 PDF 版本在 |此处|。
本文档的代码在 |此处|。
本文档由Anthropic 的 AI Claude生成。其目的是从两个方面改编文档《客户端/服务器示例——AngularJS 1.x / Spring 4》:
- 将 AngularJS 1.x 客户端替换为 [Flutter] 3 客户端;
- 将 Java Spring MVC Web 框架替换为 Web 框架 [NestJS];
Anthropic 的 Claude (AI)完成了大部分工作(90%):
- 代码生成:所有代码均由 Claude 生成。我只是按照生成的课程对其进行了测试;
- 生成 ODT 格式的课程:Claude 应我的要求生成了多个版本。我主要参与的就是这一部分。
注 1:如果读者的主要目标是“学习 NestJS”,可以参阅文档《通过示例介绍 TypeScript 语言和 NestJS Web 框架》,其中概述了这个 Web 框架。在本文档中,NestJS 服务器被当作黑盒:会告诉您如何使用它,但不描述其代码。
注 2:Flutter 的编程语言是 Dart。有兴趣学习 Dart 语言基础知识的读者可以阅读课程《通过示例介绍 Dart 语言》(2026)。
注 3:Claude 经常提到 Angular、React 和 Vue.js 框架。Claude 写过三门关于这些框架的课程,对它们记忆犹新,因此会引用它们:
- [一个 Angular/NestJS 客户端/服务器示例(2026)];
- [一个 React/NestJS 客户端/服务器示例(2026)];
- [一个 Vue.js/NestJS 客户端/服务器示例(2026)];
注 4:如果您觉得 Claude 的讲解不够充分,可以就其课程中的某个具体问题向 Claude 请求进一步说明,这通常很有帮助。
Serge Tahé,2026 年 9 月
==
本文档是课程《客户端/服务器示例 - AngularJS 1.x / Spring 4,》的续作,该课程写于 2014 年。原文档使用Spring 4 / Spring Data / Spring MVC 服务器和 AngularJS 1.x 客户端构建了一个用于安排医疗预约的小型应用(“[RdvMedecins]”)。
十二年过去,所用的两个框架已发生重大演变,甚至在常规使用中已被取代:
- 在服务器端,[NestJS] 已成为构建结构化 Web 应用时使用最广泛的 Node.js/TypeScript 框架之一,其理念与 Spring 相似(模块、控制器、服务、依赖注入),但处于 JavaScript/TypeScript 生态之中;
- 在客户端,AngularJS 1.x 自 2016 年起被彻底重写,更名为[Angular] (版本 2、4、5……直至版本 22)——本课程中[Angular] / [NestJS] 变体所采用的方法:《客户端/服务器示例——Angular / NestJS(2026)》。本文档则采用不同的方法:[Flutter] (由 Google 创建,2018 年 12 月发布首个稳定版本),一个“跨平台”框架:只需用[Dart]语言编写一份代码库,即可生成移动、桌面和 Web 应用——其界面不是由 HTML 模板描述,而是由组件(Widget)树描述(见第 3 章)。
本文档的目标是重温原先的案例研究——同样的应用、同样的功能、同样的数据库——并使用当前的工具重新构建它,同时尽可能保持与 2014 年文档相同的教学进程。
1.1. 分步重构
原文档约有 300 页,除应用的核心功能(基于角色的身份验证(Spring Security))外,还包含十二个循序渐进的示例,用于分步学习 AngularJS 1.x。一次性重构所有这些内容既耗时又难以消化。
因此,本文档涵盖重构的前两个步骤:
- 应用的总体架构(原则上不变);
- 数据库(保持不变,只是增加了[users]表);
- 安装本文档随附的完整[NestJS]服务器,并使用Postman测试其预约查看以及预订/取消功能——此处不涉及其代码,因为本文档专注于[Flutter];
- 该服务器基于令牌的身份验证(JWT)和基于角色的访问控制(ADMIN/USER),相当于原文档中的 Spring Security 层——我们只学习如何使用它,先通过Postman ,再通过客户端;
- 对应的[Flutter]客户端,具有相同的功能:登录界面、与已登录用户角色相适应的界面([Material Design]),以及在法语和英语之间切换界面的能力([TranslationsService])。
原文档的两项功能在现阶段不包含在本文档中:原客户端的“调试”模式(显示当前视图的原始模板),它已在本次移植中被有意省略(该决定的理由见第 6 章);以及人为网络延迟的配置,它被推迟到后续阶段。
1.2. 本文档的读者对象
本文档不要求您事先了解[NestJS] 或[Flutter]。每个新概念(装饰器、依赖注入、组件、信号等)在出现时都会尽可能详细地加以解释——即使读者从未写过一行 TypeScript 或 Dart 代码。
不过,具备一些基础知识有助于更好地利用本文档:
- 对 Dart 语言有基本了解(变量、函数、数组、对象);
- 对 Web 应用中的 HTTP 交互有基本了解(GET/POST 方法、JSON 格式);
- 了解 HTML 语言中的常见标签;
- 会使用命令行(cd、npm install……)。
您无需事先熟悉TypeScript语言(用于服务器端):它是 JavaScript 的超集,增加了类型系统,文档中每当用到它时都会加以说明。用于客户端的[Dart]语言也是如此,它将在第 3 章中介绍。有兴趣的读者可以参阅文档*《通过示例介绍 Dart 语言》*(2026),其中对 Dart 作了详细讲解。
1.3. 应用的架构
应用的总体架构自原文档以来没有变化:
- Web 服务器向客户端提供单一界面,该界面基于组件模型(视图 + 相关逻辑),并依靠服务与服务器通信——本课程中 [Angular]/[React]/[Vue.js] 客户端使用浏览器,而对于本客户端 [Flutter],则可以是浏览器、移动操作系统或桌面操作系统(见第 5 章);
- 用户与浏览器中显示的视图交互。用户的操作有时需要向服务器 [NestJS]发出请求,服务器处理请求并返回 JSON (JavaScript Object Notation)响应;该响应用于更新呈现给用户的视图。
所考察的应用将具有如下架构:

- 在 [1] 中,[Flutter]应用的用户向该应用的 [Presentation] 层 [2] 发出请求;
- 为了执行用户请求的操作,[Presentation] 层 [2] 可能会向 [Services] 层 [3] 发出请求;
- 为了提供所请求的服务,[3] 层可能需要向 [4],即由 [NestJS]实现的远程 JSON 服务器发出请求;
- 根据 [5] 中收到的请求,可能会查询 [6-8] 层;
- 服务器的响应以相反的顺序沿 [2-8] 层逐层返回;
- 显示给用户的视图 [1] 反映了该响应;
注意:如果您对项目的架构感到困惑,请回头参阅此图。请注意,DBMS 由服务器使用,而不是由客户端使用。
1.4. 所用工具
本文档使用以下工具(其安装详见第 1 章和第 2 章):
- Node.js (22 或更高版本)及其包管理器 npm——在 JavaScript 生态中,它相当于原 Spring 服务器所用的 Java + Maven;
- Visual Studio Code (VSCode),一款免费的代码编辑器,及其 TypeScript 扩展——相当于原文档中使用的 Spring Tool Suite(STS)和 WebStorm;
- [Flutter] SDK(包含 [Dart] SDK)需在系统范围内安装一次——这与本课程之前的 Web 客户端所用的 [Vite]不同,后者无需系统级安装;
- [MySQL] 8 用于数据库(原文档使用的是 [MySQL] 5——关系模式本身不变);
- [Android Studio] (连同其 [Android] SDK 和命令行工具),用于将应用编译到 [Android] 手机上,这是本课程的移动端目标平台——详细安装说明见第 1 章;
- Postman (或任何其他 HTTP 客户端),用于测试响应 POST 请求的服务器 URL(/addAppointment、/deleteAppointment)——Web 浏览器只能测试 GET 请求。
1.5. 应用功能
[RdvMedecins]应用的“业务”功能与原文档相比保持不变;不过,访问控制比原来稍为健壮(见下表):
- 一家医疗诊所聘有多名医生,每位医生都有各自的诊疗时段;
- 用户必须登录(用户名/密码)才能访问应用;
- 登录后,用户可以选择医生和日期,并查看该医生当天的日程:每个时段显示为可预约或已预订;
- 角色为 ADMIN 的用户还可以为其选定的患者预订空闲时段,并取消已有的预约;
- 角色为 USER 的用户可以查看日程,但不能预订或取消(只读访问)——这是与原文档有意设置的差异:在原文档中,USER 角色仅用于演示拒绝访问,根本无法查看任何内容(关于这一选择的理由,见第 2 章“创建数据库”一节)。

1.6. 哪些变了,哪些没变
原文档(2014) | 本文档(2026) | |
[MySQL] 5,表 MEDECINS/CLIENTS/CRENEAUX/RV | [MySQL] 8,表、列、约束均相同(现在使用英文名称) | |
Java、Spring 4、Spring Data(JPA/Hibernate)、Spring MVC | TypeScript、[NestJS]、[TypeORM],对外暴露的 URL 相同 | |
JavaScript、AngularJS 1.x、Bower | Dart、[Flutter] (Material 组件(Widget),包 [provider]),pub | |
Bootstrap 3 | 无([Material Design] 已集成到 [Flutter] 组件(Widget)中) | |
Spring Security、HTTP Basic,角色存放在 3 张表中;只有 ADMIN 使用该应用 | Passport/JWT([@nestjs/passport]、[@nestjs/jwt]),每个请求都携带一个已签名的令牌,角色存放在单个列中,ADMIN 拥有完全访问权限,USER 为只读 | |
angular-translate 库 | [TranslationsService] (自行编写,内嵌词典) |
1.7. 本文档的结构
- 搭建工作环境——安装工具并创建 [Flutter]项目。
- 安装 [NestJS] 服务器——安装 Laragon 和数据库 [MySQL],配置、启动并测试服务器,然后首次运行 [Flutter]客户端。
- [Flutter]入门——框架的基础知识(组件(Widget)、StatelessWidget/StatefulWidget、provider),并回顾已在 [Angular]、[React] 和 [Vue.js]中讲过的概念。
- [RdvMedecins]应用的 [Flutter]客户端——客户端架构、其每一个文件(包括登录界面),以及对整个应用的分步演练。
- 将 [Flutter]应用移植到移动端、桌面端和 Web——同一份源代码如何编译为这三类目标平台,以及针对每一类需要了解的事项(网络、移动端特有的限制)。
- 结论与后续步骤。