装饰器是一种特殊类型的声明，它能够被附加到类声明，方法， 访问符，属性或参数上。 装饰器使用 @expression 这种形式，expression 求值后必须为一个函数，它会在运行时被调用，被装饰的声明信息做为参数传入。

1️⃣ 类装饰器

类装饰器的本质就是一个函数，该函数接收一个参数，表示类本身（ 构造函数本身 ）
使用类装饰器 **@后跟一个函数**
在 TS 中如何约束一个变量为类

function test(target: new () => object) {
  // target: new () => object 约束一个变量为类
}

在 TS 中要使用装饰器，需要在配置中开启**experimentalDecorators**
装饰器的运行时间：在类定义后直接运行
类装饰器可以具有的返回值：

  1. void：仅运行
  1. 返回一个新的类

function test(target: new () => object) {
  return class B extends target { // 返回一个新的类继承原来的类
  }
}
@test
class A {
}

2️⃣ TS 中如何约束一个构造函数

2️⃣ 装饰器的执行顺序

装饰器的正常执行顺序。

装饰器由函数返回的执行顺序。

1️⃣ 成员装饰器

2️⃣ 属性

属性装饰器也是一个函数，该函数需要两个参数：

  1. 如果是静态属性，则为类本身；如果是实例属性，则为类的原型。
  1. 固定为一个字符串，表示为属性名。

2️⃣ 方法

方法装饰器也是一个函数，该函数需要三个参数：

  1. 对于静态成员来说是类的构造函数，对于实例成员是类的原型对象。
  1. 成员的名字。
  1. 成员的属性描述符。

1️⃣ 保存元数据【 库 】

保存元数据

  1. 使用 `reflect-metadata` 库
  1. `npm install reflect-metadata`

1️⃣ 类验证【 库 】

类验证

  1. 使用 `class-validator` 库（ `class-validator` 依赖于 `reflect-metadata` 库 ）
  1. `npm install class-validator --save`

2️⃣ 使用方法

import "reflect-metadata" // class-validator 依赖于 reflect-metadata 所以需要引入
import { Max } from "class-validator"
class Post {
    @Max(10) // 最大为 10
  a: number;
}

2️⃣ validate 的返回对象数组

// 使用 validate() 函数传入类实例，通过 then 获取到错误信息
validate(post).then(error => {
  console.log(error);
})
// 该 validate 方法返回一个 ValidationError 对象数组。每个 ValidationError 是：
{
  target: Object; // 被验证的对象。
  property: string; // 未通过验证的对象属性。
  value: any; // 未通过验证的值。
  constraints ?: { // 验证失败并显示错误消息的约束。
    [type: string]: string;
  };
  children ?: ValidationError[]; // 包含属性的所有嵌套验证错误
}

如果您不想 **target **在验证错误中暴露 ，则在使用验证器时有一个特殊选项：

validator.validate(post, { validationError: { target: false } });

2️⃣ 验证消息

验证消息作为第二个参数对象的 key 传入 键为：message，值为：报错时返回的错误信息

class Post {
  @Contains('Hello', { message : '字符串不包含 Hello 字符'})  
  a: string = ''
}

您可以在消息中使用一些特殊令牌：

  1. **$value** - 正在验证的值
  1. **$property** - 正在验证的对象属性的名称
  1. **$target **- 被验证的对象类的名称
  1. **$constraint1, $constraint2, ... $constraintN**- 由特定验证类型定义的约束

class Post {
  @Contains('Hei', { message : '$value $property $target $constraint1'}) 
  a: string = 'HelloWorld';
}

// 报错信息返回为：
[
  ValidationError {
    target: Cla { title: 'HelloWorld' },
    value: 'HelloWorld',
    property: 'title',
    children: [],
    constraints: { contains: 'HelloWorld title Cla hello ' }
  }
]

您也可以提供一个返回消息的函数。这允许您创建更精细的消息：

import { MinLength, MaxLength, ValidationArguments } from 'class-validator';

class Post {
  @MinLength(10, {
    message: (args: ValidationArguments) => {
      if (args.value.length === 1) {
        return 'Too short, minimum length is 1 character';
      } else {
        return 'Too short, minimum length is ' + args.constraints[0] + ' characters';
      }
    },
  })
  title: string;
}

