Što je Adapter pattern?

Question

Accepted Answer

**Adapter** pattern omogućava objektima s **nekompatibilnim sučeljima** da rade zajedno tako što omotava jedan s sučeljem koje drugi očekuje. Djeluje kao prevoditelj između dva sučelja, omogućavajući integraciju bez mijenjanja postojećeg koda.

## Što Adapter pattern čini

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

## Primjer

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

## Upotreba i prednosti

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

## Zašto je to važno

Razumijevanje Adapter patterna je vrijedno jer je to **vrlo čest, praktičan strukturalni pattern** za integraciju nekompatibilnog koda, pa je to relevantno znanje o dizajnu.

Adapter pattern omogućava objektima s **nekompatibilnim sučeljima da rade zajedno** tako što omotava jedan s sučeljem koje drugi očekuje — djelujući kao prevoditelj između sučelja.

Razumijevanje što radi (omotavanje objekta s nekompatibilnim sučeljem kako bi se izložilo sučelje koje klijent trebа, prevođenje između ta dva) je temeljno znanje.

Razumijevanje **upotrebe** je posebno vrijedno jer predstavljaju česte, stvarne potrebe: **integracija biblioteka trećih strana** s nekompatibilnim sučeljima (česta situacija — trebate koristiti biblioteku ali njezino sučelje se ne podudara s vašim kodom), usklađivanje **naslijeđenog koda s novim kodom**, objedinjavanje različitih API-ja iza zajedničkog sučelja i omogućavanje zamjene implementacija.

Te potrebe za integracijom javljaju se neprestano u stvarnom razvoju.

Razumijevanje **prednosti** — **integracija** (usklađivanje nekompatibilnih sučelja bez mijenjanja ni jednog, što je često potrebno kada ne možete promijeniti kod trećih strana ili naslijeđeni kod), i **odvajanje** (vš kod ovisi o vašem vlastitom sučelju dok adaptatori izoliraju vanjski/nekompatibilan kod, pa možete zamijeniti ili nadograditi ovisnosti iza adaptera — vrijedna arhitektonska prednost) — pojašnjava zašto je Adapter praktički važan.

Adapter pattern je jedan od najčešće praktički korisnih patterna jer je integracija nekompatibilnog koda (biblioteke trećih strana, naslijeđeni sustavi, različiti API-ji) stalna, stvarna potreba u razvoju.

Budući da je Adapter pattern vrlo čest, praktičan pattern za integraciju nekompatibilnih sučelja (biblioteke trećih strana, naslijeđeni kod, različiti API-ji) bez mijenjanja ni jednog — što je stalna stvarna potreba — i nudi vrijednu separaciju, te budući da je razumijevanje što radi, njegove upotrebe i njegovih prednosti relevantno za stvarni integracijski rad, razumijevanje Adapter patterna je vrijedna, praktično relevantna znanja o dizajnu — često trebani pattern za običan zadatak integracije nekompatibilnog koda, pružajući integraciju i separaciju, te važna znanja o dizajnu za stvaran, ponavljajući izazov usklađivanja različitih dijelova koda da rade zajedno.