Что такое паттерн Adapter?

Question

Accepted Answer

Паттерн **Adapter** позволяет объектам с **несовместимыми интерфейсами** работать вместе, оборачивая один объект интерфейсом, который ожидает другой. Он служит переводчиком между двумя интерфейсами, обеспечивая интеграцию без изменения существующего кода.

## Что делает паттерн Adapter

```text
ADAPTER → convert one interface into another that a client expects (a "translator"):
  → wrap an object whose interface is INCOMPATIBLE, exposing the interface the client needs
  → the adapter translates calls/data between the two interfaces
→ makes incompatible things work together WITHOUT changing either's code
```

## Пример

```js
// a third-party library with an incompatible interface
class ThirdPartyLogger { logMessage(text) { /* ... */ } }

// our code expects a .log(msg) interface → adapt it
class LoggerAdapter {
  constructor(thirdParty) { this.logger = thirdParty; }
  log(msg) { this.logger.logMessage(msg); }   // translate our interface to theirs
}
const logger = new LoggerAdapter(new ThirdPartyLogger());
logger.log('hello');   // our code uses .log; the adapter calls .logMessage
```

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

```text
USES → integrate THIRD-PARTY libraries with incompatible interfaces; make legacy code work
  with new code; unify different APIs behind a common interface; swap implementations
BENEFITS:
  ✓ INTEGRATION → make incompatible interfaces work together without modifying either
  ✓ DECOUPLING → your code depends on YOUR interface; adapters isolate external/incompatible
    code → swap or upgrade dependencies behind the adapter
  ✓ Reuse existing code that doesn't quite fit
```

## Почему это важно

Понимание паттерна Adapter ценно, потому что это **очень распространённый, практичный структурный паттерн** для интеграции несовместимого кода, поэтому это актуальное знание проектирования.

Паттерн Adapter позволяет объектам с **несовместимыми интерфейсами работать вместе**, оборачивая один объект интерфейсом, который ожидает другой — действуя как переводчик между интерфейсами.

Понимание того, что он делает (оборачивание объекта с несовместимым интерфейсом для предоставления интерфейса, который требует клиент, трансляция между двумя интерфейсами), является основным знанием.

Понимание **применения** особенно ценно, потому что оно отражает типичные реальные потребности: **интеграция сторонних библиотек** с несовместимыми интерфейсами (частая ситуация — нужно использовать библиотеку, но её интерфейс не совпадает с вашим кодом), обеспечение **совместимости унаследованного кода с новым кодом**, унификация различных API за общим интерфейсом и возможность замены реализаций.

Эти потребности в интеграции возникают постоянно в реальной разработке.

Понимание **преимуществ** — **интеграция** (обеспечение работы несовместимых интерфейсов вместе без изменения любого из них, что часто необходимо, когда вы не можете изменить стороннний или унаследованный код) и **слабая связанность** (ваш код зависит от вашего собственного интерфейса, в то время как адаптеры изолируют внешний/несовместимый код, позволяя вам менять или обновлять зависимости за адаптером — ценное архитектурное преимущество) — уточняет, почему Adapter практически важен.

Паттерн Adapter — один из наиболее практически полезных паттернов, потому что интеграция несовместимого кода (сторонние библиотеки, унаследованные системы, различные API) — постоянная, реальная потребность в разработке.

Поскольку паттерн Adapter — очень распространённый, практичный паттерн для интеграции несовместимых интерфейсов (сторонние библиотеки, унаследованный код, различные API) без изменения любого из них — постоянная реальная потребность — и обеспечивает ценную слабую связанность, и поскольку понимание того, что он делает, его применения и преимуществ актуально для реальной работы по интеграции, понимание паттерна Adapter — ценное, практически релевантное знание проектирования — часто используемый паттерн для типичной задачи интеграции несовместимого кода, обеспечивающий интеграцию и слабую связанность, и важное знание проектирования для реальной, повторяющейся задачи взаимодействия различных частей кода.