HTTP 概览

HTTP 概述

AdonisJS 主要是一个用于创建响应 HTTP 请求的应用程序的 Web 框架。在本指南中,我们将了解 AdonisJS 如何启动 HTTP 服务器、处理传入请求以及 HTTP 层可用的模块。

HTTP 层

AdonisJS 应用程序中的 HTTP 层由以下模块组成。值得一提的是,AdonisJS 的 HTTP 层是从头开始构建的,并没有使用任何底层微框架。

路由器

路由器模块负责定义应用程序的端点,这些端点被称为路由。一个路由应该定义一个处理请求的处理器,该处理器可以是一个闭包或是对控制器的引用。

控制器

控制器是 JavaScript 类,你可以将其绑定到路由以处理 HTTP 请求。控制器作为组织层,帮助你将应用程序的业务逻辑分布在不同的文件/类中。

HttpContext

AdonisJS 会为每个传入的 HTTP 请求创建一个 HttpContext 类的实例。HttpContext(又称 ctx)携带了给定请求的信息,如请求体、头信息、认证用户等。

中间件

AdonisJS 中的中间件管道是责任链设计模式的实现。你可以使用中间件来拦截 HTTP 请求,并在它们到达路由处理器之前对它们进行响应。

全局异常处理器

全局异常处理器在一个中心位置处理 HTTP 请求期间抛出的异常。你可以使用全局异常处理器将异常转换为 HTTP 响应或报告给外部日志服务。

服务器

服务器模块将路由器、中间件、全局异常处理器连接起来,并导出一个 handle 函数,你可以将其绑定到 Node.js HTTP 服务器以处理请求。

AdonisJS 如何启动 HTTP 服务器

一旦你在 Server 类上调用boot 方法,HTTP 服务器即被启动。在底层,该方法执行以下操作。

  • 创建中间件管道
  • 编译路由
  • 导入并实例化全局异常处理器

在典型的 AdonisJS 应用程序中,boot 方法由 bin/server.ts 文件中的 Ignitor 模块调用。

此外,必须在调用 boot 方法之前定义路由、中间件和全局异常处理器,AdonisJS 通过使用 start/routes.tsstart/kernel.ts 预加载文件 来实现这一点。

HTTP 请求生命周期

现在我们有了一个监听传入请求的 HTTP 服务器。让我们看看 AdonisJS 如何处理给定的 HTTP 请求。

创建 HttpContext

作为第一步,服务器模块创建 HttpContext 类的实例,并将其作为引用传递给中间件、路由处理程序和全局异常处理器。

如果已启用 AsyncLocalStorage,则相同的实例将作为本地存储状态共享。

执行服务器中间件堆栈

接下来,执行服务器中间件堆栈 中的中间件。这些中间件可以在请求到达路由处理程序之前拦截并响应请求。

此外,即使你没有为给定端点定义任何路由器,每个 HTTP 请求也会经过服务器中间件堆栈。这允许服务器中间件在不依赖路由系统的情况下为应用程序添加功能。

查找匹配的路由

如果服务器中间件没有结束请求,我们将为 req.url 属性查找匹配的路由。如果没有匹配的路由,请求将以 404 - 未找到 异常中止。否则,我们将继续处理请求。

执行路由中间件

一旦找到匹配的路由,我们将执行路由器全局中间件命名中间件堆栈。同样,中间件可以在请求到达路由处理程序之前拦截请求。

执行路由处理程序

作为最后一步,请求到达路由处理程序并返回响应给客户端。

假设在此过程中任何一步引发了异常。在这种情况下,请求将被交给全局异常处理器,它负责将异常转换为响应。

序列化响应

一旦使用 response.send 方法或通过从路由处理程序返回值定义了响应体,我们就开始响应序列化过程并设置适当的头信息。

了解更多关于响应体序列化 的信息。