nestelia 提供生命周期钩子，让你在应用程序启动和关闭过程中的特定时间点运行逻辑。

模块生命周期钩子

在 @Injectable() 服务或控制器上实现这些接口：

OnModuleInit

在所有模块的提供者实例化完成后调用。这保证了此时可以通过 ModuleRef 安全获取任何提供者：

import { Injectable, OnModuleInit } from "nestelia";

@Injectable()
class DatabaseService implements OnModuleInit {
  async onModuleInit() {
    await this.connect();
    console.log("Database connected");
  }
}

可以在 onModuleInit 中使用 ModuleRef 动态获取其他提供者：

import { Injectable, ModuleRef, OnModuleInit } from "nestelia";

@Injectable()
class CacheService implements OnModuleInit {
  constructor(private moduleRef: ModuleRef) {}

  onModuleInit() {
    const db = this.moduleRef.get(DatabaseService);
    console.log(`Cache connected to ${db.getUrl()}`);
  }
}

OnApplicationBootstrap

在每个模块都初始化完成后（所有 onModuleInit 钩子都已运行）调用一次。它在 createElysiaApplication() 期间触发——你不需要调用 listen() 它就会运行，因此同样适用于无服务器（serverless）和 getHttpServer().handle() 等场景：

@Injectable()
class AppService implements OnApplicationBootstrap {
  async onApplicationBootstrap() {
    console.log("Application is ready");
  }
}

OnModuleDestroy

模块被销毁时调用（在关闭期间）：

@Injectable()
class CacheService implements OnModuleDestroy {
  async onModuleDestroy() {
    await this.cache.flush();
  }
}

BeforeApplicationShutdown

应用程序开始关闭前调用。接收触发关闭的信号：

@Injectable()
class GracefulService implements BeforeApplicationShutdown {
  async beforeApplicationShutdown(signal?: string) {
    console.log(`Shutting down due to: ${signal}`);
    await this.drainRequests();
  }
}

OnApplicationShutdown

所有模块被销毁后调用：

@Injectable()
class CleanupService implements OnApplicationShutdown {
  async onApplicationShutdown(signal?: string) {
    await this.releaseResources();
  }
}

执行顺序

启动期间（在 createElysiaApplication() 内部）：

1. OnModuleInit — 在所有提供者实例化完成后
2. OnApplicationBootstrap — 在所有模块初始化完成后调用一次

关闭期间（在 app.close() 内部）：

1. OnModuleDestroy
2. BeforeApplicationShutdown
3. OnApplicationShutdown

保证

• 每个钩子都会为每个提供者触发。 提供者会独立地接收它所实现的每一个钩子——你不需要为了让其他钩子运行而额外实现 onModuleInit。
• Bootstrap 在初始化时运行。 OnApplicationBootstrap 在 createElysiaApplication() 期间触发一次，并且是幂等的，因此之后的 app.listen() 不会再次运行它。
• 关闭钩子需要 app.close()。 OnModuleDestroy、BeforeApplicationShutdown 和 OnApplicationShutdown 会在你调用 app.close() 时运行。

Elysia 生命周期装饰器

nestelia 还将 Elysia 的请求生命周期钩子作为方法装饰器暴露在控制器上：

import {
  OnRequest,
  OnBeforeHandle,
  OnAfterHandle,
  OnAfterResponse,
  OnError,
} from "nestelia";

@Controller("/")
class AppController {
  @OnRequest()
  logRequest(ctx: any) {
    console.log(`${ctx.request.method} ${ctx.request.url}`);
  }

  @OnBeforeHandle()
  checkAuth(ctx: any) {
    // 在路由处理器之前运行
  }

  @OnAfterHandle()
  addHeaders(ctx: any) {
    ctx.set.headers["x-powered-by"] = "nestelia";
  }

  @OnError()
  handleError(ctx: any) {
    console.error("Error:", ctx.error);
  }

  @OnAfterResponse()
  logResponse(ctx: any) {
    console.log("Response sent");
  }
}

可用的 Elysia 生命周期装饰器：

装饰器	钩子
@OnRequest()	路由前
@OnParse()	请求体解析
@OnTransform()	转换请求
@OnBeforeHandle()	处理器前
@OnAfterHandle()	处理器后
@OnMapResponse()	映射响应
@OnAfterResponse()	响应发送后
@OnError()	错误处理