TypeScript中的装饰器：在类和类成员上添加元数据

# 1. 理解装饰器

## 1.1 什么是装饰器？
装饰器是一种特殊类型的声明，它可以被附加到类声明、方法、访问符、属性或参数上。装饰器使用`@装饰器名称`这种语法，并且可以带有一个可选的参数。例如，在TypeScript中，装饰器可以用来修改类的行为。

## 1.2 装饰器的作用和优势
装饰器提供了一种更为灵活和可维护的方式来修改类和类成员。它们可以被用于添加元数据、修改属性、实现方法扩展等操作。

## 1.3 装饰器的基本语法和用法
装饰器是通过在类、属性、方法、参数前使用`@装饰器名称`的方式来使用的。装饰器可以单独使用，也可以与其他装饰器链式使用。装饰器可以是一个简单的函数，也可以带有参数。

// 装饰器工厂
function logClass(target: any) {
  // 保存原始构造函数的引用
  const original = target;

  // 创建一个新的构造函数
  function newConstructor(...args: any[]) {
    console.log(`Creating new instance`);
    return new original(...args);
  }

  // 将原始构造函数的原型指向新的构造函数
  newConstructor.prototype = original.prototype;

  // 返回新的构造函数
  return newConstructor;
}

// 使用装饰器
@logClass
class Example {
  constructor(message: string) {
    console.log(`Creating example: ${message}`);
  }
}

// 创建实例
const example = new Example('decorator');

上述例子中，`logClass`装饰器工厂接收一个类，并返回一个新的类构造函数，用来在创建类实例时输出日志。

# 2. 在类中使用装饰器

装饰器在TypeScript中扮演着非常重要的角色，可以用来装饰类和类成员，为它们添加额外的元数据和功能。在这一章节中，我们将探讨如何在类中使用装饰器。

### 2.1 在类上添加装饰器

在类上添加装饰器时，可以通过在类的声明前面使用`@decorator`的语法来实现。装饰器可以是一个函数，接受一个参数，即被装饰的类本身。这使得我们可以在装饰器函数内部对类进行一些操作或者添加一些元数据。

def classDecorator(target):
    target.isDecorated = true;
}

@classDecorator
class ExampleClass {
    // Class implementation here
}

console.log(ExampleClass.isDecorated); // true

### 2.2 为类添加元数据

通过装饰器，我们还可以为类添加元数据，这些元数据可以在运行时被访问和利用。下面是一个为类添加元数据的例子：

function addMetadata(metadata: string) {
    return function(target) {
        target.metadata = metadata;
    }
}

@addMetadata('This is some metadata')
class MetadataClass {
    // Class implementation here
}

console.log(MetadataClass.metadata); // This is some metadata

### 2.3 装饰器链

装饰器可以链式调用，多个装饰器可以同时应用于同一个类。它们的执行顺序是从上到下，由外到内。

function logClass(target) {
    console.log('Class logged: ' + target.name);
}

function setAPIVersion(version: string) {
    return function (target) {
        target.apiVersion = version;
    }
}

@logClass
@setAPIVersion('1.0')
class APIClass {
    // Class implementation here
}

console.log(APIClass.apiVersion); // 1.0

在这一章节中，我们介绍了如何在类中使用装饰器，包括在类上添加装饰器、为类添加元数据以及装饰器链的应用。装饰器为我们的类提供了更多的灵活性，让我们可以更方便地扩展和管理类的功能。

# 3. 在类成员上使用装饰器

在第三章中，我们将深入探讨如何在类的属性和方法上应用装饰器。装饰器在类成员上的应用为我们提供了更多的灵活性，可以用于参数装饰器、方法扩展等场景。

#### 3.1 装饰器在属性和方法上的应用

装饰器可以被用于类的属性和方法上，从而对它们进行增强或修改。例如，我们可以使用装饰器来对属性进行验证、对方法进行日志记录等操作。下面是一个简单的例子，演示了如何在TypeScript中使用装饰器来对类的属性和方法进行增强：

function log(target: any, key: string) {
  console.log(`${key} 被调用`);
}

class Example {
  @log
  greeting: string = 'Hello';

  @log
  sayHello() {
    console.log(this.greeting);
  }
}

const instance = new Example();
instance.sayHello(); // 输出：sayHello 被调用

在上面的示例中，我们定义了一个`log`装饰器，并分别将它应用在了`greeting`属性和`sayHello`方法上。当我们创建`Example`类的实例并调用`sayHello`方法时，装饰器会输出被调用的信息，