TypeScript 类装饰器

// 定义类装饰器
function AddTimestamp(target: Function) {
    // target 就是被装饰的类的构造函数
    // 我们直接在它的原型（prototype）上挂载属性和方法
    target.prototype.createdAt = new Date().toLocaleString();

    // 修正：在严格模式下，动态挂载方法的 this 隐式为 any 会导致编译报错
    // 必须显式声明 this: any（或具体接口类型）来通过静态检查
    target.prototype.printTime = function(this: any) {
        console.log("[系统]: 创建时间为", this.createdAt);
    };
}

// 使用类装饰器
@AddTimestamp
class Article {
    public title: string;

    constructor(title: string) {
        this.title = title;
    }
}

const myArticle = new Article("TypeScript 装饰器");

// 注意：在原生 TypeScript 中直接调用注入的属性会提示类型错误
// 这里我们使用 as any 绕过编译期的类型检查
console.log((myArticle as any).createdAt);
(myArticle as any).printTime();

// 定义类装饰器
function BaseEntity<T extends { new (...args: any[]): {} }>(constructor: T) {
    // 返回一个继承自原类的匿名新类
    return class extends constructor {
        // 强制注入或覆盖属性
        public id: number = Math.floor(Math.random() * 10000);
        public createdAt: string = new Date().toLocaleDateString();

        // 甚至可以重写原类的方法
        public toString() {
            return `实体id：${this.id}，创建于：${this.createdAt}`;
        }
    };
}

@BaseEntity
class User {
    public username: string;

    constructor(name: string) {
        this.username = name;
        console.log(`User 原本的构造函数执行了，用户：${name}`);
    }
}

// 实例化 User
const u = new User("Jack");
console.log(u);

// 调用被重写的 toString()
console.log((u as any).toString());

// 定义装饰器工厂，接收一个表示路由路径的字符串参数
function Controller(path: string) {
    return function(target: Function) {
        // 在原型上悄悄保存这个路由路径
        target.prototype.$routePath = path;
        console.log(`[路由扫描]: 发现控制器 ${target.name}，映射路径为 ${path}`);
    };
}

// 使用工厂模式，传入 "/api/users"
@Controller("/api/users")
class UserController {
    public getUsers() {
        console.log("返回用户列表");
    }
}

@Controller("/api/orders")
class OrderController {
    public getOrders() {
        console.log("返回订单列表");
    }
}

const userCtrl = new UserController();
console.log("运行时获取到的路由前缀：", (userCtrl as any).$routePath);

// 1. 定义装饰器：给原型注入 createdAt 属性
function AddTimestamp(target: Function) {
    target.prototype.createdAt = new Date().toLocaleString();
}

// 2. 核心黑科技：定义一个与类同名的接口
// TypeScript 会自动将同名接口的属性合并到类的类型声明中
interface Article {
    createdAt: string; 
}

// 3. 正常使用类和装饰器
@AddTimestamp
class Article {
    public title: string;
    constructor(title: string) {
        this.title = title;
    }
}

const myArticle = new Article("TypeScript 装饰器");

// 4. 再也不需要 as any 了，编辑器会有完美的智能提示
console.log("文章创建时间：", myArticle.createdAt);