8、构建 REST API 架构的全面指南

构建 REST API 架构的全面指南

1. REST API 基础组件

在构建 REST API 时，有几个关键组件起着重要作用：
- 模型（The Model） ：也被称为资源，主要处理与资源相关的大部分逻辑。
- 表示层（The representation layer） ：负责创建客户端应用可见的表示形式。
- 响应处理程序（The response handler） ：将响应的表示形式发送回客户端。

这里主要关注基于 HTTP 的 REST，所以除非另有说明，本章提到的任何请求都是 HTTP 请求。

2. 请求处理相关组件

请求处理程序、预处理链和路由处理程序是系统中任何请求的前三个组件，对于构建响应迅速且快速的 API 至关重要。由于使用的是 Node.js，它凭借事件循环和异步 I/O 机制，在处理大量并发请求方面表现出色。

请求处理程序需要具备以下属性，才能使 RESTful 系统按预期工作：
1. 收集所有 HTTP 标头和请求体，进行解析，并提供包含这些信息的请求对象。
2. 能够与预处理链模块和路由处理程序进行通信，以确定需要执行哪个控制器。
3. 创建一个能够完成并（可选）将响应写回客户端的响应对象。

客户端与服务器初始交互的步骤如下：

graph LR
    A[客户端应用发出请求] --> B[请求处理程序收集信息，创建请求对象