Быстрый старт

Следуйте этим простым шагам, чтобы быстро начать использовать bindbox в своём приложении.

Установка

Вы можете установить bindbox с помощью менеджера пакетов JavaScript:

npm

npm add bindbox reflect-metadata

pnpm

pnpm add bindbox reflect-metadata

yarn

yarn add bindbox reflect-metadata

bun

bun add bindbox reflect-metadata

Примечание о совместимости

Пожалуйста, убедитесь, что в вашем проекте установлен Node.js версии 18 или выше.

Использование

Ниже приведён краткий пример, демонстрирующий основные возможности DI-контейнера. Подробную информацию вы можете найти в последующих разделах документации.

main.ts

import { Container } from 'bindbox';
import 'reflect-metadata';

import { Logger } from './logger';
import { Storage } from './storage';
import { TLogger, TStorage } from './tokens';

const container = new Container();

container.bind(TLogger).to(Logger).inSingleton();
container.bind(TStorage).to(Storage).inSingleton();

const storage = container.get(TStorage);

storage.set('some', 'value');

contracts.ts

export interface LoggerContract {
  log(message: string): void;
}

export interface StorageContract {
  get(key: string): string | null;
  set(key: string, value: string): void;
  remove(key: string): void;
}

tokens.ts

import type { LoggerContract, StorageContract } from './contracts';

export const TLogger = createTypeId<LoggerContract>('TLogger');
export const TStorage = createTypeId<StorageContract>('TStorage');

storage.ts

import { ParamTypes } from 'bindbox';

import type { StorageContract } from './contracts';
import type { TLogger } from './tokens';

export class Storage implements StorageContract {
  #data = new Map<string, string>();

  constructor(private logger: LoggerContract) {
    this.logger.log('MemoryStorage inited');
  }

  get(key: string): string | null {
    return this.#data.get(key) ?? null;
  }

  set(key: string, value: string): void {
    this.#data.set(key, value);
  }

  remove(key: string): void {
    this.#data.delete(key);
  }
}

ParamTypes.define(Storage, [TLogger]);

logger.ts

import type { LoggerContract } from './contracts';

export class Logger implements LoggerContract {
  log(message: string): void {
    console.log(message);
  }
}