@kaokei/di 2.0.9 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/README.md +27 -56
  2. package/dist/binding.d.cts +36 -0
  3. package/dist/binding.d.ts +36 -0
  4. package/dist/cachemap.d.cts +21 -0
  5. package/dist/cachemap.d.ts +21 -0
  6. package/dist/constants.d.cts +28 -0
  7. package/dist/constants.d.ts +28 -0
  8. package/dist/container.d.cts +29 -0
  9. package/dist/container.d.ts +29 -0
  10. package/dist/decorator.d.cts +18 -0
  11. package/dist/decorator.d.ts +18 -0
  12. package/dist/errors/BaseError.d.cts +4 -0
  13. package/dist/errors/BaseError.d.ts +4 -0
  14. package/dist/errors/BindingNotFoundError.d.cts +5 -0
  15. package/dist/errors/BindingNotFoundError.d.ts +5 -0
  16. package/dist/errors/BindingNotValidError.d.cts +5 -0
  17. package/dist/errors/BindingNotValidError.d.ts +5 -0
  18. package/dist/errors/CircularDependencyError.d.cts +5 -0
  19. package/dist/errors/CircularDependencyError.d.ts +5 -0
  20. package/dist/errors/DuplicateBindingError.d.cts +5 -0
  21. package/dist/errors/DuplicateBindingError.d.ts +5 -0
  22. package/dist/errors/PostConstructError.d.cts +5 -0
  23. package/dist/errors/PostConstructError.d.ts +5 -0
  24. package/dist/index.cjs +1 -0
  25. package/dist/index.d.cts +4 -0
  26. package/dist/index.d.ts +4 -0
  27. package/dist/index.js +402 -0
  28. package/dist/interfaces.d.cts +47 -0
  29. package/dist/interfaces.d.ts +47 -0
  30. package/dist/lazyinject.d.cts +4 -0
  31. package/dist/lazyinject.d.ts +4 -0
  32. package/dist/token.d.cts +12 -0
  33. package/dist/token.d.ts +12 -0
  34. package/package.json +35 -89
  35. package/dist/index.cjs.js +0 -746
  36. package/dist/index.cjs.js.map +0 -1
  37. package/dist/index.cjs.min.js +0 -11
  38. package/dist/index.cjs.min.js.map +0 -1
  39. package/dist/index.cjs.runtime.js +0 -735
  40. package/dist/index.cjs.runtime.js.map +0 -1
  41. package/dist/index.cjs.runtime.min.js +0 -11
  42. package/dist/index.cjs.runtime.min.js.map +0 -1
  43. package/dist/index.esm.js +0 -724
  44. package/dist/index.esm.js.map +0 -1
  45. package/dist/index.esm.min.js +0 -11
  46. package/dist/index.esm.min.js.map +0 -1
  47. package/dist/index.esm.runtime.js +0 -713
  48. package/dist/index.esm.runtime.js.map +0 -1
  49. package/dist/index.esm.runtime.min.js +0 -11
  50. package/dist/index.esm.runtime.min.js.map +0 -1
  51. package/dist/index.iife.js +0 -749
  52. package/dist/index.iife.js.map +0 -1
  53. package/dist/index.iife.min.js +0 -11
  54. package/dist/index.iife.min.js.map +0 -1
  55. package/dist/src/Injector.d.ts +0 -143
  56. package/dist/src/Injector.d.ts.map +0 -1
  57. package/dist/src/constants.d.ts +0 -17
  58. package/dist/src/constants.d.ts.map +0 -1
  59. package/dist/src/decorator.d.ts +0 -42
  60. package/dist/src/decorator.d.ts.map +0 -1
  61. package/dist/src/errors/CircularDependencyError.d.ts +0 -6
  62. package/dist/src/errors/CircularDependencyError.d.ts.map +0 -1
  63. package/dist/src/errors/ConstructorInjectMissTokenError.d.ts +0 -6
  64. package/dist/src/errors/ConstructorInjectMissTokenError.d.ts.map +0 -1
  65. package/dist/src/errors/InjectFailedError.d.ts +0 -6
  66. package/dist/src/errors/InjectFailedError.d.ts.map +0 -1
  67. package/dist/src/errors/PropertyInjectMissTokenError.d.ts +0 -6
  68. package/dist/src/errors/PropertyInjectMissTokenError.d.ts.map +0 -1
  69. package/dist/src/errors/ProviderNotValidError.d.ts +0 -6
  70. package/dist/src/errors/ProviderNotValidError.d.ts.map +0 -1
  71. package/dist/src/errors/TokenNotFoundError.d.ts +0 -6
  72. package/dist/src/errors/TokenNotFoundError.d.ts.map +0 -1
  73. package/dist/src/errors/index.d.ts +0 -7
  74. package/dist/src/errors/index.d.ts.map +0 -1
  75. package/dist/src/forwardRef.d.ts +0 -7
  76. package/dist/src/forwardRef.d.ts.map +0 -1
  77. package/dist/src/index.d.ts +0 -7
  78. package/dist/src/index.d.ts.map +0 -1
  79. package/dist/src/utils.d.ts +0 -4
  80. package/dist/src/utils.d.ts.map +0 -1
