Kas yra Adapter modelis?

Question

Accepted Answer

**Adapter** modelis leidžia objektams su **nesuderinomomis sąsajomis** dirbti kartu, apvyniojant vieną sąsają, kurią tikisi kitas. Jis veikia kaip vertėjas tarp dviejų sąsajų, sudarydamas galimybę integruoti kodą nemodifikuojant esamo kodo.

## Kas Adapter modelis daro

```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
```

## Pavyzdys

```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
```

## Naudojimo atvejai ir privalumai

```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
```

## Kodėl tai svarbu

Supratimas apie Adapter modelį yra vertingas, nes tai **labai dažnas, praktinis struktūrinis modelis** nesuderiamiems kodams integruoti, todėl tai aktuali dizaino žinojimo.

Adapter modelis leidžia objektams su **nesuderinomomis sąsajomis dirbti kartu** apvyniojant vieną sąsają, kurią tikisi kitas — veikdamas kaip vertėjas tarp sąsajų.

Supratimas, ką tai daro (apvynioja objektą su nesuderinamąja sąsaja, kad paskleistų sąsają, kurios klients reikalingas, vertindamas tarp šių dviejų) — tai pagrindinė žinojimo dalis.

Supratimas apie **naudojimo atvejus** yra ypatingai vertingas, nes jie yra dažni, realūs poreikiai: **trečiųjų šalių bibliotekų integravimas** su nesuderinomomis sąsajomis (dažna situacija — reikia naudoti biblioteką, bet jos sąsaja neatitinka jūsų kodo), **senojo kodo darbimas su naujuoju kodu**, skirtingų API suvedimas po bendra sąsaja ir diegimų keitimas. Šie integravimo poreikiai nuolat iškyla realaus kūrimo metu.

Supratimas apie **privalumus** — **integravimas** (nesuderinamos sąsajos darbimas kartu keičiant nei vieną iš jų, kas dažnai yra būtina, kai negalite keisti trečiųjų šalių arba senojo kodo) ir **atsietas ryšys** (jūsų kodas priklauso nuo jūsų pačių sąsajos, o adapteriai atriša išorinį/nesuderinomą kodą, todėl galite keisti arba atnaujinti priklausomybes per adapterį — vertinga architektūrinė nauda) — paaiškina, kodėl Adapter praktiškai svarbus.

Adapter modelis yra vienas iš praktiškiausiai naudingų modelių, nes nesuderiamiems kodams integruoti (trečiųjų šalių bibliotekos, senės sistemos, skirtingi API) reikalingas nuolatinis, realus poreikis.

Kadangi Adapter modelis yra labai dažnas, praktinis modelis nesuderiniamiems sąsajoms integruoti (trečiųjų šalių bibliotekos, senasis kodas, skirtingi API) keičiant nei vieną iš jų — nuolatinis realus poreikis — ir teikia vertingą atsieto ryšio efektą, ir kadangi supratimas, ką jis daro, jo naudojimo atvejus ir jo privalumus yra aktualus realiam integravimo darbui, supratimas apie Adapter modelį yra vertingas, praktiniu požiūriu aktuali dizaino žinojimo — dažnai reikalingas modelis bendrai nesuderiniamiems kodams integruoti užduočiai, teikiantis integravimą ir atsieto ryšio efektą, ir svarbi dizaino žinojimo skirtingų kodo dalių darbui kartu suderinti.