10. 案例研究:RdvMedecins 应用的 Vue.js 客户端
10.1. 问题
[RdvMedecins] 应用让用户可以在诊所预约医生。[NestJS] 课程把它写成了一个 HTML 应用,其中由服务器生成页面。这里我们编写的是 [Vue.js] 客户端:相同的页面,在浏览器中根据服务器的 JSON 数据生成,该数据在“RdvMedecins 服务器:一个黑盒”一章中已有描述。
该客户端必须提供 HTML 应用所提供的一切:
- 一个由验证码保护的登录页面,并可选择创建患者账户;
- 某位医生某一天的日程,可进行预约(患者选择窗口)和取消;
- 对管理员而言,是医生和客户的管理(列表、添加、编辑、删除);
- 对患者而言,是个人面板(显示其可以取消的未来预约)和账户管理;
- 两种语言:法语和英语;
- 唯一的 URL([/schedule?doctorId=1&day=...]),可以重新加载、加书签,并可使用浏览器的后退/前进按钮进行导航。
10.2. 安装与运行
JSON 服务器必须已安装并正在运行(见上一章)。要在浏览器中使用该客户端,不需要验证码测试模式:在服务器的 [.env] 文件中,不需要设置它。
在打开到 [rdvmedecins-vuejs] 文件夹的控制台窗口中:
然后在浏览器中打开 http://localhost:5173。演示账户列在登录页面上(密码 = 登录名)。
示例中的 [Vite] 服务器同样使用 5173 端口。如果该端口已被占用,[Vite] 会改用另一个端口(5174……)并在控制台中显示:此时你必须打开那个地址。
10.3. 使用应用
10.3.1. 登录页面

密码错误:页面底部会出现一条消息,并显示一张新图片(每张图片只能使用一次):

10.3.2. 日程,以管理员和医生的视角
以 [admin] 身份登录时,你会进入日程页面:

选择一位医生和一个日期,然后点击“View schedule”。URL 变为 [/schedule?doctorId=1&day=2026-09-28]:

“Book”会打开预约窗口。URL 变为 [/schedule?doctorId=1&day=2026-09-28&book=3]:重新加载页面(F5)会重新打开同一个窗口。

预约已保存:

“Cancel”会要求确认:

医生会被直接带到他自己的当日日程:

10.3.3. 患者门户
一位患者([martin])进入“My area”:

在日程中,其他患者的时间段旁边显示“Booked”:

他无需选择患者,就能为自己预约:

他的预约出现在他的姓名下;“Book”按钮不再可用(只能有一个未来的预约),并且有一条消息解释了原因:

他的面板显示如下内容:

“Manage my account”:任何修改都需要提供当前密码;错误来自服务器端:

如果他输入专供管理员使用的地址 [/doctors]:

10.3.4. 管理医生和客户

填写不正确的条目:

成功的添加:

同名情况:

删除一位有预约日程的医生的请求被拒绝:

10.3.5. 创建账户
在登录页面上,输入验证码,然后点击“Create a patient account”。填写不正确的表单随后会被服务器拒绝:

账户创建完成后,返回登录页面;登录字段已预先填好:

10.3.6. 法语界面
FR / EN 按钮会当场翻译页面,无需向服务器发送任何请求:

10.3.7. 会话过期,未知地址
如果令牌过期(或 Cookie 被删除),下一个请求会收到 401 响应;客户端被重定向到登录页面:

一个未知的地址:

10.4. 客户端架构

