1. 简介
本文档的 PDF 版本在 |这里|。
本文档的代码在 |这里|。
本文档由 Anthropic 的 IA Claude 生成。其目的是从两个方面改编文档 “客户端/服务器示例——AngularJS 1.x / Spring 4”:
- AngularJS 1.x 客户端被替换为使用 [Kotlin] 和 [Jetpack Compose] 编写的原生 Android 应用;
- Java Spring MVC Web 框架被替换为 Web 框架 [NestJS];
为此,本文档逐章沿用文档 “客户端/服务器应用示例——Flutter / NestJS(2026)”的结构:服务器相同、数据库相同、客户端架构相同——只有客户端框架不同,Flutter(Dart)被 Jetpack Compose(Kotlin)取代。
Anthropic 的 Claude(IA)完成了大部分工作:
- 代码生成:Claude 生成了全部 Kotlin 客户端代码。经审阅者许可,他在审阅者的计算机上通过 Android 模拟器自行编译并测试了代码;模拟器截图就是在这些测试中截取的;
- 生成 ODT 格式的课程:Claude 生成了文档,审阅者对其进行了校对,并按文档内容逐步操作进行了测试。
说明 1:如果读者的主要目标是“学习 NestJS”,可参阅文档 通过示例介绍 TypeScript 语言和 NestJS Web 框架,其中介绍了这个 Web 框架。在本文档中,NestJS 服务器被当作黑盒:只告诉您如何使用它,而不描述其代码。
说明 2:本文档使用的编程语言是 [Kotlin]。其基础知识(类、数据类、可空性、lambda、扩展函数、集合等)被视为已知:这些内容在 Kotlin 课程中讲解。Android 或 Jetpack Compose 特有的概念以及协程,将在文档中随文讲解。
说明 3:Claude 经常引用课程 [Flutter] 客户端,即 “客户端/服务器应用示例——Flutter / NestJS”(2026),本文档就是对它的移植,有时也会引用同一应用的 Angular、React 和 Vue.js Web 客户端。这些比较有助于熟悉其中某个框架的读者,但阅读本文档并不要求掌握其中任何一个。
说明 4:如果您觉得 Claude 的解释不够充分,可以向 Claude 提出请求,要求他对其课程中的某个具体问题作进一步说明。这通常很有帮助。
Serge Tahé,2026 年 10 月
==
本文档是 2014 年所写课程 “客户端/服务器应用示例——AngularJS 1.x / Spring 4,”的续篇。该原始文档使用 Spring 4 / Spring Data / Spring MVC 服务器和 AngularJS 1.x 客户端,构建了一个管理医疗预约的小型应用(“[RdvMedecins]”)。
十二年后,所用的两个框架都发生了重大演变,甚至在日常使用中已被取代:
- 在服务器端,[NestJS] 已成为构建结构化 Web 应用时使用最广泛的 Node.js/TypeScript 框架之一,其理念与 Spring 相近(模块、控制器、服务、依赖注入);
- 在客户端,越来越多的应用是在手机上访问的。因此本文档描述的是一个原生 Android 应用:使用 [Kotlin] 编写,这是 Google 自 2019 年起推荐用于 Android 的语言;界面使用 [Jetpack Compose] 描述,这是 Android 的声明式 UI 库(自 2021 年起稳定),取代了以 XML 描述的旧视图系统。
本文档的目标是重温最初的案例研究——相同的应用、相同的功能、相同的数据库——并使用当前的工具重新构建它,同时尽可能保持与 2014 年文档及其 2026 年 Flutter 版本相同的教学进度。
1.1. 分步重建
原始文档约 300 页,除应用的核心功能——基于角色的身份验证(Spring Security)——之外,还包含十二个循序渐进的示例,用于分步学习 AngularJS 1.x。与 Flutter 版本一样,本文档涵盖:
- 应用的总体架构(原则上不变);
- 数据库(不变,只是增加了 [users] 表);
- 完整 [NestJS] 服务器的安装,其预约查看和预订/取消功能使用 Postman 进行测试——此处不涉及其代码;
- 该服务器基于令牌的身份验证(JWT)和基于角色的访问控制(ADMIN/USER)——我们只学习如何使用它们,先通过 Postman,再通过客户端;
- 相应的 Android 客户端,具有相同的功能、登录界面、根据已登录用户角色定制的界面(Material Design 3),以及在法语和英语之间切换界面的能力([TranslationsService])。
与 Flutter 版本一样,原始文档中的两个功能在本文档中被省略:原客户端的“调试”模式,被有意舍去(见第 6 章),以及人为网络延迟的配置,已推迟到后续阶段。
1.2. 本文档面向的读者
本文档不要求读者具备 Android、Jetpack Compose 或 [NestJS] 的先验知识。每个新概念(Activity、@Composable 函数、状态、ViewModel、协程、HTTP 拦截器等)都会在出现时加以讲解。不过,具备一些基础知识仍然有益:
- 对 Kotlin 语言的基本了解(参见 Kotlin 课程);
- 对 HTTP 交互的基本了解(GET/POST 方法、JSON 格式);
- 有使用命令行的经验(cd、npm install...)。
不要求了解 Flutter:文中与 Flutter 客户端的大量对比是为学过该课程的读者准备的,但每个概念都会先单独讲解。
1.3. 应用架构
应用的总体架构自原始文档以来没有变化:
- 客户端向用户呈现单一界面,基于组件模型(视图 + 关联逻辑)构建,并依靠服务与服务器通信——在这里,客户端是运行在手机系统上的 Android 应用;
- 用户与应用的各个屏幕交互。用户的操作有时需要向 [NestJS] 服务器发送请求,服务器处理请求并返回 JSON 响应;该响应用于更新显示给用户的屏幕。
所研究的应用将具有如下架构:

