
废除JS
JavaScript & Node.js 应用软件由TypeScript提供动力的强大的轻量级反转控制容器.
关于
倒置JS是TypeScript和JavaScript应用的轻量级倒置控制(IoC)容器. 一个IoC容器使用分级构造器来识别并注入其依赖性. VersifyJS有一个友好的API,并鼓励使用最佳OOP和IoC做法.
动机
JavaScript 现在支持面向对象(OO)的编程,具有基于类的继承. 这些特征是伟大的,但事实是,它们也是 危险。 。 。 .
我们需要一个良好的OO设计(安静, (中文(简体) ), 复合再使用保护自己免受这些威胁。 问题是OO设计很困难,这正是我们创建InversifyJS的原因.
VersifyJS是帮助JavaScript开发者以良好的OO设计写出代码的工具.
哲学
已经制定了四个主要目标:
-
允许JavaScript开发者编写符合SOLID原则的代码.
-
便利和鼓励遵守《业务业务方案》和《信息通报》的最佳做法.
-
尽可能少增加运行时间 .
-
提供a 最新发展经验。 。 。 .
证词
"干得不错! 我在为JavaScript和TypeScript创建DI框架方面拍了几张照片,但缺乏RTTI确实阻碍了事情的发展. ES7元数据让我们成为其中的一部分(如您所发现的). 继续伟大的工作!"
米歇尔·威斯特斯特拉特 - 作者: 移动X
依赖性注射,如 InverfyJS 效果良好
一些使用逆JS的公司
* 安装
您可以使用您首选的软件包管理器获取最新版本和类型定义 :
> npm install inversify reflect-metadata --save
> yarn add inversify reflect-metadata
> pnpm add inversify reflect-metadata
❕闪电! 如果您想要使用更安全的反射元数据类型, 请尝试
@abraham/reflection
VersifyJS类型定义包含在versify npm包中.
: 警告: 重要的东西! 校正JS 需要 TypeScript QQ 4.4 和
experimentalDecorators, (中文(简体) ),emitDecoratorMetadata, (中文(简体) ),types财务报告和审定财务报表lib编辑选项tsconfig.json文档.
{
"compilerOptions": {
"target": "es5",
"lib": ["es6"],
"types": ["reflect-metadata"],
"module": "commonjs",
"moduleResolution": "node",
"experimentalDecorators": true,
"emitDecoratorMetadata": true
}
}
VersifyJS需要现代JavaScript引擎,支持:
如果你的环境不支持其中之一,你将需要导入 shim 或多填充.
: 警告: 这个
reflect-metadata整个应用程序只导入一次多填充 因为反射对象的意思是是一个全局单子. 详情请查看 这里。 。 。 .
看看这个 环境支持和多填充 在维基百科和 基本实例 学习更多.
基本情况
让我们看看用TypeScript来验证JS的基本用法和API:
步骤1: 宣布您的界面和类型
我们的目标是写出符合 依赖倒置原则。 。 。 . 这意味着我们应该"依赖于抽象,而不依赖于抽象". 我们先宣布一些接口(缩写).
// file interfaces.ts
export interface Warrior {
fight(): string;
sneak(): string;
}
export interface Weapon {
hit(): string;
}
export interface ThrowableWeapon {
throw(): string;
}
VersifyJS需要在运行时使用该类型作为标识符. 我们使用符号作为标识符,但您也可以使用类或字符串字节.
请确定将这个排行榜放入一个相册中(见bug #1455)
// file types.ts
const TYPES = {
Warrior: Symbol.for("Warrior"),
Weapon: Symbol.for("Weapon"),
ThrowableWeapon: Symbol.for("ThrowableWeapon")
};
export { TYPES };
说明:建议使用符号,但InversifyJS也支持类和字符串的用法(请参见特性部分以多学习).
步骤2:使用 @injectable 打开 @inject 装饰器
让我们继续宣布一些课程(合并). 这些课程是执行我们刚刚宣布的界面。 所有课程都必须加上 @injectable 装饰师.
当类依赖接口时,我们也需要使用 @inject 用于定义运行时可用的接口标识符的装饰器 。 这样的话,我们就用符号 Symbol.for("Weapon") 财务报告和审定财务报表 Symbol.for("ThrowableWeapon") 作为运行时间标识符.
// file entities.ts
import { injectable, inject } from "inversify";
import "reflect-metadata";
import { Weapon, ThrowableWeapon, Warrior } from "./interfaces";
import { TYPES } from "./types";
@injectable()
class Katana implements Weapon {
public hit() {
return "cut!";
}
}
@injectable()
class Shuriken implements ThrowableWeapon {
public throw() {
return "hit!";
}
}
@injectable()
class Ninja implements Warrior {
private _katana: Weapon;
private _shuriken: ThrowableWeapon;
public constructor(
@inject(TYPES.Weapon) katana: Weapon,
@inject(TYPES.ThrowableWeapon) shuriken: ThrowableWeapon
) {
this._katana = katana;
this._shuriken = shuriken;
}
public fight() { return this._katana.hit(); }
public sneak() { return this._shuriken.throw(); }
}
export { Ninja, Katana, Shuriken };
如果你更喜欢的话,你可以使用属性注射而不是构造器注射,这样你就不必声明类构造器:
@injectable()
class Ninja implements Warrior {
@inject(TYPES.Weapon) private _katana: Weapon;
@inject(TYPES.ThrowableWeapon) private _shuriken: ThrowableWeapon;
public fight() { return this._katana.hit(); }
public sneak() { return this._shuriken.throw(); }
}
第3步:创建和配置容器
我们建议在一份名为 inversify.config.ts。这是唯一一个有 连接的地方.
其余的应用中,您的课程应该没有其他课程的参考.
// file inversify.config.ts
import { Container } from "inversify";
import { TYPES } from "./types";
import { Warrior, Weapon, ThrowableWeapon } from "./interfaces";
import { Ninja, Katana, Shuriken } from "./entities";
const myContainer = new Container();
myContainer.bind<Warrior>(TYPES.Warrior).to(Ninja);
myContainer.bind<Weapon>(TYPES.Weapon).to(Katana);
myContainer.bind<ThrowableWeapon>(TYPES.ThrowableWeapon).to(Shuriken);
export { myContainer };
步骤4:解决依赖关系
你可以用这种方法 get<T> 从 Container 类解决依赖.
记住,你应该只这样做 在你的 组成根
以避开 服务定位器反平板。 。 。 .
import { myContainer } from "./inversify.config";
import { TYPES } from "./types";
import { Warrior } from "./interfaces";
const ninja = myContainer.get<Warrior>(TYPES.Warrior);
expect(ninja.fight()).eql("cut!"); // true
expect(ninja.sneak()).eql("hit!"); // true
我们可以看到 Katana 财务报告和审定财务报表 Shuriken 成功解决并注入 Ninja。 。 。 .
VersifyJS支持ES5和ES6,可以不用TypeScript工作. 头去 JavaScript 示例 学习更多!
* 逆JS特征和API
让我们来看看"VersifyJS"的特征!
- 课程支持
- 支持符号
- 集装箱 API
- 宣布容器模块
- 集装箱快照
- 控制依赖范围
- 声明可选依赖性
- 注入常数或动态值
- 注入类构造器
- 注入工厂
- 汽车厂
- 自动命名工厂
- 注入提供者(同步工厂)
- 激活处理器
- 解除处理器
- 后构造装饰器
- 中间软件
- 多注入
- 标记绑定
- 创建您的标签装饰器
- 命名装订
- 默认目标
- 支持分级的DI系统
- 背景绑定和 @ targetName
- 财产注入
- 循环依赖关系
- 继承
请参看 维基百科 其他细节.
生态系统
为了提供最新发展经验,我们还致力于:
请参看 生态系统维基页面 学习更多.
支助
如果你有经验 我们很乐意帮忙 您可以使用 问题页面 或 聊天。也可以在 堆叠溢出 使用 inversifyjs 标签.
如果你想与开发团队分享你的想法或加入我们,就能够使用 正式邮件列表您可以检查 维基百科 以学习更多关于逆JS内部.
鸣谢
谢谢大家 捐助者,所有使用 InversifyJS 的开发者,以及所有通过在线分享 InversifyJS 内容来帮助我们传播这个词的人. 没有你们的反馈和支持,这个项目是不可能实现的.
许可证
麻省理工学院许可证
版权: 2015-2017 雷莫·扬森
特此准许任何人免费获得本软件和相关文件文件("软件")的副本,不受限制地在软件中进行交易,包括不受限制地享有软件的使用、复制、修改、合并、出版、分发、分版和(或)销售的权利,并允许软件获得者这样做,但须符合下列条件: 1
上述版权通知和许可通知应载入软件的所有副本或大部分.
软件是提供的"AS IS", 没有任何种类的恐惧, 释放或被卷入, 包括但不限制在 危机的保障, 证明一个特定的目的和无关.
任何索赔、索赔或其他负债,无论是合同、交易或其他行为,产生于、产生于或涉及软件或软件的使用或其他交易的行为,都不得作为担保.

