logologo
文档仓库
文档仓库
logologo
开始

概述

第一步
控制器
提供者
模块
中间件
异常过滤器
管道
守卫
拦截器
自定义装饰器

基础

自定义提供程序
异步提供者
动态模块
注入作用域
循环依赖
模块引用
懒加载模块
执行上下文
生命周期事件
发现服务
平台无关
单元测试

技术

配置
SQL
Mongo
验证
缓存
序列化
版本控制
任务调度
队列
日志
Cookies
事件
压缩
文件上传
文件流
HTTP 模块
Session
MVC
性能(Fastify)
SSE

安全

认证
授权
加密与哈希
Helmet
CORS
CSRF
速率限制

GraphQL

快速开始
解析器
变更
订阅
标量
指令
接口
联合与枚举
字段中间件
类型映射
插件
复杂度
扩展
CLI 插件
生成SDL
共享模型
其他功能
联邦

WebSocket

网关
异常过滤器
管道
守卫
拦截器
适配器

微服务

基础
Redis
MQTT
NATS
RabbitMQ
Kafka
gRPC
自定义传输
异常过滤器
管道
守卫
拦截器
部署
独立应用程序

CLI

概述
工作区
库
用法
脚本

OpenAPI

介绍
装饰器
类型映射
操作
其他特性
安全
类型与参数
CLI 插件

实用示例

REPL
CRUD生成器
SWC
Passport(认证)
热重载
MikroORM
TypeORM
Mongoose
Sequelize
路由模块
Swagger
健康检查
CQRS
Compodoc
Prisma
Sentry
静态资源
Commander
异步本地存储
Necord
套件(原Automock)

常见问题

Serverless
HTTP 适配器
长连接
全局前缀
原始请求体
混合应用
HTTPS & 多服务器
请求生命周期
错误

开发工具

概述
CI/CD
迁移指南
API参考(官方)

生态与案例

谁在用
精彩资源

支持

支持

社区

贡献者

最后更新于: 2025/11/18 02:11:37

上一页Serverless
下一页长连接

#HTTP 适配器

有时您可能需要访问底层 HTTP 服务器,无论是在 Nest 应用程序上下文中还是从外部访问。

每个原生(平台特定)的 HTTP 服务器/库实例(如 Express 和 Fastify)都被封装在一个适配器中。该适配器被注册为全局可用的提供者,既可以从应用程序上下文中获取,也可以注入到其他提供者中。

#应用程序上下文外部策略

要从应用上下文外部获取 HttpAdapter 的引用,请调用 getHttpAdapter() 方法。

const app = await NestFactory.create(AppModule);
const httpAdapter = app.getHttpAdapter();

#作为可注入项

要从应用上下文内部获取 HttpAdapterHost 的引用,可使用与其他现有提供者相同的注入技术(例如通过构造函数注入)。

export class CatsService {
  constructor(private adapterHost: HttpAdapterHost) {}
}
提示

HttpAdapterHost 是从 @nestjs/core 包导入的。

HttpAdapterHost 并非真正的 HttpAdapter。要获取实际的 HttpAdapter 实例,只需访问 httpAdapter 属性。

const adapterHost = app.get(HttpAdapterHost);
const httpAdapter = adapterHost.httpAdapter;

httpAdapter 是底层框架使用的 HTTP 适配器实际实例,它可能是 ExpressAdapter 或 FastifyAdapter 的实例(这两个类都继承自 AbstractHttpAdapter)。

适配器对象提供了多个与 HTTP 服务器交互的有用方法。但若需直接访问库实例(如 Express 实例),可调用 getInstance() 方法。

const instance = httpAdapter.getInstance();

#监听事件

要在服务器开始监听传入请求时执行操作,您可以订阅 listen$ 流,如下所示:

this.httpAdapterHost.listen$.subscribe(() =>
  console.log('HTTP server is listening'),
);

此外,HttpAdapterHost 提供了一个布尔属性 listening,用于指示服务器当前是否处于活动监听状态:

if (this.httpAdapterHost.listening) {
  console.log('HTTP server is listening');
}