Как правильно управлять зависимостями сетевого слоя?

Правильное управление зависимостями сетевого слоя — ключевой аспект архитектуры современного приложения. Оно отделяет код, выполняющий HTTP-запросы, от остальной бизнес-логики, делая систему более модульной, тестируемой и адаптируемой к изменениям.

Основные принципы

• Абстракция: Определите интерфейс (или абстрактный класс) для сетевого клиента. Бизнес-логика должна зависеть от этого интерфейса, а не от конкретного класса axios или fetch.
• Внедрение зависимостей (DI): Конкретная реализация сетевого клиента "внедряется" извне, обычно через конструктор или параметры метода.
• Единая ответственность: Сетевой слой должен заниматься только коммуникацией: формированием запросов, обработкой ответов и ошибок. Парсинг данных и бизнес-правила — это зона ответственности других модулей.

Практическая реализация

Рассмотрим пример на TypeScript. Сначала определим абстракцию, затем реализацию и покажем, как её использовать.

// 1. Абстракция (интерфейс) сетевого клиента
interface HttpClient {
  get<T>(url: string): Promise<T>;
  post<T>(url: string, data: unknown): Promise<T>;
  // ... другие методы
}

// 2. Конкретная реализация с использованием fetch (или axios)
class FetchHttpClient implements HttpClient {
  private baseURL: string;

  constructor(baseURL: string) {
    this.baseURL = baseURL;
  }

  async get<T>(url: string): Promise<T> {
    const response = await fetch(`${this.baseURL}${url}`);
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.json() as Promise<T>;
  }
  // ... реализация post и других методов
}

// 3. Сервис бизнес-логики, зависящий от абстракции
class UserService {
  constructor(private httpClient: HttpClient) {}

  async getUsers() {
    // Бизнес-логика использует только интерфейс
    return this.httpClient.get<User[]>('/users');
  }
}

// 4. Компоновка ("сборка") зависимостей
const httpClient = new FetchHttpClient('https://api.example.com');
const userService = new UserService(httpClient);

// 5. Использование
// const users = await userService.getUsers();

Преимущества и применение

Такой подход применяется для:

• Модульного тестирования: Вы можете передать в UserService мок HttpClient, который возвращает фиктивные данные, не делая реальных сетевых запросов.
• Лёгкой замены библиотек: Чтобы перейти с fetch на axios, нужно создать новый класс AxiosHttpClient, реализующий тот же интерфейс, и заменить одну строку при создании зависимостей.
• Централизованного управления: Конфигурация (baseURL, заголовки аутентификации, интерцепторы) инкапсулирована в одном месте — в реализации HttpClient.

Вывод: Управление зависимостями через абстракции и DI стоит применять в любом проекте, где сетевые запросы являются критической частью. Это обязательно для средних и крупных приложений, так как значительно упрощает тестирование, поддержку и эволюцию кода при смене внешних API или сетевых библиотек.