第45章 参数装饰器

案例45:参数装饰器——记录参数信息

设计思路

参数装饰器接收三个参数:目标类原型、方法名、参数索引。利用装饰器工厂将参数名与索引绑定到全局元数据中,再配合方法装饰器或拦截器输出调用时的参数详情。本案例演示了最基础的应用——在方法调用前打印参数名和对应值。

核心代码

// 参数元数据存储
const paramNames: Record<string, string[]> = {};

// 参数装饰器工厂
function Param(name: string) {
  return function (target: any, method: string, index: number) {
    const key = `${target.constructor.name}.${method}`;
    if (!paramNames[key]) paramNames[key] = [];
    paramNames[key][index] = name;
  };
}

// 方法装饰器:打印参数信息
function LogParams(target: any, method: string, desc: PropertyDescriptor) {
  const original = desc.value;
  desc.value = function (...args: any[]) {
    const key = `${target.constructor.name}.${method}`;
    const names = paramNames[key] || [];
    const info = args.map((v, i) => `${names[i] ?? 'arg' + i}=${v}`);
    console.log(`调用 ${method}(${info.join(', ')})`);
    return original.apply(this, args);
  };
}

// 使用示例
class UserService {
  @LogParams
  greet(@Param('name') name: string, @Param('age') age: number) {
    return `你好,${name},年龄${age}`;
  }
}

// 运行
const svc = new UserService();
console.log(svc.greet('张三', 30));

运行验证

使用 ts-node 或 tsc + node 运行,输出:
调用 greet(name=张三, age=30)
你好,张三,年龄30

注意事项

参数装饰器在类定义时执行,而非调用时;元数据键需包含类名和方法名,避免不同类的方法冲突。

成功要点

通过装饰器组合实现“自动参数日志”,为后续AOP编程打下基础,是框架中依赖注入和参数校验的雏形。