Skip to content

1. 简介

本文档的 PDF 在 |此处|。

本文档的代码在 |此处|。

本文档是 Anthropic 的 AI Claude 的成果。其目的是从两个方面改编文档 [A Client/Server Example - AngularJS 1.x / Spring 4] :

  • 将 AngularJS 1.x 客户端替换为 [Vue.js] 3 客户端;
  • 将 Java Spring MVC Web 框架替换为 NestJS Web 框架;

Anthropic 的 Claude(AI)完成了大部分工作(90%):

  • 代码生成:所有代码均由 Claude 生成。我只是按照生成的课程对其进行了测试;
  • 以 ODT 格式生成课程:应我的要求,Claude 生成了多个版本。这是我主要参与的部分。

注 1:如果读者的主要目标是“学习 NestJS”,可以参阅文档 [Introduction to the TypeScript Language and the NestJS Web Framework by Example],其中有一个更简单的示例。之后读者可以回到本文档,了解 Vue.js 客户端框架。

注 2:本文档经常提到本课程的 [React] 版本,即课程 [A Client/Server Example - React / NestJS (2026)]。 此外,还提到了本课程的 [Angular] 版本:[A Client/Server Example - Angular / NestJS (2026)]

Serge Tahé,2026 年 9 月

==

本文档是 2014 年撰写的课程 “A Client/Server Example - AngularJS 1.x / Spring 4” 的后续。那份原始文档使用 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] 变体即采用这种方式。本文档则采用不同的方式:[Vue.js] (由 Evan You 于 2014 年创建,源于他在 Google 使用 AngularJS 的一次实验),这是一个“渐进式”框架:核心专注于视图层,并辅以自己的组件格式——.vue 文件(参见第 4 章)。

本文档的目标是重新审视最初的案例研究——相同的应用程序、相同的功能、相同的数据库——并重建它,使用当前的工具,同时尽可能保持与 2014 年文档相同的教学进程。

1.1. 分步重建

原始文档约 300 页,除了应用程序的核心功能——基于角色的身份验证(Spring Security)之外,还包含十二个循序渐进的示例,用于分步学习 AngularJS 1.x。一次性重建所有这些内容既耗时又难以消化。

因此,本文档涵盖重建的前两个步骤:

  • 应用程序的总体架构(原理上保持不变);
  • 数据库(保持不变,只是增加了 [users] 表);
  • 完整的 [NestJS] 服务器,具备查看和预约/取消预约的全部功能;
  • 基于令牌的身份验证(JWT)和基于角色的访问控制 (ADMIN/USER),相当于原始文档中的 Spring Security 层;
  • 相应的 [Vue.js] 客户端,具有相同的功能、一个登录界面、一个根据已登录用户角色定制的 Bootstrap 界面,以及在法语和英语之间切换界面的能力([vue-i18n])。

原始文档中的两个功能目前不包含在本文档中:原始客户端的“调试”模式(显示当前视图的原始模板),本次移植中已有意省略(该决定的理由见第 6 章);以及人为网络延迟的配置,已推迟到后续阶段。

1.2. 本文档的读者对象

本文档不要求读者事先了解 [NestJS] 或 [Vue.js]。每个新概念(装饰器、依赖注入、组件、信号等)在出现时都会尽可能详细地加以解释,即使读者从未写过一行 TypeScript 代码。

不过,具备一些基础知识有助于更好地理解本文档:

  • 对 JavaScript 语言有基本了解(变量、函数、数组、对象);
  • 对 Web 应用程序中的 HTTP 数据交换有基本了解(GET/POST 方法、JSON 格式);
  • HTML 语言的常用标签;
  • 使用命令行(cd、npm install……)。

你无需事先熟悉 TypeScript 语言(服务器端和客户端都使用它):它是 JavaScript 的超集,增加了类型系统,文档中每次用到时都会加以说明。感兴趣的读者可以参阅文档 [Introduction to the TypeScript Language and the NestJS Framework (2026)],其中详细讲解了 TypeScript。

1.3. 应用程序架构

应用程序的总体架构自原始文档以来没有变化:

  • 一台 Web 服务器提供单个 HTML/CSS/JS,其中包含一个基于[Vue.js] 应用程序,它构建在组件模型(视图 + 关联逻辑)之上,并依靠服务 与服务器通信;
  • 用户与浏览器中显示的视图交互。用户的操作有时需要向 [NestJS] 服务器发出请求,服务器处理请求并返回 JSON (JavaScript Object Notation)响应;该响应用于更新呈现给用户的视图。

