用于 Node.js 的依赖注入容器 Awilix

用于 JavaScript (Node.js) 的依赖注入容器：Awilix

在现代 Node.js 开发中，保持架构的清晰和代码的可测试性至关重要。实现这一目标的关键模式之一是 Dependency Injection (DI)——依赖注入。为了在 JavaScript 环境中有效实现此模式，诞生了专门的库——依赖注入容器。在本文中，我们将详细介绍其中最流行且轻量级的库之一——Awilix。

什么是依赖注入，为什么需要容器？

在传统方法中，对象自行创建其依赖项（例如，使用 new 运算符）。这会导致代码高度耦合，从而增加测试和修改的难度。依赖注入模式建议从外部传递（注入）依赖项。而容器则自动化了这一过程：它知道如何创建对象及其依赖项，并在请求时提供准备好的实例。

Awilix：轻量级且强大的 DI 容器

Awilix 是一个用于 JavaScript (Node.js) 的库，它通过容器实现了 控制反转 (IoC) 模式。它是为 Node.js 从头编写的，支持异步依赖解析、多种注册方式（类、工厂、值）以及通过构造函数自动发现依赖项。

主要功能：

自动注入：容器分析构造函数或函数的参数，并自动注入所需的依赖项。
异步支持：依赖项可以是异步的（例如，数据库连接），容器会正确等待其解析完成。
多种注册模式：您可以注册类（asClass）、工厂函数（asFunction）或现成的值（asValue）。
作用域 (Scopes)：支持不同的对象生命周期（单例、瞬态、作用域）。
模块化：容器可以轻松拆分为模块，并在应用程序的不同部分注册依赖项。

安装与基本使用

通过 npm 安装 Awilix：

npm install awilix

让我们看一个最简单的例子。假设我们有一个用户服务，它依赖于日志记录器和存储库。

const { createContainer, asClass, asFunction, asValue } = require('awilix');

// 1. 定义依赖项class Logger {    log(message) {        console.log(`[LOG]: ${message}`);    }}

class UserRepository {    constructor({ logger }) {        this.logger = logger;    }

    findById(id) {        this.logger.log(`正在查找 ID 为 ${id} 的用户`);        return { id, name: 'John Doe' };    }}

class UserService {    constructor({ userRepository, logger }) {        this.userRepository = userRepository;        this.logger = logger;    }

    getUser(id) {        this.logger.log('请求 UserService');        return this.userRepository.findById(id);    }}

// 2. 创建容器并注册依赖项const container = createContainer();

container.register({    logger: asClass(Logger).singleton(),    userRepository: asClass(UserRepository).singleton(),    userService: asClass(UserService).singleton()});

// 3. 使用容器获取服务const userService = container.resolve('userService');const user = userService.getUser(1);console.log(user);// 输出：// [LOG]: 请求 UserService// [LOG]: 正在查找 ID 为 1 的用户// { id: 1, name: 'John Doe' }