- 在 [1] 中,Android 应用的用户向应用的 [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,用于运行 [NestJS] 服务器;
- [Android Studio],Google 的 Android 开发环境。它提供客户端所需的一切:代码编辑器(基于 IntelliJ IDEA)、Android SDK、JDK(JetBrains Runtime)、Android 模拟器,以及 [Gradle] 构建工具。与 Flutter 课程中 Android Studio 仅用于安装 Android SDK 不同,这里它是客户端的编辑器;
- Visual Studio Code(或任何其他编辑器),用于查看 NestJS 服务器的代码(如果您想查看的话);
- [MySQL] 8,用于数据库,通过 Laragon 安装;
- Postman(或任何其他 HTTP 客户端),用于测试服务器的 URL;
- 一部 Android 手机(可选):只用模拟器就足以完成整个文档的学习。
1.5. 应用功能
[RdvMedecins] 应用的“业务”功能与以前的版本相同:
- 一家医疗诊所有若干名医生,每名医生都有自己的就诊时段;
- 用户必须登录(用户名/密码)才能访问应用;
- 登录后,用户可以选择一名医生和一天,查看该医生当天的日程:每个时段显示为可用或已预订;
- 角色为 ADMIN 的用户还可以为其选择的患者预订可用时段,并取消现有预约;
- 角色为 USER 的用户可以查看日程,但不能预订或取消预约(只读访问)。


上面是 Android 模拟器中的应用:登录界面,接着是医生的日历,然后是预订时段之后的界面。
1.6. 哪些变了,哪些没变
原始文档(2014) | Flutter 版本(2026) | 本文档(2026) | |
MySQL 5 | MySQL 8,表相同 | 与 Flutter 版本相同 | |
Java,Spring 4 | TypeScript,NestJS | 同一个 NestJS 服务器 | |
JavaScript,AngularJS 1.x | Dart,Flutter(移动端、桌面端、Web) | Kotlin,Jetpack Compose(Android) | |
浏览器 | 由 Flutter 编译的原生代码 | Android 虚拟机(ART) | |
Bower | Flutter / Pub | Gradle | |
Spring Security,HTTP Basic | Passport/JWT | Passport/JWT(同一服务器) | |
angular-translate | TranslationsService(手写) | TranslationsService(手写,字典相同) |
1.7. 本文档的结构
- 第 1 章 - 搭建工作环境:安装 Android Studio 和 Android SDK,打开客户端项目,创建模拟器,并设置手机。
- 第 2 章 - 安装 [NestJS] 服务器:安装 Laragon 和 MySQL 数据库,配置、启动并测试服务器,然后首次运行客户端。
- 第 3 章 - Android 和 Jetpack Compose 简介:Activity、@Composable 函数、状态与重组、CompositionLocal、协程、生命周期和 ViewModel——每个概念都给出对应的 Flutter 等价物。
- 第 4 章 - [RdvMedecins] 应用的 Kotlin 客户端:客户端的架构、其每个文件,以及对完整应用的分步讲解。
- 第 5 章 - 运行应用:模拟器、手机、APK——以及需要了解的网络、未加密的 HTTP 流量、屏幕旋转和窄屏幕等知识;最后讲解若还要面向 iOS、桌面端和 Web,需要做些什么。
- 第 6 章 - 结论与后续步骤。