消息函数接受ValidationArguments其中包含以下信息：

  1. **value **- 正在验证的值
  1. **constraints** - 由特定验证类型定义的约束数组
  1. **targetName** - 被验证的对象类的名称
  1. **object **- 正在验证的对象
  1. **property** - 正在验证的对象属性的名称

2️⃣ 验证数组

如果您的字段是一个数组并且您想对数组中的每个项目执行验证，您必须指定一个特殊的 **each: true** 装饰器选项：
这将验证 post.tags 数组中的每个项目。

import { MinLength, MaxLength } from 'class-validator';

class Post {
  @Max(20, { // 数组的每一项都不能大于 20
    each: true,
  })
  tags: number[];
}

2️⃣ 验证装饰器

1️⃣ 平面对象转化为类对象【 库 】

平面对象转化为类对象

  1. 使用 `class-transformer` 库（  `class-transformer`  依赖于 `reflect-metadata` 库 ）
  1. `npm install class-transformer --save`

// 模拟 json 数据 - 有一个 users.json 在加载的用户列表：
[
  {
    "id": 1,
    "firstName": "Johny",
    "lastName": "Cage",
    "age": 27
  },
  {
    "id": 2,
    "firstName": "Ismoil",
    "lastName": "Somoni",
    "age": 50
  },
  {
    "id": 3,
    "firstName": "Luke",
    "lastName": "Dacascos",
    "age": 12
  }
]

// 定义类 - 有一个 User 类：
class User {
  id: number;
  firstName: string;
  lastName: string;
  age: number;

  getName() {
    return this.firstName + ' ' + this.lastName;
  }
  isAdult() {
    return this.age > 36 && this.age < 60;
  }
}

// 您假设您正在 User 从 users.json 文件下载类型的用户，并且可能想要编写以下代码：
// 请求到 json 以后，通过 const realUsers = plainToClass(User, users); 将 json 对象转化为类对象
fetch('users.json').then((users: Object[]) => {
  // 你可以在这里使用 users，并且类型提示也对你可用，
  // 但 users 实际上不是 User 类的实例
  // 这意味着你不能使用 User 类的方法

  // 现在 realUsers 中的每个用户都是 User 类的一个实例
  const realUsers = plainToClass(User, users);

  // 就可以直接使用函数
     realUsers.getName() 
});

通过这个库就可以约束和转化 json 对象中的返回类型，只需要修改 User 类就可以

  1. 使用装饰器@Type进行运行时的类型约束
  1. 通过 `**@type(()=>Number)**` 传入一个函数来约束类型，进行运行时的类型约束

class User {
  @type(() => Number)    
  id: number;
    @type(() => String)
  firstName: string;
    @type(() => String)
  lastName: string;
    @type(() => Number)
  age: number;

  getName() {
    return this.firstName + ' ' + this.lastName;
  }
  isAdult() {
    return this.age > 36 && this.age < 60;
  }
}

1️⃣ 装饰器扩展

2️⃣ 参数装饰器

最大作用是做依赖注入和依赖倒置
要求函数有三个参数

  1. 如果方法时静态的，则为类的本身。如果方式是实例方法，则为类的原型。
  1. 方法名称
  1. 在参数列表中的索引

2️⃣ 关于 TS 自动注入的元数据

如果安装了 **reflect-metadata**，并且导入了该库，并且在某个成员上添加了元数据，并且启用了 **"emitDecoratorMetadata": true**
则 TS 在编译结果中，会将约束的类型，作为元数据加入到相应位置
这样一来，TS 类型检测（ 约束 ）将有机会再运行时进行。

2️⃣ AOP（ 面向切面编程 ）

在软件业，AOP为Aspect Oriented Programming的缩写，意为：面向切面编程，通过预编译方式和运行期间动态代理实现程序功能的统一维护的一种技术。AOP是OOP的延续，是软件开发中的一个热点，也是Spring框架中的一个重要内容，是函数式编程的一种衍生范型。利用AOP可以对业务逻辑的各个部分进行隔离，从而使得业务逻辑各部分之间的耦合度降低，提高程序的可重用性，同时提高了开发的效率。