第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编程打下基础,是框架中依赖注入和参数校验的雏形。