👨🏻‍⚖️ 🤟🏻 🤽🏾 टाइपस्क्रिप्ट और इनवर्सीफ्यूज के साथ Node.js में SOLID और स्तरित वास्तुकला को लागू करना 🙆🏻 👃🏼 🈺

नमस्कार, हेब्र! मैं आपके ध्यान में रेमो एच। जैनसेन द्वारा टाइपोडस्क्रिप्ट और इनवर्सीफिज के साथ Node.js में SOLID और प्याज वास्तुकला को लागू करने वाले लेख का एक ध्यान आकर्षित कर रहा हूं ।

इस लेख में, हम प्याज के रूप में ज्ञात वास्तुकला को देखेंगे। स्तरित वास्तुकला - आवेदन वास्तुकला के निर्माण के लिए एक दृष्टिकोण है कि के सिद्धांतों का पालन करता ठोस । यह DDD और कार्यात्मक प्रोग्रामिंग के कुछ सिद्धांतों के प्रभाव में बनाया गया था, और निर्भरता इंजेक्शन के सिद्धांत को भी सक्रिय रूप से लागू करता है।

पृष्ठभूमि

इस खंड में एक स्तरित वास्तुकला को समझने के लिए आवश्यक कुछ सॉफ्टवेयर विकास दृष्टिकोण और सिद्धांतों का वर्णन किया गया है।

जिम्मेदारी के विभाजन का सिद्धांत

देयता एक सॉफ्टवेयर की कार्यक्षमता के विभिन्न पहलुओं को संदर्भित करती है। उदाहरण के लिए, "व्यावसायिक तर्क" और इंटरफ़ेस जिसके माध्यम से इसका उपयोग किया जाता है, विभिन्न जिम्मेदारियां हैं।

जिम्मेदारी का पृथक्करण उस कोड को अलग करने की अनुमति देता है जो प्रत्येक जिम्मेदारी को लागू करता है। उदाहरण के लिए, इंटरफ़ेस को बदलने के लिए व्यावसायिक तर्क के कोड को बदलने की आवश्यकता नहीं होनी चाहिए, और इसी तरह।

ठोस सिद्धांत

SOLID निम्नलिखित पाँच सिद्धांतों का एक संक्षिप्त रूप है:

एकमात्र जिम्मेदारी का सिद्धांत

एक वर्ग की एक ही जिम्मेदारी होनी चाहिए। (अनुवादक का नोट: मेरी राय में, एक अधिक सटीक शब्द है: "एक वर्ग के पास एक और परिवर्तन का केवल एक कारण होना चाहिए")

किसी एप्लिकेशन को तोड़ने का सबसे प्रभावी तरीका एक दिव्य वर्ग बनाना है।

दिव्य वर्ग एक ऐसा वर्ग है जो बहुत कुछ जानता और करता है। यह दृष्टिकोण एक विरोधी पैटर्न का एक अच्छा उदाहरण है।

. , , , . , , .

TypeScript . email, .

class Person {
    public name : string;
    public surname : string;
    public email : string;
    constructor(name : string, surname : string, email : string){
        this.surname = surname;
        this.name = name;
        if(this.validateEmail(email)) {
          this.email = email;
        }
        else {
            throw new Error("Invalid email!");
        }
    }
    validateEmail(email : string) {
        var re = /^([\w-]+(?:\.[\w-]+)*)@((?:[\w-]+\.)*\w[\w-]{0,66})\.([a-z]{2,6}(?:\.[a-z]{2})?)$/i;
        return re.test(email);
    }
    greet() {
        alert("Hi!");
    }
}

email Email:

class Email {
    public email : string;
    constructor(email : string){
        if(this.validateEmail(email)) {
          this.email = email;
        }
        else {
            throw new Error("Invalid email!");
        }        
    }
    validateEmail(email : string) {
        var re = /^([\w-]+(?:\.[\w-]+)*)@((?:[\w-]+\.)*\w[\w-]{0,66})\.([a-z]{2,6}(?:\.[a-z]{2})?)$/i;
        return re.test(email);
    }
}

class Person {
    public name : string;
    public surname : string;
    public email : Email;
    constructor(name : string, surname : string, email : Email){
        this.email = email;
        this.name = name;
        this.surname = surname;
    }
    greet() {
        alert("Hi!");
    }
}

, , , /.

/

.

, /:

class Rectangle {
    public width: number;
    public height: number;
}

class Circle {
    public radius: number;
}

function getArea(shapes: (Rectangle|Circle)[]) {
    return shapes.reduce(
        (previous, current) => {
            if (current instanceof Rectangle) {
                return current.width * current.height;
            } else if (current instanceof Circle) {
                return current.radius * current.radius * Math.PI;
            } else {
                throw new Error("Unknown shape!")
            }
        },
        0
    );
}

