SuperAPI AI 工具集

ast-visitor-pattern

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:在判别联合(discriminated union)拥有 3 个以上变体、且存在 2 个以上分派点(渲染器、序列化器、分类器等)时,用冻结子类加访问者接口替代普通联合加 switch,让新增变体在每个消费方都变成编译错误,而不是被静默遗漏。

结构:四部分始终放在同一文件。1)抽象基类(不导出,消费者使用联合类型),含 abstract readonly kind、abstract accept<R>(visitor: FooVisitor<R>): R,以及 protected freeze(): void { Object.freeze(this); }。2)访问者接口 FooVisitor,为每个变体声明方法。3)具体子类,字段 readonly,构造函数中调用 freeze(),accept 转发到对应 visitor 方法。4)导出联合类型 type Foo = BarNode | BazNode。

使用方式:每个关注点定义一个访问者对象或类,例如 renderVisitor,然后通过 node.accept(renderVisitor) 分派。

关键约束:始终构造实例,不要用冻结的普通对象字面量。测试与生产构造面(工厂、构建器)都必须返回 new BarNode(...),而非 Object.freeze({ kind: 'bar', value: 'x' })。冻结的普通对象没有原型,instanceof 失败,缺少 accept(),下游浅拷贝会静默剥掉类型退回匿名对象,构造期不变量也会被跳过。

不适用场景:只有一个分派点时,普通联合加 switch 更简单;变体少于 3 个且预期不增长时,不值得引入样板。

代码库示例:MongoAstNode / MongoDdlCommandVisitor(packages/2-mongo-family/4-query/query-ast/src/ddl-commands.ts);OpFactoryCall / OpFactoryCallVisitor(packages/3-mongo-target/1-mongo-target/src/core/op-factory-call.ts)。