绑定

绑定表示服务标识符与其解析之间的关系。绑定被添加到容器中以配置它提供服务。

const container: Container = new Container();
container.bind<Weapon>('Weapon').to(Katana).inSingletonScope();

当绑定添加到容器时，容器被配置为通过解析 Katana 类来为服务标识符 Weapon 提供解析值。container.bind 创建一个具有某些属性的新绑定，这些属性将在下面解释。

依赖发出的类元数据

使用 TypeScript 时，您可以依赖发出的类元数据，以避免手动指定服务标识符。这是通过在要绑定的类上使用 inversify 的 @injectable 装饰器来完成的。您需要启用 emitDecoratorMetadata TypeScript 编译器选项。

export class Katana {
  public readonly damage: number = 10;
}

@injectable()
export class Samurai {
  public readonly katana: Katana;

  constructor(katana: Katana) {
    this.katana = katana;
  }
}

const container: Container = new Container();

container.bind(Katana).toSelf().inSingletonScope();
container.bind(Samurai).toSelf().inSingletonScope();

const samurai: Samurai = container.get(Samurai);

自动绑定

InversifyJS 提供了一个名为自动绑定的功能，允许您自动绑定类。每当解析类服务且在规划阶段未找到绑定时，容器会在继续规划阶段之前向请求的类添加类型绑定。此功能默认禁用。要启用它，您需要将 autoBindInjectable 选项传递给容器。

export class Katana {
  public readonly damage: number = 10;
}

@injectable()
export class Samurai {
  public readonly katana: Katana;

  constructor(katana: Katana) {
    this.katana = katana;
  }
}

const container: Container = new Container({ autoBindInjectable: true });

const samurai: Samurai = container.resolve(Samurai);

绑定属性

绑定具有以下属性：

服务标识符

提供解析的服务的标识符。

作用域

作用域确定用于决定是解析服务还是提供缓存值的缓存策略。

请求 (Request)

当在同一个 container.get 请求中解析服务时，将使用相同的解析值。

export class LegendaryWarrior {
  constructor(
    @inject('Weapon') public readonly firstWeapon: Weapon,
    @inject('Weapon') public readonly secondWeapon: Weapon,
    @inject('Weapon') public readonly thirdWeapon: Weapon,
  ) {}
}

const container: Container = new Container();
container.bind<Weapon>('Weapon').to(Katana).inRequestScope();
container.bind(LegendaryWarrior).toSelf();

const firstKatana: Weapon = container.get<Weapon>('Weapon');
const secondKatana: Weapon = container.get<Weapon>('Weapon');

const legendaryWarrior: LegendaryWarrior = container.get(LegendaryWarrior);

// Returns false
const isSameKatana: boolean = firstKatana === secondKatana;

// Returns true
const warriorHasSameKatana: boolean =
  legendaryWarrior.firstWeapon === legendaryWarrior.secondWeapon &&
  legendaryWarrior.secondWeapon === legendaryWarrior.thirdWeapon;

单例 (Singleton)

当解析服务时，将使用相同的缓存解析值。

const container: Container = new Container();
container.bind<Weapon>('Weapon').to(Katana).inSingletonScope();

const firstKatana: Weapon = container.get<Weapon>('Weapon');
const secondKatana: Weapon = container.get<Weapon>('Weapon');

// Returns true
const isSameKatana: boolean = firstKatana === secondKatana;

瞬态 (Transient)

当解析服务时，每次都会使用新的解析值。

const container: Container = new Container();
container.bind<Weapon>('Weapon').to(Katana).inTransientScope();

const firstKatana: Weapon = container.get<Weapon>('Weapon');
const secondKatana: Weapon = container.get<Weapon>('Weapon');

// Returns false
const isSameKatana: boolean = firstKatana === secondKatana;

约束

指定绑定是否用于为给定的服务标识符提供解析值。有关更多信息，请参阅 API 文档。

生命周期处理程序

在提供解析值或停用单例作用域绑定后调用的处理程序。有关更多信息，请参阅 API 文档。