Cad é patrún an Adapter?

Question

Accepted Answer

Ligeann an patrún **Adapter** do réada le **comhéadain neamh-chomhoiriúnacha** a bheith ag feidhmiú le chéile trí chéann a fholuain le comhéadan a bhíonn ag súil an cheann eile. Gníomhaíonn sé mar aistritheoir idir dhá chomhéadan, ag gealadh comhtháthú gan cód atá ann cheana a athrú.

## Cad a dhéanann patrún an 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
```

## Sampla

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

## Úsáidí agus buntáistí

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

## Cén fáth a bhíonn tábhacht ann

Tá an tuiscint ar phatrún an Adapter luachmhar toisc gur **patrún struchtúrach an-choitianta, praiticiúil** a bhíonn ann do chód neamh-chomhoiriúnacha a chomhtháthú, agus mar sin bíonn sé ina eolas dearaidh ábhartha.

Ligeann patrún an Adapter do réada le **comhéadain neamh-chomhoiriúnacha a bheith ag feidhmiú le chéile** trí chéann a fholuain le comhéadan a bhíonn ag súil an chéile — gníomhú mar aistritheoir idir chomhéadain.

Is é an teolas bunúsach a thuiscint cad a dhéanann sé (réad le comhéadan neamh-chomhoiriúnacha a fholuain chun an comhéadan atá ag teastáil ó dhíoltóir a nochtadh, agus aistriú idir an bheirt).

Tá an tuiscint ar na **húsáidí** go háirithe luachmhar toisc gur **riachtanais dhíreach, choitianta** iad: **leabharlanna tríú páirtí ar fhiúntrais neamh-chomhoiriúnacha a chomhtháthú** (cás minic go leor — ba bhreá duit leabharlann a úsáid ach ní raibh a comhéadan ag teastáil ó do chód), **cód oidhreachta a dhéanamh ag feidhmiú le cód nua**, API éagsúla a aontú taobh thiar de chomhéadan coiteann, agus fhéadfadh tú feidhmeanna a bhogadh.

Tarlaíonn na riachtanais chomhtháthaithe seo go leanúnach i bhfíorfhorbairt.

Is léir ó na **buntáistí** — **comhtháthú** (comhéadain neamh-chomhoiriúnacha a dhéanamh ag feidhmiú le chéile gan ceachtar díobh a athrú, rud atá riachtanach go minic nuair nach féidir leat cód tríú páirtí nó oidhreachta a athrú), agus **foluain** (do chód ag brath ar do chomhéadan féin agus adapters ag iompar cóid sheachtrach/neamh-chomhoiriúnacha, ionas go bhféadfá feidhmeanna nó spleáchais a bhogadh taobh thiar den adapter — buntáiste ailtireachta luachmhar) — cén fáth a bhíonn Adapter go praiticiúil tábhachtach.

Is é patrún an Adapter ceann de na patrúin is praiticiúla, úsáideach toisc go bhíonn cód neamh-chomhoiriúnacha (leabharlanna tríú páirtí, córais oidhreachta, API éagsúla) a chomhtháthú riachtanach do gach duine, agus a bhíonn ann i gcoitinne.

Ó bhreithiúnú air go bhfuil patrún an Adapter ina **phatrún an-choitianta, praiticiúil** do chód neamh-chomhoiriúnacha a chomhtháthú (leabharlanna tríú páirtí, cód oidhreachta, API éagsúla) gan ceachtar a athrú — riachtanas i gcoitinne agus i bhfíorfhorbairt — agus go soláthaíonn sé foluain luachmhar, agus ó bhreithiúnú air go bhfuil tuiscint ar cad a dhéanann sé, ar a úsáidí, agus ar a buntáistí ábhartha do ghníomhaireacht chomhtháthaithe réadúil, bíonn tuiscint ar phatrún an Adapter ina eolas dearaidh luachmhar agus go praiticiúil — patrún a bhíonn riachtanach go minic do an tasc coitianta a dhéanamh cóid dhifriúla a dhéanamh ag feidhmiú le chéile, ag soláthar comhtháthú agus foluain, agus eolas dearaidh tábhachtach do an dúshlán fíor-thuartha ar an chomh-dhéanamh dhifriúla chuid a bheith ag obair ar fud a chéile.