أول DI: أول DI على واجهات تطبيقات الطباعة النصية

ما هو DI؟

• استبدل تطبيقات المنطق بشكل فردي لكل منصة. على سبيل المثال ، في المتصفح ، اعرض الإشعارات من خلال واجهة برمجة تطبيقات الإشعارات ، وعند تجميع تطبيقات الجوال ، استبدلها بإشعارات من خلال واجهة برمجة تطبيقات النظام الأساسي للجوال.
• استبدال تنفيذ المنطق في بيئات مختلفة. على سبيل المثال ، يمكن استخدام بوابة الدفع أو نظام توزيع الإشعارات الذي يتعذر الوصول إليه من الجهاز المحلي للمطور في دائرة المنتج. وبالتالي ، بدلاً من المدفوعات الحقيقية أو البريد في مرحلة التطوير ، يمكن استبدال المنطق بكعب.
• استبدل مصدر البيانات. على سبيل المثال ، بدلاً من طلب حقيقي إلى الخادم ، قم بحذف البيانات المعدة مسبقًا لاختبار منطق الأعمال أو التخطيط للامتثال للتخطيطات.
• والعديد من الاستخدامات المفيدة ، ولكن ليس عن ذلك الآن ...

التحضير للاستخدام

1. قم بتوصيل ملف بيانات التعريف العكسي .
2. في ملف tsconfig ، قم بتمكين emitDecoratorMetadata وخيارات التجريبية التجريبية. الأول يسمح لك بتوليد التفكير ، والثاني يشمل دعم الديكور
3. قم بإنشاء أي ديكور فارغ ، على سبيل المثال const reflection = (..._ params: Object []): void => {} أو استخدم الديكور الجاهز من المكتبة.

استخدام بسيط

import { autowired, override, reflection } from "first-di";

@reflection // typescript  
class ProdRepository { //   

    public async getData(): Promise<string> {
        return await Promise.resolve("production");
    }

}

@reflection
class MockRepository { //       

    public async getData(): Promise<string> {
        return await Promise.resolve("mock");
    }

}

@reflection
class ProdService {

    constructor(private readonly prodRepository: ProdRepository) { }

    public async getData(): Promise<string> {
        return await this.prodRepository.getData();
    }

}

class ProdController { //   React, Preact, Mithril  .

    @autowired() //  
    private readonly prodService!: ProdService;

    // constructor  ,   React, Preact, Mithril
    //      

    public async getData(): Promise<string> {
        return await this.prodService.getData();
    }

}

if (process.env.NODE_ENV === "test") { //    
    override(ProdRepository, MockRepository);
}

const controllerInstance = new ProdController(); //   
const data = await controllerInstance.getData();

if (process.env.NODE_ENV === "test") {
    assert.strictEqual(data, "mock"); //  
} else {
    assert.strictEqual(data, "production"); //  
}

//  1 
import { DI, AutowiredLifetimes } from "first-di";
DI.defaultOptions.lifeTime = AutowiredLifetimes.PER_INSTANCE;

//  2  
import { autowired, AutowiredLifetimes } from "first-di";
@autowired({lifeTime: AutowiredLifetimes.PER_INSTANCE})
private readonly prodService!: ProdService;

//  3  
import { override, AutowiredLifetimes } from "first-di";
override(ProdRepository, MockRepository, {lifeTime: AutowiredLifetimes.PER_INSTANCE});

الاستخدام المهني

import { autowired, override, reflection } from "first-di";

abstract class AbstractRepository { //    

    abstract getData(): Promise<string>;

}

@reflection
class ProdRepository implements AbstractRepository {

    public async getData(): Promise<string> {
        return await Promise.resolve("production");
    }

}

@reflection
class MockRepository implements AbstractRepository {

    public async getData(): Promise<string> {
        return await Promise.resolve("mock");
    }

}

abstract class AbstractService { //    

    abstract getData(): Promise<string>;

}

@reflection
class ProdService implements AbstractService {

    private readonly prodRepository: AbstractRepository;

    constructor(prodRepository: AbstractRepository) {
        this.prodRepository = prodRepository;
    }

    public async getData(): Promise<string> {
        return await this.prodRepository.getData();
    }

}

class ProdController { //   React, Preact, Mithril  .

    @autowired()
    private readonly prodService!: AbstractService;

    // constructor  ,   React, Preact, Mithril
    //      

    public async getData(): Promise<string> {
        return await this.prodService.getData();
    }

}

override(AbstractService, ProdService);

if (process.env.NODE_ENV === "test") {
    override(AbstractRepository, MockRepository);
} else {
    override(AbstractRepository, ProdRepository);
}

const controllerInstance = new ProdController();
const data = await controllerInstance.getData();

if (process.env.NODE_ENV === "test") {
    assert.strictEqual(data, "mock");
} else {
    assert.strictEqual(data, "production");
}

ميزات أخرى

import { DI } from "first-di";
import { ProductionService } from "../services/ProductionService";

const scopeA = new DI();
const scopeB = new DI();

export class Controller {

    @scopeA.autowired()
    private readonly serviceScopeA!: ProductionService;

    @scopeB.autowired()
    private readonly serviceScopeB!: ProductionService;

    // constructor  ,   React, Preact, Mithril
    //      

    public async getDataScopeA(): Promise<string> {
        return await this.serviceScopeA.getData();
    }

    public async getDataScopeB(): Promise<string> {
        return await this.serviceScopeB.getData();
    }

}

import { DI } from "first-di";

class MyDI extends DI {
    // extended method
    public getAllSingletons(): IterableIterator<object> {
        return this.singletonsList.values();
    }
}

لماذا كتابتك الخاصة ولا تستخدم؟

احب؟