@@ -1,735 +0,0 @@
1
- /**
2
- * @kaokei/di
3
- * Tiny di library depends on typescript and reflect-metadata
4
- *
5
- * @version 2.0.9
6
- * @author kaokei
7
- * @license MIT
8
- * @link https://github.com/kaokei/di
9
- */
10
-
11
- 'use strict';
12
-
13
- var _construct = require("@babel/runtime/helpers/construct");
14
- var _toConsumableArray = require("@babel/runtime/helpers/toConsumableArray");
15
- var _createClass = require("@babel/runtime/helpers/createClass");
16
- var _classCallCheck = require("@babel/runtime/helpers/classCallCheck");
17
- var _assertThisInitialized = require("@babel/runtime/helpers/assertThisInitialized");
18
- var _inherits = require("@babel/runtime/helpers/inherits");
19
- var _possibleConstructorReturn = require("@babel/runtime/helpers/possibleConstructorReturn");
20
- var _getPrototypeOf = require("@babel/runtime/helpers/getPrototypeOf");
21
- var _wrapNativeSuper = require("@babel/runtime/helpers/wrapNativeSuper");
22
- var _defineProperty = require("@babel/runtime/helpers/defineProperty");
23
- function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
24
- function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
25
- function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
26
- function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
27
- var DECORATOR_KEYS = {
28
- // ts自带的类的实例属性的类型的key
29
- DESIGN_PROPERTY_TYPE: 'design:type',
30
- // ts自带的类的构造函数的参数的类型信息的key
31
- DESIGN_PARAM_TYPES: 'design:paramtypes',
32
- // 记录构造函数参数装饰器对应的数据的key
33
- SERVICE_INJECTED_PARAMS: 'service:injected:params',
34
- // 记录实例属性装饰器对应的数据的key
35
- SERVICE_INJECTED_PROPS: 'service:injected:props',
36
- // Inject装饰器的key
37
- INJECT: Symbol('inject'),
38
- // Injectable装饰器的key
39
- INJECTABLE: Symbol('injectable'),
40
- // Self装饰器的key
41
- SELF: 'self',
42
- // Skip装饰器的key
43
- SKIP_SELF: 'skip',
44
- // Optional装饰器的key
45
- OPTIONAL: 'optional'
46
- };
47
- var SERVICE_STATUS = {
48
- INITING: Symbol('initing'),
49
- CONSTRUCTED: Symbol('constructed'),
50
- MERGED: Symbol('merged')
51
- };
52
- var CircularDependencyError = /*#__PURE__*/function (_Error) {
53
- _inherits(CircularDependencyError, _Error);
54
- var _super = _createSuper(CircularDependencyError);
55
- function CircularDependencyError(provider, options) {
56
- var _this;
57
- _classCallCheck(this, CircularDependencyError);
58
- _this = _super.call(this);
59
- _defineProperty(_assertThisInitialized(_this), "name", 'CIRCULAR_DEPENDENCY_ERROR');
60
- _defineProperty(_assertThisInitialized(_this), "message", _this.name);
61
- var tokenArr = [provider.provide];
62
- var currentProvider = options === null || options === void 0 ? void 0 : options.provider;
63
- while (currentProvider && currentProvider.provide) {
64
- tokenArr.push(currentProvider.provide);
65
- currentProvider = currentProvider.parent;
66
- }
67
- var tokenListText = tokenArr.join(' <-- ');
68
- _this.message = "CIRCULAR DEPENDENCY DETECTED. PLEASE FIX IT MANUALLY. \n ".concat(tokenListText);
69
- return _this;
70
- }
71
- return _createClass(CircularDependencyError);
72
- }( /*#__PURE__*/_wrapNativeSuper(Error));
73
- var InjectFailedError = /*#__PURE__*/function (_Error2) {
74
- _inherits(InjectFailedError, _Error2);
75
- var _super2 = _createSuper(InjectFailedError);
76
- function InjectFailedError(injectMeta, ClassName, key, paramType) {
77
- var _this2;
78
- _classCallCheck(this, InjectFailedError);
79
- _this2 = _super2.call(this);
80
- _defineProperty(_assertThisInitialized(_this2), "name", 'INJECT_FAILED_ERROR');
81
- _defineProperty(_assertThisInitialized(_this2), "message", _this2.name);
82
- if (paramType) {
83
- // 是构造函数的参数装饰器
84
- if (injectMeta && injectMeta.value === Object) {
85
- _this2.message = "CAN NOT USE OBJECT AS INJECTION TOKEN. PARAMETER ".concat(key, " OF CLASS ").concat(ClassName, ".");
86
- } else if (paramType === Object) {
87
- _this2.message = "CONSTRUCTOR PARAMETER TYPE IS OBJECT OR INTERFACE, MUST USE @INJECT TO SPECIFY INJECTION TOKEN. PARAMETER ".concat(key, " OF CLASS ").concat(ClassName, ".");
88
- }
89
- } else {
90
- // 是属性装饰器
91
- if (!injectMeta) {
92
- _this2.message = "INJECT PROPERTY REQUIRE @INJECT() DECORATOR. PROPERTY ".concat(key, " OF CLASS ").concat(ClassName, ".");
93
- } else if (injectMeta.value === Object) {
94
- _this2.message = "CAN NOT USE OBJECT AS INJECTION TOKEN. PROPERTY ".concat(key, " OF CLASS ").concat(ClassName, ".");
95
- }
96
- }
97
- return _this2;
98
- }
99
- return _createClass(InjectFailedError);
100
- }( /*#__PURE__*/_wrapNativeSuper(Error));
101
- var ProviderNotValidError = /*#__PURE__*/function (_Error3) {
102
- _inherits(ProviderNotValidError, _Error3);
103
- var _super3 = _createSuper(ProviderNotValidError);
104
- function ProviderNotValidError(provider) {
105
- var _this3;
106
- _classCallCheck(this, ProviderNotValidError);
107
- _this3 = _super3.call(this);
108
- _defineProperty(_assertThisInitialized(_this3), "name", 'PROVIDER_NOT_VALID_ERROR');
109
- _defineProperty(_assertThisInitialized(_this3), "message", _this3.name);
110
- _this3.message = "PROVIDER NOT VALID. ".concat(provider);
111
- return _this3;
112
- }
113
- return _createClass(ProviderNotValidError);
114
- }( /*#__PURE__*/_wrapNativeSuper(Error));
115
- var TokenNotFoundError = /*#__PURE__*/function (_Error4) {
116
- _inherits(TokenNotFoundError, _Error4);
117
- var _super4 = _createSuper(TokenNotFoundError);
118
- function TokenNotFoundError(token) {
119
- var _this4;
120
- _classCallCheck(this, TokenNotFoundError);
121
- _this4 = _super4.call(this);
122
- _defineProperty(_assertThisInitialized(_this4), "name", 'TOKEN_NOT_FOUND_ERROR');
123
- _defineProperty(_assertThisInitialized(_this4), "message", _this4.name);
124
- _this4.message = "TOKEN IS NOT A INJECTABLE CLASS OR SKIP OUT OF ROOT INJECTOR. YOU CAN USE @Optional DECORATOR TO IGNORE THIS ERROR IF THIS SERVICE IS OPTIONAL. ".concat(token);
125
- return _this4;
126
- }
127
- return _createClass(TokenNotFoundError);
128
- }( /*#__PURE__*/_wrapNativeSuper(Error));
129
- var ConstructorInjectMissTokenError = /*#__PURE__*/function (_Error5) {
130
- _inherits(ConstructorInjectMissTokenError, _Error5);
131
- var _super5 = _createSuper(ConstructorInjectMissTokenError);
132
- function ConstructorInjectMissTokenError(target) {
133
- var _this5;
134
- _classCallCheck(this, ConstructorInjectMissTokenError);
135
- _this5 = _super5.call(this);
136
- _defineProperty(_assertThisInitialized(_this5), "name", 'CONSTRUCTOR_INJECT_MISS_TOKEN_ERROR');
137
- _defineProperty(_assertThisInitialized(_this5), "message", _this5.name);
138
- _this5.message = "For the constructor of class ".concat(target, ", every parameter must specify a @Inject.");
139
- return _this5;
140
- }
141
- return _createClass(ConstructorInjectMissTokenError);
142
- }( /*#__PURE__*/_wrapNativeSuper(Error));
143
- var PropertyInjectMissTokenError = /*#__PURE__*/function (_Error6) {
144
- _inherits(PropertyInjectMissTokenError, _Error6);
145
- var _super6 = _createSuper(PropertyInjectMissTokenError);
146
- function PropertyInjectMissTokenError(target, targetKey) {
147
- var _this6;
148
- _classCallCheck(this, PropertyInjectMissTokenError);
149
- _this6 = _super6.call(this);
150
- _defineProperty(_assertThisInitialized(_this6), "name", 'PROPERTY_INJECT_MISS_TOKEN_ERROR');
151
- _defineProperty(_assertThisInitialized(_this6), "message", _this6.name);
152
- _this6.message = "For the property ".concat(targetKey, " of class ").concat(target, ", @Inject must specify a token.");
153
- return _this6;
154
- }
155
- return _createClass(PropertyInjectMissTokenError);
156
- }( /*#__PURE__*/_wrapNativeSuper(Error));
157
- /**
158
- * 这里记录不同的装饰器的参数的含义
159
- *
160
- * class decorator:
161
- * 只有一个参数:构造函数
162
- * property decorator:
163
- * 静态属性:构造函数, 属性名
164
- * 实例属性:原型, 属性名
165
- * parameter decorator:
166
- * 构造函数参数:构造函数, undefined, 0
167
- * 普通函数参数:原型, 方法名, 0
168
- * 静态函数参数:构造函数, 方法名, 0
169
- * method decorator:
170
- * 静态方法:构造函数, 方法名, 属性描述符
171
- * 实例方法:原型, 方法名, 属性描述符
172
- * accessor decorator:
173
- * 静态访问器:构造函数, 方法名, 属性描述符
174
- * 实例访问器:原型, 方法名, 属性描述符
175
- */
176
- /**
177
- * 创建装饰器的高阶函数
178
- * 装饰器的通用逻辑就是通过Reflect记录到全局的Map中
179
- * 所以可以抽象出一个通用逻辑,这里需要注意对Inject装饰器有特殊判断
180
- *
181
- * @param {(string | symbol)} decoratorKey 代表某个装饰器的名称
182
- * @param {*} [defaultValue] 该装饰器函数的默认参数
183
- * @return {*} 一个装饰器
184
- */
185
- function createDecorator(decoratorKey, defaultValue) {
186
- // 因为装饰器本身作为一个函数是有参数的,此处的decoratorValue就是实际使用装饰器的实参
187
- return function (decoratorValue) {
188
- // 目前的装饰器只支持类的构造函数参数装饰器和类的实例属性装饰器
189
- // target可能是构造函数或者类的原型
190
- // 如果target是构造函数,targetKey是undefined,index是参数的位置下标
191
- // 如果target是原型,targetKey是属姓名,index是undefined
192
- return function (target, targetKey, index) {
193
- // 如果index是number,那么代表是构造函数的参数的装饰器
194
- var isParameterDecorator = typeof index === 'number';
195
- // 统一把装饰器数据绑定到构造函数上,后续获取数据比较方便
196
- var Ctor = isParameterDecorator ? target : target.constructor;
197
- // 如果是构造函数的参数装饰器,取参数位置下标,否则取实例属性的属性名
198
- var key = isParameterDecorator ? index : targetKey;
199
- // 区分构造函数的参数装饰器和实例属性的装饰器
200
- // 分别记录到全局Map的不同位置,metadataKey不一样
201
- var metadataKey = isParameterDecorator ? DECORATOR_KEYS.SERVICE_INJECTED_PARAMS : DECORATOR_KEYS.SERVICE_INJECTED_PROPS;
202
- // 这里是一个大对象,对应的key是metadataKey
203
- // 所以全局Map中有两个不同的metadataKey,以及对应的数据对象
204
- // 如果是构造函数参数装饰器,这个对象中的key是参数位置下标
205
- // 如果是实例属性装饰器,这个对象中的key是属性名
206
- // 这里有一个坑,必须使用getOwnMetadata而不是getMetadata
207
- // 否则在继承的场景中会有问题
208
- var paramsOrPropertiesMetadata = Reflect.getOwnMetadata(metadataKey, Ctor) || {};
209
- // 每个参数或者实例属性都可以有多个装饰器
210
- // 所以paramsOrPropertiesMetadata这个大对象的每个key(实例属性)对应的value都是一个数组
211
- // 该数组中的每一个元素是一个对象,保存着每一个装饰器的数据
212
- var paramOrPropertyMetadata = paramsOrPropertiesMetadata[key] || [];
213
- var metadata = {
214
- // 装饰器的名称
215
- key: decoratorKey,
216
- // 装饰器的值,即装饰器函数的实参
217
- // 很多装饰器具有默认值,可以不提供实参,而是使用默认值
218
- value: decoratorValue === void 0 ? defaultValue : decoratorValue
219
- };
220
- // 当项目使用esbuild不支持emitDecoratorMetadata时
221
- // 这里检查了@Inject装饰器在实例属性中需要指定参数
222
- // 如果是构造函数理论上也需要使用@inject装饰器,并且需要指定参数
223
- // 只不过没有在这里做判断,而是在getContructorParametersMetas中判断的
224
- if (!isParameterDecorator) {
225
- // 实例属性装饰器
226
- if (decoratorKey === DECORATOR_KEYS.INJECT) {
227
- // 是@Inject装饰器
228
- if (decoratorValue === void 0) {
229
- // 装饰器没有指定参数
230
- // 所以需要通过Reflect获取默认的类型数据
231
- var metadataValue = Reflect.getMetadata(DECORATOR_KEYS.DESIGN_PROPERTY_TYPE, target, targetKey);
232
- {
233
- if (metadataValue === void 0) {
234
- throw new PropertyInjectMissTokenError(target, targetKey);
235
- }
236
- }
237
- metadata.value = metadataValue;
238
- }
239
- }
240
- }
241
- // 把当前装饰器的数据对象放到数组中
242
- paramOrPropertyMetadata.push(metadata);
243
- // 关联这个数组和对应的key
244
- paramsOrPropertiesMetadata[key] = paramOrPropertyMetadata;
245
- // 再把整个大对象放到全局Map中
246
- Reflect.defineMetadata(metadataKey, paramsOrPropertiesMetadata, Ctor);
247
- };
248
- };
249
- }
250
- // 可以使用在类构造函数的参数中和类的实例属性中
251
- var Inject = createDecorator(DECORATOR_KEYS.INJECT);
252
- // 指定只在当前injector中寻找服务
253
- var Self = createDecorator(DECORATOR_KEYS.SELF, true);
254
- // 指定跳过当前injector寻找服务
255
- var Skip = createDecorator(DECORATOR_KEYS.SKIP_SELF, true);
256
- // 指定服务是可选的,找不到服务时返回undefined,否则抛出异常
257
- // 其实应该说是默认情况下找不到服务时,会抛出异常,除非明确指定是optional的
258
- var Optional = createDecorator(DECORATOR_KEYS.OPTIONAL, true);
259
- /**
260
- * 表明服务可注入
261
- * 主要工作就是收集构造函数的参数类型信息
262
- *
263
- * @export
264
- * @return {*}
265
- */
266
- function Injectable() {
267
- return function (target) {
268
- // 标记这个类可以注入
269
- Reflect.defineMetadata(DECORATOR_KEYS.INJECTABLE, true, target);
270
- return target;
271
- };
272
- }
273
- function has(obj, key) {
274
- return obj && Object.prototype.hasOwnProperty.call(obj, key);
275
- }
276
- function merge(target, source) {
277
- for (var key in source) {
278
- if (has(source, key)) {
279
- target[key] = source[key];
280
- }
281
- }
282
- return target;
283
- }
284
- function isInjectableToken(token) {
285
- return typeof token === 'function' && Reflect.getMetadata(DECORATOR_KEYS.INJECTABLE, token);
286
- }
287
- function forwardRef(fn) {
288
- fn.__forward_ref__ = forwardRef;
289
- return fn;
290
- }
291
- function isForwardRef(fn) {
292
- return typeof fn === 'function' && has(fn, '__forward_ref__') && fn.__forward_ref__ === forwardRef;
293
- }
294
- function resolveForwardRef(type) {
295
- return isForwardRef(type) ? type() : type;
296
- }
297
- var NOOP = function NOOP(n) {
298
- return n;
299
- };
300
- // 第一步:准备构造函数的依赖对象
301
- // 第二步:通过构造函数来获取服务的实例对象
302
- // 第三步:补充@Inject注入的实例属性
303
- // 第四步:执行constructed方法
304
- var Injector = /*#__PURE__*/function () {
305
- function Injector() {
306
- var providers = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
307
- var parent = arguments.length > 1 ? arguments[1] : undefined;
308
- var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
309
- _classCallCheck(this, Injector);
310
- _defineProperty(this, "parent", void 0);
311
- _defineProperty(this, "providerMap", new Map());
312
- // <token, provider>
313
- _defineProperty(this, "beforeCacheHook", void 0);
314
- _defineProperty(this, "mergePropertyHook", void 0);
315
- // 引用父级Injector
316
- this.parent = parent;
317
- // 在把服务实例放到缓存中之前,可以调用这个钩子让服务响应化
318
- this.beforeCacheHook = options.beforeCacheHook || NOOP;
319
- // 在注入实例属性时,需要把属性merge到服务实例对象上,合并过程需要保持响应式
320
- this.mergePropertyHook = options.mergePropertyHook || merge;
321
- this.addProviders(providers);
322
- }
323
- /**
324
- * 如果没有parent则是root injector
325
- */
326
- _createClass(Injector, [{
327
- key: "isRootInjector",
328
- value: function isRootInjector() {
329
- return !this.parent;
330
- }
331
- /**
332
- * 如果没有指定当前token是可选的,则抛出异常
333
- * @param token
334
- * @param options
335
- */
336
- }, {
337
- key: "checkTokenNotFoundError",
338
- value: function checkTokenNotFoundError(token, options) {
339
- if (!options.optional) {
340
- throw new TokenNotFoundError(token);
341
- }
342
- }
343
- }, {
344
- key: "get",
345
- value: function get(token) {
346
- var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
347
- if (options.skip) {
348
- // 优先判断skip,是因为可以实现三种不同的组合
349
- // 1. 只有skip
350
- // 1. 只有self
351
- // 1. 同时有skip和self
352
- if (this.parent) {
353
- // 最多只能跳过一次,虽然也可以将skip设为number类型,从而可以控制跳过的次数,但是没有必要
354
- return this.parent.get(token, _objectSpread(_objectSpread({}, options), {}, {
355
- skip: false
356
- }));
357
- } else {
358
- this.checkTokenNotFoundError(token, options);
359
- }
360
- } else if (options.self) {
361
- if (this.providerMap.has(token)) {
362
- var provider = this.providerMap.get(token);
363
- return this.getServiceByProvider(provider, options);
364
- } else if (this.isRootInjector() && isInjectableToken(token)) {
365
- // 这里的场景是 useRootService(Token, {self: true})
366
- // 应该不会有人这样写代码,这里只是为了代码逻辑的完整性
367
- // 正常业务代码只需要写 useRootService(Token) 即可
368
- var _provider = this.getProviderByToken(token);
369
- return this.getServiceByProvider(_provider, options);
370
- } else {
371
- this.checkTokenNotFoundError(token, options);
372
- }
373
- } else if (this.providerMap.has(token)) {
374
- var _provider2 = this.providerMap.get(token);
375
- return this.getServiceByProvider(_provider2, options);
376
- } else if (this.parent) {
377
- return this.parent.get(token, options);
378
- } else if (isInjectableToken(token)) {
379
- // 这里代表是root injector
380
- // 这里的意思代表所有Injectable Class都可以自动在root injector中实例化
381
- // 不再需要手动调用declareRootProviders这个方法
382
- // 当然declareRootProviders这个方法有其他使用场景,比如不是以Class作为token
383
- var _provider3 = this.getProviderByToken(token);
384
- return this.getServiceByProvider(_provider3, options);
385
- } else {
386
- this.checkTokenNotFoundError(token, options);
387
- }
388
- }
389
- /**
390
- * 如果token对应的provider不存在
391
- * 那么就创建一个
392
- * 目前来看这个方法只是针对root injector使用,属于兜底策略
393
- * 调用该方法之前需要保证token对应的provider已经存在或者token本身是一个可注入的类
394
- *
395
- * @param {*} token
396
- * @return {*}
397
- * @memberof Injector
398
- */
399
- }, {
400
- key: "getProviderByToken",
401
- value: function getProviderByToken(token) {
402
- if (!this.providerMap.has(token)) {
403
- this.addProvider(token);
404
- }
405
- return this.providerMap.get(token);
406
- }
407
- /**
408
- * 通过provider直接获取service实例
409
- *
410
- * @param {*} provider
411
- * @param {*} options
412
- * @return {*}
413
- * @memberof Injector
414
- */
415
- }, {
416
- key: "getServiceByProvider",
417
- value: function getServiceByProvider(provider, options) {
418
- if (provider.status === SERVICE_STATUS.INITING) {
419
- throw new CircularDependencyError(provider, options);
420
- }
421
- if ('useCacheValue' in provider) {
422
- return provider.useCacheValue;
423
- } else if ('useValue' in provider) {
424
- return this.getServiceUseValueWithProvider(provider);
425
- } else if (provider.useClass) {
426
- return this.getServiceUseClassWithProvider(provider, options);
427
- } else if (provider.useExisting) {
428
- return this.getServiceUseExistingWithProvider(provider, options);
429
- } else if (provider.useFactory) {
430
- return this.getServiceUseFactoryWithProvider(provider, options);
431
- } else {
432
- throw new ProviderNotValidError(provider);
433
- }
434
- }
435
- /**
436
- * 通过useValue获取服务实例
437
- *
438
- * @param {*} provider
439
- * @return {*}
440
- * @memberof Injector
441
- */
442
- }, {
443
- key: "getServiceUseValueWithProvider",
444
- value: function getServiceUseValueWithProvider(provider) {
445
- var cacheValue = this.beforeCacheHook(provider.useValue);
446
- provider.useCacheValue = cacheValue;
447
- return cacheValue;
448
- }
449
- /**
450
- * 通过useClass获取服务实例
451
- *
452
- * @param {*} provider
453
- * @param {*} options
454
- * @return {*}
455
- * @memberof Injector
456
- */
457
- }, {
458
- key: "getServiceUseClassWithProvider",
459
- value: function getServiceUseClassWithProvider(provider, options) {
460
- provider.status = SERVICE_STATUS.INITING;
461
- provider.parent = options.provider;
462
- var ClassName = provider.useClass;
463
- var params = this.getContructorParameters(ClassName, provider);
464
- var cacheValue = this.beforeCacheHook(_construct(ClassName, _toConsumableArray(params)));
465
- // 实例化成功,此时不会再有死循环问题
466
- provider.useCacheValue = cacheValue;
467
- provider.status = SERVICE_STATUS.CONSTRUCTED;
468
- var properties = this.getInjectProperties(ClassName, provider);
469
- this.mergePropertyHook(cacheValue, properties);
470
- provider.parent = void 0;
471
- provider.status = SERVICE_STATUS.MERGED;
472
- return cacheValue;
473
- }
474
- /**
475
- * 通过useExisting获取服务实例
476
- *
477
- * @param {*} provider
478
- * @param {*} options
479
- * @return {*}
480
- * @memberof Injector
481
- */
482
- }, {
483
- key: "getServiceUseExistingWithProvider",
484
- value: function getServiceUseExistingWithProvider(provider, options) {
485
- provider.status = SERVICE_STATUS.INITING;
486
- provider.parent = options.provider;
487
- var cacheValue = this.get(provider.useExisting, _objectSpread(_objectSpread({}, options), {}, {
488
- provider: provider
489
- }));
490
- provider.useCacheValue = cacheValue;
491
- provider.parent = void 0;
492
- provider.status = SERVICE_STATUS.CONSTRUCTED;
493
- return cacheValue;
494
- }
495
- /**
496
- * 通过useFactory获取服务实例
497
- *
498
- * @param {*} provider
499
- * @param {*} options
500
- * @return {*}
501
- * @memberof Injector
502
- */
503
- }, {
504
- key: "getServiceUseFactoryWithProvider",
505
- value: function getServiceUseFactoryWithProvider(provider, options) {
506
- var _this7 = this;
507
- provider.status = SERVICE_STATUS.INITING;
508
- provider.parent = options.provider;
509
- var deps = provider.deps || [];
510
- var args = deps.map(function (dep) {
511
- return _this7.get(dep, {
512
- provider: provider
513
- });
514
- });
515
- var serviceValue = provider.useFactory.apply(provider, _toConsumableArray(args));
516
- var cacheValue = this.beforeCacheHook(serviceValue);
517
- provider.useCacheValue = cacheValue;
518
- provider.parent = void 0;
519
- provider.status = SERVICE_STATUS.CONSTRUCTED;
520
- return cacheValue;
521
- }
522
- /**
523
- * 获取构造函数的参数-返回数组
524
- *
525
- * @param {*} ClassName
526
- * @param {*} provider
527
- * @return {*}
528
- * @memberof Injector
529
- */
530
- }, {
531
- key: "getContructorParameters",
532
- value: function getContructorParameters(ClassName, provider) {
533
- var _this8 = this;
534
- var params = this.getContructorParametersMetas(ClassName);
535
- var result = params.map(function (meta) {
536
- return _this8.get(meta.provide, _objectSpread(_objectSpread({}, meta.value), {}, {
537
- provider: provider
538
- }));
539
- });
540
- return result;
541
- }
542
- /**
543
- * 获取构造函数的参数的装饰器元数据
544
- *
545
- * @param {*} ClassName
546
- * @return {*}
547
- * @memberof Injector
548
- */
549
- }, {
550
- key: "getContructorParametersMetas",
551
- value: function getContructorParametersMetas(ClassName) {
552
- // 构造函数的参数的类型数据-原始数据-是一个数组
553
- var params = Reflect.getMetadata(DECORATOR_KEYS.DESIGN_PARAM_TYPES, ClassName);
554
- // 构造函数的参数的类型数据-通过@Inject等装饰器实现-是一个对象-key是数字-对应第几个参数的类型数据
555
- var propertiesMetadatas = Reflect.getMetadata(DECORATOR_KEYS.SERVICE_INJECTED_PARAMS, ClassName) || {};
556
- // 获取当前构造函数的形参个数
557
- var classParamsLength = ClassName.length;
558
- {
559
- if (!params) {
560
- // params不存在说明当前环境不支持emitDecoratorMetadata
561
- var propertiesMetadatasLength = Object.keys(propertiesMetadatas).length;
562
- if (propertiesMetadatasLength < classParamsLength) {
563
- throw new ConstructorInjectMissTokenError(ClassName);
564
- }
565
- }
566
- }
567
- // 如果params不存在需要创建符合形参数量的数组
568
- var newParams = params || _toConsumableArray(Array(classParamsLength));
569
- return newParams.map(function (paramType, index) {
570
- // 查找当前index对应的参数有没有使用装饰器
571
- var propertyMetadatas = propertiesMetadatas[index] || [];
572
- // 查找装饰器列表中有没有@Inject装饰器的数据
573
- var injectMeta = propertyMetadatas.find(function (meta) {
574
- return meta.key === DECORATOR_KEYS.INJECT;
575
- });
576
- if (injectMeta && injectMeta.value === Object || !injectMeta && paramType === Object) {
577
- // 构造函数的参数可以不使用@Inject,但是一定不能是interface
578
- throw new InjectFailedError(injectMeta, ClassName, index, paramType);
579
- }
580
- // 把装饰器列表收集为对象,并且排除掉@Inject
581
- var options = propertyMetadatas.reduce(function (acc, meta) {
582
- if (meta.key !== DECORATOR_KEYS.INJECT) {
583
- acc[meta.key] = meta.value;
584
- }
585
- return acc;
586
- }, {});
587
- return {
588
- key: index,
589
- provide: resolveForwardRef(injectMeta && injectMeta.value) || paramType,
590
- value: options
591
- };
592
- });
593
- }
594
- /**
595
- * 获取注入的实例属性-返回对象
596
- *
597
- * @param {*} ClassName
598
- * @param {*} provider
599
- * @return {*}
600
- * @memberof Injector
601
- */
602
- }, {
603
- key: "getInjectProperties",
604
- value: function getInjectProperties(ClassName, provider) {
605
- var _this9 = this;
606
- var metas = this.getInjectPropertiesMetas(ClassName);
607
- var properties = {};
608
- metas.forEach(function (meta) {
609
- var _meta$value;
610
- var property = _this9.get(meta.provide, _objectSpread(_objectSpread({}, meta.value), {}, {
611
- provider: provider
612
- }));
613
- if (!(property === void 0 && (_meta$value = meta.value) !== null && _meta$value !== void 0 && _meta$value.optional)) {
614
- properties[meta.key] = property;
615
- }
616
- });
617
- return properties;
618
- }
619
- /**
620
- * 获取注入属性的装饰器数据
621
- *
622
- * @param {*} ClassName
623
- * @return {*}
624
- * @memberof Injector
625
- */
626
- }, {
627
- key: "getInjectPropertiesMetas",
628
- value: function getInjectPropertiesMetas(ClassName) {
629
- // 获取注入属性的metas-类型是Recors<string, Array>
630
- var propertiesMetadatas = Reflect.getMetadata(DECORATOR_KEYS.SERVICE_INJECTED_PROPS, ClassName) || {};
631
- var propertiesMetas = [];
632
- for (var key in propertiesMetadatas) {
633
- if (has(propertiesMetadatas, key)) {
634
- // 当前key属性对应的所有的装饰器
635
- var propertyMetadatas = propertiesMetadatas[key];
636
- // 当前key属性对应的@Inject装饰器的数据
637
- var injectMeta = propertyMetadatas.find(function (meta) {
638
- return meta.key === DECORATOR_KEYS.INJECT;
639
- });
640
- if (!injectMeta || injectMeta.value === Object) {
641
- // 属性一定要手动指定@Inject
642
- throw new InjectFailedError(injectMeta, ClassName, key);
643
- }
644
- var options = propertyMetadatas.reduce(function (acc, meta) {
645
- if (meta.key !== DECORATOR_KEYS.INJECT) {
646
- acc[meta.key] = meta.value;
647
- }
648
- return acc;
649
- }, {});
650
- propertiesMetas.push({
651
- key: key,
652
- provide: resolveForwardRef(injectMeta.value),
653
- value: options
654
- });
655
- }
656
- }
657
- return propertiesMetas;
658
- }
659
- /**
660
- * 把providers数组转换成map,避免后续的遍历
661
- *
662
- * @param {any[]} providers
663
- * @memberof Injector
664
- */
665
- }, {
666
- key: "addProviders",
667
- value: function addProviders(providers) {
668
- var _this10 = this;
669
- providers.forEach(function (provider) {
670
- _this10.addProvider(provider);
671
- });
672
- }
673
- /**
674
- * 添加新的provider
675
- *
676
- * @param {*} provider
677
- * @memberof Injector
678
- */
679
- }, {
680
- key: "addProvider",
681
- value: function addProvider(provider) {
682
- if (provider.provide) {
683
- this.providerMap.set(provider.provide, provider);
684
- } else {
685
- this.providerMap.set(provider, {
686
- provide: provider,
687
- useClass: provider
688
- });
689
- }
690
- }
691
- /**
692
- * 释放当前Injector中的所有服务实例
693
- *
694
- * @memberof Injector
695
- */
696
- }, {
697
- key: "dispose",
698
- value: function dispose() {
699
- this.providerMap.forEach(function (value) {
700
- if (value && value.useCacheValue && value.useCacheValue.dispose) {
701
- try {
702
- value.useCacheValue.dispose();
703
- } catch (error) {
704
- console.error(error);
705
- }
706
- }
707
- });
708
- this.providerMap = null;
709
- this.parent = null;
710
- }
711
- }]);
712
- return Injector;
713
- }();
714
- exports.CircularDependencyError = CircularDependencyError;
715
- exports.ConstructorInjectMissTokenError = ConstructorInjectMissTokenError;
716
- exports.DECORATOR_KEYS = DECORATOR_KEYS;
717
- exports.Inject = Inject;
718
- exports.InjectFailedError = InjectFailedError;
719
- exports.Injectable = Injectable;
720
- exports.Injector = Injector;
721
- exports.Optional = Optional;
722
- exports.PropertyInjectMissTokenError = PropertyInjectMissTokenError;
723
- exports.ProviderNotValidError = ProviderNotValidError;
724
- exports.SERVICE_STATUS = SERVICE_STATUS;
725
- exports.Self = Self;
726
- exports.Skip = Skip;
727
- exports.TokenNotFoundError = TokenNotFoundError;
728
- exports.createDecorator = createDecorator;
729
- exports.forwardRef = forwardRef;
730
- exports.has = has;
731
- exports.isForwardRef = isForwardRef;
732
- exports.isInjectableToken = isInjectableToken;
733
- exports.merge = merge;
734
- exports.resolveForwardRef = resolveForwardRef;
735
- //# sourceMappingURL=index.cjs.runtime.js.map