( ). , . , ( ), , getArea, , .

, , :

interface Shape {
    area(): number;
}

class Rectangle implements Shape {

    public width: number;
    public height: number;

    public area() {
        return this.width * this.height;
    }
}

class Circle implements Shape {

    public radius: number;

    public area() {
        return this.radius * this.radius * Math.PI;
    }
}

function getArea(shapes: Shape[]) {
    return shapes.reduce(
        (previous, current) => previous + current.area(),
        0
    );
}

( ) ( ).

.

, , . :

function getArea(shapes: Shape[]) {
    return shapes.reduce(
        (previous, current) => previous + current.area(),
        0
    );
}

Shape , . , getArea , Shape . , TypeScript, (, Shape area, . , , .

, , , .

.
, : Rectangle Circle. , , . Shape:

interface Shape {
    area(): number;
    serialize(): string;
}

class Rectangle implements Shape {

    public width: number;
    public height: number;

    public area() {
        return this.width * this.height;
    }

    public serialize() {
        return JSON.stringify(this);
    }
}

class Circle implements  Shape {

    public radius: number;

    public area() {
        return this.radius * this.radius * Math.PI;
    }

    public serialize() {
        return JSON.stringify(this);
    }

}

, :

function getArea(shapes: Shape[]) {
    return shapes.reduce(
        (previous, current) => previous + current.area(),
        0
    );
}

, , , :

// ...
return rectangle.serialize();

, serialize Shape . -, — . .

, - , , , :

interface RectangleInterface {
    width: number;
    height: number;
}

interface CircleInterface {
    radius: number;
}

interface Shape {
    area(): number;
}

interface Serializable {
    serialize(): string;
}

, .

class Rectangle implements RectangleInterface, Shape {

    public width: number;
    public height: number;

    public area() {
        return this.width * this.height;
    }
}

class Circle implements CircleInterface, Shape {

    public radius: number;

    public area() {
        return this.radius * this.radius * Math.PI;
    }
}

function getArea(shapes: Shape[]) {
    return shapes.reduce(
        (previous, current) => previous + current.area(),
        0
    );
}

, .

class RectangleDTO implements RectangleInterface, Serializable {
    public width: number;
    public height: number;

    public serialize() {
        return JSON.stringify(this);
    }
}

class CircleDTO implements CircleInterface, Serializable {
    public radius: number;

    public serialize() {
        return JSON.stringify(this);
    }
}

, ( ) ( , ).

, RectangleDTO Rectangle (DRY). , . , , . , .

DRY, DRY SOLID. , DRY , SOLID " " .

. - .

. , .

, SOLID D. , , SOLID. , SOLID . , , , :

, , .
( ).
, , ( /).

SOLID . , , . , JavaScript ES5 ES6, SOLID . , TypeScript .

-- MVC

: , .

. , . , Product , SQL Server.

, . , , , . , .

. . , , , .

, . MVC, ; . , , .

MVC ( , ) . , . . — . - — . , . , , -.

MVC , , . , , -. MVC — .

-

MVC , - . , . -, . - , . , , -.

- . -, , - . - . - :

. , . , , . .

. , , , , .

-. , , (Data Mapper) .

. , catalog , . , , SQL- Sharepoint (CAML). .

( ):

— . , , , , , .

DDD, "". :

, , - . . ( ) - . , , ( SQL) ( HTTP).

, , , . -. (, ) (, ) , , - .

: (), (). , — HTTP , , . AircraftController AircraftRepository:

import { inject } from "inversify";
import { response, controller, httpGet } from "inversify-express-utils";
import * as express from "express";
import { AircraftRepository } from "@domain/interfaces";
import { Aircraft } from "@domain/entities/aircraft";
import { TYPE } from "@domain/types";

@controller("/api/v1/aircraft")
export class AircraftController {

    @inject(TYPE.AircraftRepository) private readonly _aircraftRepository: AircraftRepository;

    @httpGet("/")
    public async get(@response() res: express.Response) {
        try {
            return await this._aircraftRepository.readAll();
        } catch (e) {
            res.status(500).send({ error: "Internal server error" });
        }

    }

    // ...

}

AircraftController HTTP AircraftRepository. AircraftRepository HTTP. :

. "comp" (composition) , AircraftRepository AircraftController. "ref" (reference) , AircraftController Aircraft.

AircraftRepository , , AircraftController AircraftRepository, :

, () ( ). , , .

AircraftRepository . , , - . "" InversifyJS. InversifyJS , @inject, . , :

@inject(TYPE.AircraftRepository) private readonly _aircraftRepository: AircraftRepository;

, InversifyJS :

container.bind<AircraftRepository>(TYPE.AircraftRepository).to(AircraftRepositoryImpl);

AircratRepository Repository<T>, .

import { Aircraft } from "@domain/entities/aircraft";

export interface Repository<T> {
    readAll(): Promise<T[]>;
    readOneById(id: string): Promise<T>;
    // ...
}

export interface AircraftRepository extends Repository<Aircraft> {
    // Add custom methods here ...
}

Repository<T> AircraftRepository:

Repository<T> Gene- ricRepositoryImpl<D, E>
AircraftRepository AircraftRepositoryImpl.

Repository<T>

import { injectable, unmanaged } from "inversify";
import { Repository } from "@domain/interfaces";
import { EntityDataMapper } from "@dal/interfaces";
import { Repository as TypeOrmRepository } from "typeorm";

@injectable()
export class GenericRepositoryImpl<TDomainEntity, TDalEntity> implements Repository<TDomainEntity> {

    private readonly _repository: TypeOrmRepository<TDalEntity>;
    private readonly _dataMapper: EntityDataMapper<TDomainEntity, TDalEntity>;

    public constructor(
        @unmanaged() repository: TypeOrmRepository<TDalEntity>,
        @unmanaged() dataMapper: EntityDataMapper<TDomainEntity, TDalEntity>
    ) {
        this._repository = repository;
        this._dataMapper = dataMapper;
    }

    public async readAll() {
        const entities = await this._repository.readAll();
        return entities.map((e) => this._dataMapper.toDomain(e));
    }

    public async readOneById(id: string) {
        const entity = await this._repository.readOne({ id });
        return this._dataMapper.toDomain(entity);
    }

    // ...

}

, EntityDataMapper TypeOrmRepository . .

, EntityDataMapper:

export interface EntityDataMapper<Domain, Entity> {

    toDomain(entity: Entity): Domain;
    toDalEntity(domain: Domain): Entity;
}

EntityDataMapper:

import { toDateOrNull, toLocalDateOrNull } from "@lib/universal/utils/date_utils";
import { Aircraft } from "@domain/entities/aircraft";
import { AircraftEntity } from "@dal/entities/aircraft";
import { EntityDataMapper } from "@dal/interfaces";

export class AircraftDataMapper implements EntityDataMapper<Aircraft, AircraftEntity> {

    public toDomain(entity: AircraftEntity): Aircraft {
        // ...
    }

    public toDalEntity(mortgage: Aircraft): AircraftEntity {
        // ...
    }
}

EntityDataMapper , TypeOrmRepository . :

, , AircraftRepository:

import { inject, injectable } from "inversify";
import { Repository as TypeOrmRepository } from "typeorm";
import { AircraftRepository } from "@domain/interfaces";
import { Aircraft } from "@domain/entities/aircraft";
import { GenericRepositoryImpl } from "@dal/generic_repository";
import { AircraftEntity } from "@dal/entities/aircraft";
import { AircraftDataMapper } from "@dal/data_mappers/aircraft";
import { TYPE } from "@dal/types";

@injectable()
export class AircraftRepositoryImpl
    extends GenericRepositoryImpl<Aircraft, AircraftEntity>
    implements AircraftRepository {

    public constructor(
        @inject(TYPE.TypeOrmRepositoryOfAircraftEntity) repository: TypeOrmRepository<AircraftEntity>
    ) {
        super(repository, new AircraftDataMapper())
    }

    // Add custom methods here ...

}

, , :

: (, ) (, ).

, — — .

इस वास्तु दृष्टिकोण ने पिछले दस वर्षों में बड़ी उद्यम परियोजनाओं में मेरे लिए काम किया है। इसके अलावा, मैंने विशाल स्तरित मोनोलिथ को माइक्रोसर्विस में विभाजित किया जो कि समान वास्तुकला का पालन करता है। मुझे यह कहना पसंद है कि लेयर्ड आर्किटेक्चर पर माइक्रोसर्विसेज के मामले में हमारे पास "बल्बों का बैग" है।

मुझे उम्मीद है कि आपको यह लेख पसंद आया होगा! कृपया टिप्पणी में या लेखक @RemoHJansen को अपने विचार साझा करें ।

अंत तक पढ़ने वालों के लिए एक बोनस एक काम कोड उदाहरण के साथ एक भंडार है ।

टाइपस्क्रिप्ट और इनवर्सीफ्यूज के साथ Node.js में SOLID और स्तरित वास्तुकला को लागू करना

पृष्ठभूमि

जिम्मेदारी के विभाजन का सिद्धांत

ठोस सिद्धांत

एकमात्र जिम्मेदारी का सिद्धांत

/

-- MVC

-

More articles: