TypeScript Reflect Metadata
本节介绍的 Reflect Metadata 主要用来在声明的时候添加和读取元数据。通过这种方式给对象添加额外的信息,是不会影响对象的结构的。
1. 解释
Reflect,翻译为『反射』,Metadata,翻译为『元数据』。反射这个概念在 Java 等众多语言中已经广泛运用,Reflect Metadata 就是通过装饰器来给类添加一些自定义的信息,然后通过反射将这些信息提取出来,也可以通过反射来添加这些信息。
2. 安装使用
通过 npm 安装这个库:
npm i reflect-metadata --save
而且需要在 tsconfig.json
中配置:
{ "compilerOptions": { "target": "ES5", "experimentalDecorators": true, "emitDecoratorMetadata": true } }
命令行使用:
tsc --target ES5 --experimentalDecorators --emitDecoratorMetadata
当启用后,只要 reflect-metadata
库被引入了,设计阶段添加的类型信息可以在运行时使用。
import 'reflect-metadata' @Reflect.metadata('token', 'aW1vb2M=') class Employee { @Reflect.metadata('level', 'D2') salary() { console.log('这是个秘密') } @Reflect.metadata('times', 'daily') static meeting() {} } const token = Reflect.getMetadata('token', Employee) const level = Reflect.getMetadata('level', new Employee(), 'salary') const times = Reflect.getMetadata('times', Employee, 'meeting') console.log(token) // aW1vb2M= console.log(level) // D2 console.log(times) // daily
TIPS: 注意, 实例方法与静态方法取元数据是不同的,实例方法需要在类的实例上取元数据,静态方法直接在类上取元数据。
3. API
import 'reflect-metadata' // 元数据的命令式定义,定义对象或属性的元数据 Reflect.defineMetadata(metadataKey, metadataValue, target) Reflect.defineMetadata(metadataKey, metadataValue, target, propertyKey) // 检查对象或属性的原型链上是否存在元数据键 let result = Reflect.hasMetadata(metadataKey, target) let result = Reflect.hasMetadata(metadataKey, target, propertyKey) // 检查对象或属性是否存在自己的元数据键 let result = Reflect.hasMetadata(metadataKey, target) let result = Reflect.hasMetadata(metadataKey, target, propertyKey) // 获取对象或属性原型链上元数据键的元数据值 let result = Reflect.getMetadata(metadataKey, target) let result = Reflect.getMetadata(metadataKey, target, propertyKey) // 获取对象或属性的自己的元数据键的元数据值 let result = Reflect.getOwnMetadata(metadataKey, target) let result = Reflect.getOwnMetadata(metadataKey, target, propertyKey) // 获取对象或属性原型链上的所有元数据键 let result = Reflect.getMetadataKeys(target) let result = Reflect.getMetadataKeys(target, propertyKey) // 获取对象或属性的所有自己的元数据键 let result = Reflect.getOwnMetadataKeys(target) let result = Reflect.getOwnMetadataKeys(target, propertyKey) // 从对象或属性中删除元数据 let result = Reflect.deleteMetadata(metadataKey, target) let result = Reflect.deleteMetadata(metadataKey, target, propertyKey) // 通过装饰器将元数据应用于构造函数 @Reflect.metadata(metadataKey, metadataValue) class C { // 通过装饰器将元数据应用于方法(属性) @Reflect.metadata(metadataKey, metadataValue) method() { } }
4. 结合装饰器使用
Reflect Metadata 结合上节介绍的装饰器:
import 'reflect-metadata' function get(path: string): MethodDecorator { return (target, name) => { Reflect.defineMetadata('path', path, target, name) } } class Employee { @get('/init') async init() {} } const metadata = Reflect.getMetadata('path', new Employee(), 'init') console.log(metadata) // '/init'
解释: 如果经常开发 Node.js 的同学对这样的写法是不是有些熟悉呢?类方法 init()
上的装饰器 get()
传入元数据 '/init'
,再通过反射拿到这个路由信息,将这些路由信息进行一定的封装,然后绑定在 koa-router
上,就能达到自动加载路由的功能。
5. 小结
本节介绍了 Reflect Metadata 的一些基础使用方式,一些基础库源码如 vue-class-component
、Angular
均使用了 Reflect Metadata ,有兴趣的可以深入源码学习下。