ما هو نمط Adapter؟

Question

ما هو نمط Adapter؟

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 للكائنات ذات **الواجهات غير المتوافقة بالعمل معاً** من خلال تغليف أحدها بالواجهة التي يتوقعها العميل — يعمل كمترجم بين الواجهات.

فهم ما يفعله (تغليف كائن بواجهة غير متوافقة لعرض الواجهة التي يحتاجها العميل، والترجمة بين الاثنين) هو المعرفة الأساسية.

فهم **الاستخدامات** مفيد بشكل خاص لأنها احتياجات شائعة وحقيقية: **تكامل المكتبات الخارجية** ذات الواجهات غير المتوافقة (موقف متكرر — تحتاج إلى استخدام مكتبة لكن واجهتها لا تطابق كودك)، جعل **الكود القديم يعمل مع الكود الجديد**، توحيد واجهات برمجية مختلفة خلف واجهة مشتركة، وتمكين استبدال التطبيقات.

تنشأ هذه احتياجات التكامل باستمرار في التطوير الحقيقي.

فهم **الفوائد** — **التكامل** (جعل الواجهات غير المتوافقة تعمل معاً دون تعديل أي منهما، وهو ضروري غالباً عندما لا يمكنك تغيير الكود الخارجي أو القديم)، و**فك الارتباط** (كودك يعتمد على واجهتك الخاصة بينما تعزل المحولات الكود الخارجي/غير المتوافق، بحيث يمكنك استبدال أو ترقية الاعتماديات خلف المحول — فائدة معمارية قيمة) — يوضح السبب في أن Adapter مهم عملياً.

نمط Adapter هو أحد أكثر الأنماط نفعاً عملياً لأن تكامل الكود غير المتوافق (المكتبات الخارجية، الأنظمة القديمة، واجهات برمجية مختلفة) حاجة ثابتة وحقيقية في التطوير.

حيث أن نمط Adapter هو نمط عملي شائع جداً لتكامل الواجهات غير المتوافقة (المكتبات الخارجية، الكود القديم، واجهات برمجية مختلفة) دون تعديل أي منهما — حاجة حقيقية ثابتة — ويوفر فك ارتباط قيم، وحيث أن فهم ما يفعله والاستخدامات والفوائد ذات صلة بالعمل التكاملي الحقيقي، فإن فهم نمط Adapter هو معرفة تصميم قيمة وعملية — نمط متكرر الاستخدام للمهمة الشائعة لتكامل الكود غير المتوافق، يوفر التكامل وفك الارتباط، ومعرفة تصميم مهمة للتحدي الحقيقي والمتكرر المتمثل في جعل أجزاء مختلفة من الكود تعمل معاً.