第42章 装饰器(类)

案例42:装饰器(类)——为类添加日志元数据

题目:通过类装饰器,在类定义时自动捕获其构造函数参数,生成可追踪的日志元数据,并在实例创建时记录调用信息。

设计思路

使用TypeScript类装饰器工厂模式:
1. 装饰器接收原始构造函数,返回新构造函数(继承或包装);
2. 利用原型链保存日志元数据;
3. 运行时通过元数据打印实例化信息。

核心代码

function Loggable(target: any) {
  const original = target;
  const meta: any = { createdAt: new Date(), calls: 0 };
  
  function newConstructor(...args: any[]) {
    meta.calls++;
    console.log(`[日志] 实例化 ${original.name},参数:`, args);
    return new original(...args);
  }
  newConstructor.prototype = original.prototype;
  newConstructor.meta = meta; // 元数据
  return newConstructor;
}

@Loggable
class User {
  constructor(public name: string, public age: number) {}
}

const u1 = new User("张三", 18);
const u2 = new User("李四", 20);
console.log("元数据:", (User as any).meta);
console.log(u1, u2);

运行与验证

需在tsconfig.json中启用 "experimentalDecorators": true。运行命令:tsc decorator.ts && node decorator.js。

注意事项

装饰器在类定义时执行一次,而非实例化时。若需按实例记录,需在构造函数内另行处理。元数据挂载在构造函数静态属性上,避免污染原型。

成功要点

装饰器返回值会替换原始类,因此必须保留原型链和方法。本案例展示了如何在TypeScript中利用装饰器实现轻量级AOP(面向切面编程)的日志切面。