所考虑的应用程序将具有如下架构:

Image

  • 在 [1] 中,[Vue.js] 应用程序的用户查询该应用程序的 [presentation] 和 [2] 层;
  • 为了执行用户请求的操作,[presentation] 和 [2] 层可能会查询 [Services] 和 [3] 层;
  • 为了提供所请求的服务,[3] 层可能需要通过 [4] 查询远程 JSON 服务器——由 [NestJS] 实现;
  • 根据在 [5] 中收到的请求,可能会查询 [6-8] 层;
  • 服务器的响应以相反的顺序返回 [2-8] 层;
  • 向用户显示的视图 [1] 反映了该响应;

注意:如果你对项目架构感到困惑,请回头参看这张图。请注意,DBMS 由服务器处理,而不是由客户端处理。

1.4. 所用工具

本文档使用以下工具(其安装详见第 2 章):

  • Node.js (22 或更高版本)及其包管理器 npm——在 JavaScript 生态系统中,相当于原始 Spring 服务器所用的 Java + Maven;
  • Visual Studio Code,一款免费的代码编辑器,配有其 TypeScript 扩展——相当于原始文档中使用的 Spring Tool Suite (STS) 和 WebStorm;
  • [NestJS] CLI ([@nestjs/cli]),一个命令行工具,用于生成服务器项目结构并启动其开发服务器;在客户端,[Vite] 无需全局安装——可以直接通过 npm 在本文档附带的项目上使用;
  • [MySQL] 8 用于数据库(原始文档使用的是 [MySQL] 5——关系模式本身保持不变);
  • Postman (或任何其他 HTTP 客户端),用于测试服务器中响应 POST 请求的 URL(/addAppointment、/deleteAppointment)——浏览器只能测试 GET 请求。

1.5. 应用程序功能

[RdvMedecins] 应用程序的“业务”功能与原始文档相比保持不变;不过,访问控制比原来稍微更健壮(见下表):

  • 一家医疗诊所聘有多位医生,每位医生都有各自的诊疗时间段;
  • 用户必须登录(用户名/密码)才能访问应用程序;
  • 登录后,用户可以选择医生和日期,并查看该医生当天的日程:每个时间段显示为可预约或已被预约;
  • 角色为 ADMIN 的用户还可以为其选择的患者预约一个可用的时间段,并取消已有的预约;
  • 角色为 USER 的用户可以查看日程,但不能预约或取消(只读访问)——这是与原始文档刻意不同之处:在原始文档中,USER 角色仅用于演示拒绝访问,什么也看不到(此选择的理由见第 3 章“身份验证”一节)。

Image

1.6. 变化与不变


原始文档(2014)
本文档(2026)
Database
[MySQL] 5,表 MEDECINS/CLIENTS/CRENEAUX/RV
[MySQL] 8,相同的表、相同的列、相同的约束(使用英文名称)
Server
Java、Spring 4、Spring Data(JPA/Hibernate)、Spring MVC
TypeScript,[NestJS],[TypeORM],相同的 URL(使用英文名称)
Client
JavaScript、AngularJS、1.x、bower
TypeScript,[Vue.js] 3 (组合式 API,setup 脚本),npm
CSS style
Bootstrap 3
Bootstrap 5
Authentication
Spring Security、HTTP Basic、角色存放在 3 张表中;只有 ADMIN 使用应用程序
Passport/JWT([@nestjs/passport]、[@nestjs/jwt]),每个请求都携带一个已签名的令牌,角色存放在单个列中,ADMIN 拥有完全访问权限,USER 为只读
FR/EN internationalization
angular-translate 库
[vue-i18n]

1.7. 本文档的结构

  1. 搭建开发环境——安装工具、创建数据库,并首次启动服务器和客户端。
  1. [NestJS] 简介——框架的基础知识(模块、控制器、提供者),并通过一个迷你项目入门。
  2. [RdvMedecins] 应用程序的 [NestJS] 服务器——数据库、[TypeORM] 实体、DAO 层、业务层、Web 层,以及基于 JWT 令牌的身份验证和角色。
  3. [Vue.js] 简介——框架的基础知识(单文件组件、ref/reactive、组合式函数、provide/inject),并回顾已在 [Angular] 中讲过的概念。
  4. [RdvMedecins] 应用程序的 [Vue.js] 客户端——客户端架构、其每个组件(包括登录界面)、Bootstrap 界面、界面在法语和英语之间的切换,以及对完整应用程序的分步演练。
  5. 结论与后续步骤。