資訊專欄INFORMATION COLUMN
摘要：項目地址項目主頁基于和注解的輕量級容器，提供了依賴注入面向切面編程及異常處理等功能。可在任意工程中引入，是一個框架無關的容器。模塊不依賴于任何框架，并與現有框架庫類等保持兼容。
Rockerjs Core
項目地址
項目主頁
基于 TypeScript 和注解的輕量級IoC容器，提供了依賴注入、面向切面編程及異常處理等功能。Rockerjs Core可在任意工程中引入，是一個框架無關的IoC容器。
@rockerjs/core模塊不依賴于任何框架，并與現有框架、庫、類等保持兼容。通過DI(Dependency Injection）實現代碼解耦和依賴解耦，在構建復雜應用時保證可擴展性與靈活性；同時提供二維編程的能力，基于注解可在各個連接點（Advice）進行非核心業務的操作，減少代碼冗余；最后，它提供一種基于注解配置的簡易異常處理機制 -- Clamp機制，通過特定規則匹配異常處理程序實現處理。
一、快速上手安裝
npm install @rockerjs/core
@rockerjs/core最佳實踐需要結合TypeScript的裝飾器一起使用（也可使用接口），因此需要在項目根目錄添加 tsconfig.json 文件，并配置編譯選項 “experimentalDecorators”和“emitDecoratorMetadata”為 true
示例 1
import { Container, Inject } from "@rockerjs/core";
class User {
id: string = "testId";
name: string = "testName";
}
class UserService {
getUser(_id: string): User {
return new User();
}
}
@Inject
class ControlDefault {
@Inject
userService: UserService;
test() {
let user: User = this.userService.getUser("test");
console.log(user);
}
}
@Inject("controllor-with-args", new Date())
class ControlDefaultWithArgs {
name: string;
time: Date;
constructor(name: string, time: Date) {
this.name = name;
this.time = time;
}
@Inject
userService: UserService;
test() {
let user: User = this.userService.getUser("test");
console.log(user, this.name, this.time);
}
}
@Inject("controllor1", "util", new Date())
class Control {
name: string;
time: Date;
constructor(name: string, time: Date) {
this.name = name;
this.time = time;
}
@Inject
userService: UserService;
test() {
let user: User = this.userService.getUser("test");
console.log(user, this.name, this.time);
}
}
// 通過getObject接口從容器中獲取實例，參數為“單例的名稱”（默認名稱為類名首字母小寫）
Container.getObject("controlDefault").test();
// 通過getObject接口從容器中獲取實例，此例中并未提供實例名
Container.getObject("controlDefaultWithArgs").test();
// 通過getObject接口從容器中獲取實例，此例中提供了3個參數，@rockerjs/core 認為第一個參數為實例名，剩下的參數則用于實例化
Container.getObject("controllor1").test();
示例 2 ： RPC
import {Container, Inject} from "@rockerjs/core";
//PRC Demo實現
let RPC = {
config: function (cfg: { serviceUrl: string, interfaces: Function[] }) {
if (cfg.interfaces) {
cfg.interfaces.forEach((type: FunctionConstructor) => {
if (type.prototype) {
let newObj = {}, proto = type.prototype;
let nms = Object.getOwnPropertyNames(proto);
if (nms) {
nms.forEach((nm) => {
if (nm != "constructor" && typeof(proto[nm]) === "function") {
newObj[nm] = function () {
//{nm:方法名,arguments:參數表},改為調用遠程請求過程
return arguments[0];//test return
}
}
})
}
Container.provides([type, () => {
return newObj;
}])
}
})
}
}
}
//--DEMO--------------------------------------------------------
//1. 接口聲明（注意,此處只能使用Concrete class）
class Product {
getById(id: string): string {
return null;
}
}
//2. 應用RPC Framework
RPC.config({
serviceUrl: null,
interfaces: [Product]//提供接口描述，在RPC中構建factory
})
//3. Service class
@Inject
class Service {
@Inject
product: Product;
test() {
let id: string = "tid";
let rst = this.product.getById(id);
console.log(rst);
}
}
//4.測試
Container.getObject("service").test();
二、依賴注入與容器
依賴注入 @Inject
提供了注解 @Inject 來實現依賴的注入，當我們有如下 GetDubboData 類時
class GetDubboData {
p0: number;
constructor(p0: number, p1: string) {
this.p0 = p0;
}
}
我們可以通過以下方式實例化這個類，同時傳入指定的參數
直接傳遞構造函數的參數
class SomeControl {
@Inject(1, "aaa")
private dubbo: GetDubboData
}
給出構造函數的工廠函數
class SomeControl {
@Inject(function () {
return [1, "aaa"]
})
private dubbo: GetDubboData
}
無構造函數或參數為空
class SomeControl {
@Inject
private dubbo: GetDubboData
}
操作類實例化容器
默認的實例化方法可以滿足開發者的大部分需求，Rockerjs Core 提供了 provides 方法自定義實例化工廠，同時提供了獲取類和類實例化函數映射表的方法。
注冊、修改類的實例化方法
直接傳入類或工廠函數
// 形式一：形如 Container.provides(class extends UserService{})
Container.provides(
class extends UserService {
getUser(id: string): User {
console.log(1);
return new User();
}
}
);
傳入類及類的工廠函數
// 形式二：形如 Container.provides([UserService,FactoryFunction])
Container.provides([
UserService,
() => {
return new class extends UserService {
getUser(id: string): User {
console.log(2);
return new User();
}
}();
}
]);
獲取實例化方法注冊表
返回一個構造函數-工廠方法映射表, 結構如下
