工厂

当构造过程不止于 new Ctor(...deps) 时——比如读取多个值、适配第三方客户端、创建配置对象或返回一个 promise——请使用 registerFactory。

const container = new Container()
  .registerValue('config', { dsn: 'postgres://localhost/app', poolSize: 10 })
  .registerFactory('pgPool', (c) => {
    const { dsn, poolSize } = c.get('config')
    return new Pool({ connectionString: dsn, max: poolSize })
  })
  .registerClass('users', UserRepo, ['pgPool'])

工厂的返回值即成为该键所解析出的类型。

瞬态热路径图

registerClass 是注册瞬态服务的默认方式。只有在性能分析表明对象构造占据热路径的重要部分时，才需要改动。

V8 对一种特定模式可能变慢：同一个图反复解析许多依赖数量相同、但不同的瞬态类。性能分析和应用构建产物确认该热点后，只将这些服务改为工厂注册：

const container = new Container()
  .registerClass('context', RequestContext, [], 'scoped')
  .registerClass('schema', Schema, [])
  .registerFactory(
    'parseRequest',
    (c) => new ParseRequest(c.get('context'), c.get('schema')),
    'transient',
  )

每个工厂都应包含自己的 new Service(...) 调用。如果这项优化重要，不要将多个服务转给同一个通用构造 helper。工厂会重复依赖接线，只用于已经测量到的热点。

工厂生命周期

工厂使用与类相同的生命周期模型：

const root = new Container()
  .registerFactory('cache', () => new Cache(), 'singleton')
  .registerFactory('request', () => new RequestState(), 'scoped')

在单例工厂内部，c 参数会被收窄为对单例安全的依赖。作用域级和瞬态键不会出现在自动补全中，并会被 TypeScript 拒绝。

传入可选的第四个参数 lazyKey，即可注册一个保留目标生命周期的 Lazy<V> 伴随项，其行为与 registerClass 完全相同：

const root = new Container()
  .registerFactory('cache', () => new Cache(), 'singleton', 'cacheLazy')

root.get('cacheLazy').get() // Cache

若要使用默认的单例生命周期，请在伴随键之前传入 undefined：registerFactory('cache', factory, undefined, 'cacheLazy')。

绑定接口

TypeScript 接口在编译期被擦除，没有可以作为构造函数传入的运行时值。请改为通过显式的工厂类型，将接口绑定到它的实现：

interface Mailer {
  send(message: string): void
}

class SendGridMailer implements Mailer {
  send(message: string) {}
}

const container = new Container()
  .registerFactory<'mailer', Mailer>('mailer', () => new SendGridMailer())

'mailer' 的消费方看到的是 Mailer 抽象，而不是具体的类。

异步工厂

工厂可以返回 promise。promise 本身会被缓存，因此并发的调用方会共享同一次初始化：

const c = new Container()
  .registerValue('dsn', 'postgres://localhost/app')
  .registerFactory('db', async (c) => {
    const pool = new Pool({ connectionString: c.get('dsn') })
    await pool.connect()
    return pool
  })

const [a, b] = await Promise.all([c.get('db'), c.get('db')])
await c.dispose()

.get() 始终保持同步。当注册是异步的时候，调用方对返回的值进行 await。

循环与生命周期守卫只跟踪工厂的同步调用栈。await 之后，AllowedDeps 仍会保护普通的类型化代码，但通过 as 强制转换或捕获的外部容器会处于运行时守卫上下文之外。请在第一次 await 之前的同步阶段读取依赖项。

工厂 ​

瞬态热路径图 ​

工厂生命周期 ​

绑定接口 ​

异步工厂 ​

工厂

瞬态热路径图

工厂生命周期

绑定接口

异步工厂