下表比较了 [NestJS] 课程中的 HTML 应用与本客户端:
HTML 应用(NestJS) | Vue.js 客户端 |
服务器生成每个页面([res.render]) | 服务器返回 JSON;[src/views/] 中的组件生成页面 |
[views/layout.hbs] 及其局部视图 | [App.vue] 以及 [src/components/] 中的组件 |
控制器路由([@Controller('schedule')]) | 客户端路由([router.ts]);服务器只有 [/api/...] 路由 |
[JwtAuthGuard] 和 [RolesGuard] 重定向到 [/login] 或 403 页面 | 路由器的守卫;服务器保留自己的守卫,它们以 401 / 403 响应 |
存放在 Cookie 中的闪现消息 | 存放在 Pinia store 中的闪现消息 |
由服务器读取的词典,辅助函数 [{{t}}] | 客户端上的词典,[vue-i18n];服务器只返回键 |
语言存放在 Cookie 中 | 语言存放在 [localStorage] 中 |
表单被拒绝:服务器重新加载页面 | 表单被拒绝:400/409 响应;客户端显示错误 |
确认窗口:一个小脚本,[public/js/app.js] | 一个组件,[ConfirmDialog.vue] |
该应用无需 JavaScript 也能运行 | 该应用本身就是 JavaScript |
10.5. 项目配置
10.5.1. package.json
与示例中相同的库。多了一条命令:
- 第 10 行:[npm run preview] 提供应用的编译版本(文件夹 [dist/],由 [npm run build] 生成),以便在部署之前对其进行验证。
10.5.2. vite.config.ts
- 第 21–23 行:把发往 [/api] 的请求代理到 JSON 服务器;
- 第 26–31 行:[npm run preview] 使用的同一个代理。
一个重要的细节:应用使用“干净”的地址([/schedule]、[/my-area])。如果重新加载页面 [/schedule],浏览器会请求 [/schedule] 到 [Vite] 服务器。由于服务器找不到同名的文件,它会返回 [index.html] (这是它对单页应用的默认行为);应用随之启动,它的路由器显示日程页面。
10.5.3. tsconfig.json 和 env.d.ts
与示例中的相同,只是文件列表不同:
10.6. 启动应用
10.6.1. index.html
- 第 12 行:标签页图标。[public/] 文件夹中的文件会原样提供,位于站点根目录;
- 第 18 行:没有 [JavaScript],[Vue.js] 应用就什么也显示不了。而 [NestJS] 课程中的 HTML 应用,则无需 [JavaScript] 也能工作:这就是单页应用的取舍;
- 第 19 行:应用程序。
10.6.2. src/main.ts
- 第 24–26 行:三个扩展:store、语言和路由器。[Pinia] 必须在路由器之前安装:路由器的守卫要用到 store;
- 第 28–32 行:当任何请求收到 401 响应(会话过期、账户被删除等)时该怎么做:忘记该用户,为下一个页面准备好“您的会话已过期”消息,并重定向到登录页面。这一处理只在这里声明一次;函数 [whenUnauthenticated] 在 [http-client.ts] 中说明。
10.6.3. src/App.vue
所有页面共用的模板,相当于 [views/layout.hbs]:
- 第 30 行:导航栏;
- 第 31 行:顶部的成功消息;
- 第 32 行:当前页面。[:key] 属性:当组件的 key 变化时,[Vue.js] 会销毁它并创建一个新的。以路由名称作为 key 时,从 [/doctors] 切换到 [/clients] (两条不同的路由,由同一个组件显示)会重新创建页面,页面也会重新加载其数据。而当只有 [query] 变化时(变为 [/schedule?day=...]),页面会被保留,并且正是这个页面跟随它的 URL;
- 第 33 行:错误区域,位于底部;
- 第 35 行:确认窗口,在整个应用中只显示一次。
10.6.4. src/styles.css
HTML 应用的样式,外加一处新增:
- 第 28 行:错误区域会“粘”在窗口底部,可能会覆盖某个按钮(例如在较短页面中位于中央的确认窗口);它不包含任何可点击的内容,点击会直接穿过它。
10.7. API 访问层
10.7.1. src/api/types.ts
黑盒一章中描述的 API 的 JSON 对象,被翻译成 [TypeScript] 接口:
- 第 32 行:一个接口可以扩展另一个接口:[Person] 是一个 [Identity] ,另外还有 ID、版本,以及对 ADMIN 而言的登录名;
- 第 54 行:日程中的一个条目:一个时间段,加上已登录用户的权限;
- 第 39 行及其后:客户端发送给服务器的内容。
10.7.2. src/api/http-client.ts
示例 19 中的 [request] 函数([common/api.ts]),对 401 响应进行集中处理:
- 第 14–23 行:请求错误:HTTP 状态码、消息键、参数、每个字段的错误;
- 第 27 行:每次收到 401 响应时要调用的函数。它起初什么也不做;[main.ts] 通过 [whenUnauthenticated] 提供一个。为什么不在这里直接调用路由器?因为 API 访问层不应该了解任何有关页面的事:它只发出错误信号,由应用来决定;
- 第 35–39 行:有些请求本来就预期会出现 401,并自行处理:密码错误([POST /api/auth/login] 会返回 401),或者“谁已登录?”这个问题([GET /api/auth/me],无人登录时返回 401)。对于这些请求,不做自动重定向;
- 第 46 行:请求头 [Accept] 告诉服务器期望的响应格式;
- 第 50 行:完全没有响应;
- 第 73 行:不含键的响应并非来自我们的服务器:当 JSON 服务器宕机时,由代理来响应([Vite] 的代理返回不带正文的 500 错误;生产环境中的代理,如 [nginx] ,则返回 502 或 504);
- 第 77–79 行:一个意外的 401:我们通知应用,然后像处理其他错误一样拒绝该 Promise。
10.7.3. src/api/rdvmedecins.api.ts
每个 API 路由对应一个函数:
- 第 23 行:医生和客户的处理方式相同;只有地址不同:[/api/doctors] 或 [/api/clients];
- 第 25 行:空对象的类型,[{}];
- 第 29–33 行:登录相关的路由,它们自行处理自己的 401([ignore401]);
- 第 43–49 行:如果没有可选的医生,则省略参数 [doctorId] ;如果有一位医生,服务器会返回他自己的日程;
- 第 50–51 行:[clientId ?? undefined]:[null] 变成 [undefined],而 [JSON.stringify] 会省略值为 [undefined] 的属性:患者不发送 [clientId];
- 第 55–60 行:针对个体的五种操作,由它们的类型定义;
- 第 66 行:DELETE 请求也可以带有正文。
10.8. 语言
10.8.1. src/i18n.ts
- 第 21–31 行:已存储的语言,否则使用浏览器的语言。对 [localStorage] 的访问用 [try / catch] 保护:某些浏览器在无痕模式下会阻止它;
- 第 39–40 行:当某个键缺失或来自回退词典时,控制台中不显示警告;
- 第 44–52 行:切换语言:[i18n.global.locale] 是整个应用的语言;页面的 [lang] 属性也会同时更新,并且所选语言会被保存。
10.8.2. 词典
这些是课程 [NestJS] 中的键,并补充了一些客户端特有的键([APP.LOADING]、[ERRORS.AUTH_REQUIRED]、[ERRORS.JSON_REQUIRED]、[ERRORS.SERVER_UNREACHABLE])。错误码就是服务器返回的那些。
10.8.2.1. src/locales/fr.json
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 | |
10.8.2.2. src/locales/en.json
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 | |
10.9. store
10.9.1. src/stores/session.ts
- 第 21 行:已登录的用户,与服务器描述的一致。令牌本身不在这里——它在只有浏览器才会处理的 Cookie 中;
- 第 25–30 行:由此推断出的内容,供页面和导航栏使用;
- 第 33 行:每种角色的主页:患者是“My area”,其他人是日程;
- 第 37–47 行:“谁已登录?”这个问题,只在第一次向服务器询问。Promise 被保存在 [checking] 中:后续调用会复用它(运算符 [??=] 只在变量为 [null] 或 [undefined] 时才赋值)。它不会失败:出现错误(401、服务器不可达)就表示“没有人登录”;
- 第 49–51 行:登录。如果失败,[rdvApi.logIn] 会用一个 [ApiError] 拒绝它的 Promise,该错误穿过这个函数,传到登录页面;
- 第 54 行:修改账户之后,患者的姓名可能已经变了;
- 第 58–64 行:[finally]:即使服务器没有响应,也会忘记该用户;
- 第 67 行:无需向服务器发送任何请求(会话过期、账户被删除)。
10.9.2. src/stores/messages.ts
- 第 21–24 行:一条消息由一个翻译键及其参数组成。因此,当用户切换语言时,它会自动重新翻译;
- 第 27–28 行:当前页面的成功消息(显示在顶部)和错误消息(显示在底部);
- 第 44–49 行:[ApiError] 会成为页面的消息。任何其他错误都是客户端异常(编程错误):允许记录日志,并会显示在浏览器控制台中;
- 第 57–60 行:给下一个页面的消息。导致页面切换的操作(预约、添加医生、创建账户后登录)会在跳转到下一个页面之前设置这条消息;
- 第 63–67 行:在每次页面导航之后调用(见 [router.ts]):上一个页面的消息消失,待显示的消息出现。在 HTML 应用中,这是短生命周期 Cookie [rdvmedecins_flash] 的作用。
10.10. 组合式函数
10.10.1. src/composables/useConfirmation.ts
示例 12 中的组合式函数,有三处不同:
- 第 19 行:消息是一个翻译键:窗口会把它翻译成当前语言;
- 第 20 行:一个尚未回答的问题(不太可能出现的情形)会得到“否”的回答;
- 第 22 行:新的提问会使上一个操作的消息过时。
10.10.2. src/composables/useFormatting.ts
服务器发送的是原始数据([startHour: 8, startMinute: 0]、[day: "2026-10-05"]);对这些数据进行格式化取决于语言,这是客户端的责任:
- 第 13–39 行:普通的、非响应式的函数,逐个导出;
- 第 42–54 行:一个组合式函数,因为 [longDate] 需要当前语言,它通过 [useI18n()] 获得。当语言变化时,显示 [longDate(...)] 的模板会被重新计算;
- 第 49 行:[new Date("2026-10-05T00:00:00Z")] 是 UTC 的午夜;以巴黎时区显示,它仍然是 10 月 5 日,但在纽约,它却是 10 月 4 日!因此我们要求以 UTC 时区显示。
10.10.3. src/composables/useForm.ts
应用中的所有表单都遵循示例 20 所展示的做法:不在浏览器中验证任何规则;服务器验证一切,所有错误都显示在字段下方。这个组合式函数把共同的状态和操作归并在一起:
- 第 19–21 行:每个字段的错误、消息参数,以及提交指示器(提交期间按钮被禁用,以防止重复点击);
- 第 30–46 行:执行提交(由页面提供的函数);如果出现 [ApiError],则清除字段错误,在页面底部显示通用消息,并返回 [false]。
10.11. 路由器
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 | |
- 第 36–43 行:我们路由的元数据:标签页标题(一个翻译键)、是否公开访问、授权的角色,以及用户类型;
- 第 46–64 行:医生管理的三条路由(列表、添加、编辑),以及客户的同样三条,由一个函数生成。页面按需加载([() => import(...)]):患者永远不会下载医生管理的代码;
- 第 57 行:[(\d+)]:一个 正则表达式 把参数 [id] 限制为数字。[/doctors/abc/edit] 不匹配这条路由:会显示“页面未找到”页面;
- 第 60 行:组件的 [id] 属性,已转换为数字;
- 第 67 行:“干净”的地址,不带 [#];
- 第 70 行:地址 [/] 会导向 [/login],而在已登录时,它又会进一步导向该角色的主页;
- 第 82–89 行:一个专属于某条路由的守卫,在进入该路由之前执行:没有通行证(在登录页面上解答的验证码)时,创建账户会重定向到登录页面并附带一条消息;
- 第 107 行:[props] 也可以是一个静态对象:403 和 404 错误使用同一个错误页面;
- 第 123–143 行:全局守卫,在每次导航之前执行:
- [await session.check()]:第一次(启动时、F5 之后)会向服务器询问谁已登录。该守卫是 [async]:导航会等待响应;
- 公开页面始终可以访问;不过,对已登录的用户而言,登录页面会重定向到他的主页;
- 未登录:转到登录页面,同时保留所请求的页面;
- 角色无效:403 页面;
- 第 148–156 行:每次导航之后:闪现消息,并翻译标签页标题。[i18n.global.t]:在组件之外,直接使用 [i18n] 对象。
10.12. 组件
10.12.1. src/components/NavBar.vue
- 第 21–24 行:注销,随后进入登录页面。[.catch(() => {})]:即使服务器没有响应,客户端也会断开登录;
- 第 31 行:菜单只有在登录之后才会出现,并取决于角色:患者是“My area”,ADMIN 是“Doctors”和“Patients”。这只是为了显示方便;真正的安全由服务器保证;
- 第 34 行:当前显示页面对应的菜单会被赋予类 [active];
- 第 53–63 行:FR / EN 按钮。[:aria-pressed] 向屏幕阅读器指示哪个按钮被按下;
- 第 66 行:角色、姓名和注销功能。
10.12.2. src/components/SuccessMessage.vue 和 ErrorPanel.vue
两个非常短的组件,显示来自 [messages] store 的消息,并翻译成当前语言:
- 第 16 行:错误消息一出现,屏幕阅读器就会朗读它,即使它位于页面底部;成功消息是 [role="status"],朗读时不会打断用户。
10.12.3. src/components/ConfirmDialog.vue
示例 12 中的窗口,借助 HTML 应用中的 [public/js/app.js] 脚本,增强了键盘导航:
- 第 29–38 行:打开时,保留原先拥有焦点的元素(例如被点击的“Delete”按钮),然后把焦点交给“No, go back”按钮;关闭时,焦点返回到被保留的元素。这样,用键盘导航的用户就能回到他在页面上的原位置;
- 第 40–55 行:Esc 被视为“否”;Tab 和 Shift+Tab 保持在窗口之内:到达最后一个按钮时,Tab 会回到第一个按钮(否则焦点会移到后面变灰的页面上);
- 第 60 行:键盘输入由窗口自身处理:无需在 document 上附加或移除监听器;
- 第 68 行:为屏幕阅读器提供的窗口标题和消息;
- 第 79 行:消息,已翻译。
10.12.4. src/components/InputField.vue
一个完整的表单字段,由应用中的所有表单复用:
- 第 18 行:该字段与 [v-model] 一起使用(见示例 08);
- 第 20–33 行:props:字段 ID,以及标签、提示信息和错误消息的翻译键;
- 第 46 行:出现错误时,字段用红色突出显示;
- 第 51 行:帮助或错误消息与字段关联起来,供屏幕阅读器使用;
- 第 53–54 行:错误消息会取代帮助文本。
当该组件被放在父组件中时,它还会继承父组件传下来的属性,即使它们不是 props:[<InputField class="col-sm-6" ...>] 会把类 [col-sm-6] 添加到它的根元素 [<div>] 上(这称为“继承”属性,[fallthrough attributes])。
10.12.5. src/components/PersonFields.vue
称谓、名和姓是三个表单共有的:
- 第 16–18 行:三个 [v-model] 字段 具名:父组件这样写 [v-model:title="..."], [v-model:firstName="..."], [v-model:lastName="..."];
- 第 34 行:两个文本字段都是 [InputField]。[firstName] 是 [defineModel] 的 [ref]:父子链 -> PersonFields -> InputField -> [<input>] 是双向工作的。
一个组件可以有多个根元素(这里是用于称谓的 [<div>] 和包含两个字段的那一行):这称为“片段”。
10.12.6. src/components/CaptchaField.vue
- 第 30–37 行:一个新的验证码;之前的输入被清除;
- 第 39 行:父组件可以通过模板引用对这个组件调用的内容(见 [LoginView.vue])。没有 [defineExpose],[<script setup>] 组件什么也不会暴露;
- 第 47 行:SVG 图像,原样插入:它来自我们的服务器(见示例 17)。
10.12.7. src/components/BookingDialog.vue
预约窗口。它不与服务器通信:它要么发出带有所选患者的 [confirm] 事件,要么发出 [close]。由日程页面决定如何处理。
- 第 22–27 行:预约时间,以及患者列表(ADMIN、DOCTOR)或已登录患者的姓名(USER);
- 第 42–46 行:打开时,焦点交给第一个适用的元素(患者列表或“Confirm”按钮);Esc 键关闭窗口;
- 第 56 行:一个真正的表单:Enter 键确认;
- 第 66 行:患者为自己预约:没有列表。
10.13. 页面
10.13.1. src/views/LoginView.vue
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 | |
- 第 32 行:[/login?login=jbernard] 预先填入登录字段(在创建账户之后立即使用);
- 第 38 行:对 [CaptchaField] 组件的引用:我们可以调用它暴露的内容([reload()]、[captchaId()])。[InstanceType<typeof CaptchaField>] 是它的类型;
- 第 43 行:如果用户名已经填写,焦点就放在密码字段上;
- 第 47–62 行:两个按钮遵循相同的流程:提交;如果不成功,会出现一条错误消息,如适用,还会在验证码字段下方给出一个错误,并显示一张新图片;
- 第 64–71 行:登录,随后进入登录之前所请求的页面(参数 [redirect],由路由器设置),或该角色的主页。只接受内部路径:它必须以 [/] 开头,但不能以 [//] 开头([//site.com/...] 指向另一个站点);
- 第 73–78 行:“Create a patient account”:服务器验证验证码并签发令牌;随后打开创建账户页面;
- 第 105 行:[type="button"]:这个按钮不提交表单。在 HTML 应用中,这是第二个按钮,用于把同一个表单提交到另一个地址([formaction])。
10.13.2. src/views/ScheduleView.vue
主页面。与 HTML 应用一样,它的全部状态都在 URL 中:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 | |
页面数据:
- 第 44–48 行:各个列表、显示的日程,以及加载和发送指示器;
- 第 51 行:“医生 + 日期”表单的值。它们是从 URL 复制来的;用户可以修改它们,但在点击“View schedule”之前不会产生任何效果;
- 第 60 行:显示日程(不带预约窗口)时使用的 [query] ;
- 第 64–67 行:窗口为其打开的时间段:[?book=...],如果它存在并且该用户可以预约它。因此,手工构造的 URL(对已被预约的时间段使用 [book=])不会打开任何预约窗口。
加载:
- 第 72–82 行:医生列表对所有人可见,而患者列表只对有权查看的人可见;
- 第 85 行:页面跟随 URL。[immediate]:页面一显示,日程就会加载(加书签的 URL、F5);之后,每当 URL 中的医生或日期发生变化时(通过点击“View schedule”或“上一个/下一个”按钮)也会加载。仅 [book] 变化不会重新加载日程:它只是打开或关闭窗口(见 [slotToBook]);
- 第 87–116 行:来自 URL 的日期(默认是今天;如果该日期不存在则出错);来自 URL 的医生;如果没有指定医生,已登录的医生会看到他自己的日程(服务器通过令牌获取它),然后服务器返回的医生会被复制到表单中。
操作:
- 第 123–125 行:“View schedule”本身不加载任何内容:它改变 URL,日程随之更新;
- 第 131–157 行:预约:
- 如果没有选择患者:服务器使用令牌中的那一位;
- 没有选择患者(ADMIN、DOCTOR):窗口保持打开,并显示该消息;
- 成功或其他拒绝情形(时间段在此期间被占用、患者已有预约):一条 弹出消息,然后是不带 [book] 的 URL (窗口关闭),接着重新加载日程:以服务器的版本为准;
- 第 159–170 行:确认之后取消。服务器会为用户可以取消的时间段返回 [appointmentId] :对于 ADMIN 或 DOCTOR,是所有时间段;对于患者,是他自己的时间段(HTML 应用只允许他们从“My area”取消;API 也允许从日程中取消)。
模板:
- 第 175 行:选择医生和日期;
- 第 195 行:已有未来预约的患者:为什么没有“Book”按钮;
- 第 202 行:日期,以当前语言格式化;
- 第 216 和 217 行:患者的姓名(如果已提交);否则显示“Booked”;
- 第 222 行:“Book”是一个链接:它会在 URL 中添加 [book=...] 。因此浏览器的后退按钮会关闭窗口;
- 第 237–244 行:窗口,在 URL 请求时显示。
10.13.3. src/views/persons.config.ts
管理医生和客户的页面是共用的。区分它们的是:
- 第 25 行:每种类型各自标签的键,就像 HTML 应用的 [DoctorsController] 和 [ClientsController] 控制器中一样;
- 第 49–51 行:用于“已添加/已修改/已删除”消息的参数 [{name}] 和 [{login}] 。
10.13.4. src/views/PersonsView.vue
- 第 26 行:人员的类型,从路由的元数据中读取。它在组件的生命周期内不会改变:当从 [/doctors] 切换到 [/clients] 时,[<RouterView>] 的 [:key] 会重新创建页面;
- 第 28 行:在列表尚未加载时为 [null] :这样可以区分“正在加载”和“空列表”;
- 第 39–51 行:确认、删除、消息和重新加载列表。如果某位医生仍有预约:服务器返回 409 响应,消息显示在页面底部。
10.13.5. src/views/PersonFormView.vue
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 | |
- 第 30 行:创建时没有 [id],修改时有它(该属性来自路由;见 [router.ts]);
- 第 36 行:表单错误(见 [useForm.ts]);
- 第 45–61 行:修改时,读取记录,包括 版本。如果它不存在(在此期间已被删除),则返回列表并附带一条消息;
- 第 63–75 行:POST 或 PUT;成功时,显示一条消息并返回列表。如果操作失败,[useForm] 已经显示了错误;如果记录在此期间已被删除,程序会返回列表;
- 第 84 行:[novalidate]:由服务器来验证;
- 第 85 行:三个具名的 [v-model] 绑定;
- 第 91 行:密码从不预先填入:服务器从不返回它。
10.13.6. src/views/RegisterView.vue
- 第 31 行:密码的最小长度,用于帮助消息(服务器也会在 [params] 中连同错误一起返回它);
- 第 35–49 行:创建账户,随后进入预先填好用户名的登录页面。如果令牌已过期(15 分钟),服务器会以 403 错误响应:返回登录页面重新解答一个新的验证码;
- 第 67 行:该字段的消息参数;[...params] (展开运算符)复制服务器返回的那些参数。
对该页面的访问由其路由上的 [beforeEnter] 守卫控制(见 [router.ts])。
10.13.7. src/views/PatientAreaView.vue
- 第 36–47 行:患者取消他自己的预约(服务器会拒绝取消别人的预约);
- 第 57 行:整张卡片就是一个链接;
- 第 75 行:通常只有一个预约(“一次只能有一个未来预约”规则),但页面可以显示多个;
- 第 85 行:该预约当天的医生日程,患者可以在其中看到自己的姓名。
10.13.8. src/views/MyAccountView.vue
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 | |
- 第 30–31 行:两个表单,因此有两组错误:组合式函数可以被调用任意多次,每次调用都有自己的状态;
- 第 47 行:读取到的值被复制到表单中,包括版本;
- 第 53–65 行:服务器已签发新的令牌(姓名和登录名可能已经变了);它返回该令牌所描述的用户,会话随之更新:导航栏也跟着更新。每次提交之后,当前密码都会被清除;
- 第 67–80 行:确认,删除;服务器已经删除了令牌 Cookie:该用户被遗忘,并被重定向回登录页面;
- 第 90 行:[update] 是一个包含 [ref] 的普通对象:在模板中,必须写 [.value] (见示例 11)。
10.13.9. src/views/ErrorView.vue
未知 URL(404)或受限于用户角色的页面(403)所对应的错误页面。