如何实现支持参数传递的并发安全方法链式调用？

核心需求 #

• 主类实例不绑定状态，并发调用无异常
• 链式方法支持传递自定义参数
• 尽可能避免创建额外类实例

现有方案的问题 #

之前的实现要么需要把控制参数直接传给业务方法（耦合性高），要么创建固定状态的实例（无法动态传参），或者直接修改主实例状态（并发调用时会互相干扰），都无法同时满足所有需求。

最优实现方案 #

利用Proxy创建临时上下文，链式调用时记录参数，业务方法执行时读取临时参数，执行完成后自动清理，完全不污染主实例：

class MyApi {
  // 链式方法：返回代理对象，临时存储参数
  withSomeLogic(args) {
    return new Proxy(this, {
      get(target, prop) {
        // 拦截方法调用，包装执行逻辑
        if (typeof target[prop] === 'function') {
          return (...methodArgs) => {
            // 给原方法传入临时上下文参数
            return target[prop]({ enableSomeLogic: true, args }, ...methodArgs);
          };
        }
        // 非方法属性直接返回原实例的值
        return target[prop];
      }
    });
  }

  // 业务方法：接收临时上下文参数
  async foo(context, ...otherArgs) {
    if (context?.enableSomeLogic) {
      console.log('Some logic enabled', context.args, otherArgs);
    } else {
      console.log('Some logic disabled', otherArgs);
    }
  }

  // 其他业务方法同理扩展
  async bar(context, ...otherArgs) {
    if (context?.enableSomeLogic) {
      console.log('Bar with some logic', context.args);
    } else {
      console.log('Bar without logic');
    }
  }
}

// 使用示例
const myApi = new MyApi();

// 带参数的链式调用
myApi.withSomeLogic({ id: 123 }).foo('额外参数'); 
// 输出：Some logic enabled { id: 123 } [ '额外参数' ]

// 直接调用，不影响主实例
myApi.foo('直接调用'); 
// 输出：Some logic disabled [ '直接调用' ]

// 并发调用无冲突
Promise.all([
  myApi.withSomeLogic('第一个请求参数').foo(),
  myApi.withSomeLogic('第二个请求参数').foo(),
  myApi.foo()
]);
// 输出顺序可能不同，但参数互不干扰

方案优势 #

1. 无状态污染：主实例始终保持干净，链式调用的参数只存在于临时Proxy的调用上下文，不会修改主实例的任何属性
2. 支持动态传参：每次调用withSomeLogic都可以传递不同的参数，完全独立
3. 低开销：仅创建临时Proxy对象，比创建新类实例的开销小得多，调用完成后Proxy会被自动垃圾回收

兼容旧环境的替代方案 #

如果需要兼容不支持Proxy的环境，可以用临时包装器对象，手动包装需要链式调用的方法：

class MyApi {
  withSomeLogic(args) {
    // 创建临时包装对象，重写需要链式调用的方法
    const wrapper = {
      foo: (...methodArgs) => this.foo({ enableSomeLogic: true, args }, ...methodArgs),
      bar: (...methodArgs) => this.bar({ enableSomeLogic: true, args }, ...methodArgs)
      // 其他需要链式调用的方法在这里添加
    };
    // 让包装器继承主实例的其他属性和方法
    Object.setPrototypeOf(wrapper, this);
    return wrapper;
  }

  async foo(context, ...otherArgs) {
    if (context?.enableSomeLogic) {
      console.log('Some logic enabled', context.args, otherArgs);
    } else {
      console.log('Some logic disabled', otherArgs);
    }
  }

  async bar(context, ...otherArgs) {
    // 同理实现业务逻辑
  }
}

这个方案兼容性更好，但需要手动维护包装的方法列表，适合类方法数量不多的场景。

内容的提问来源于stack exchange，提问作者Rob Minasyan