Adapter — 介面轉換橋接

1. 意圖

將一個類的介面轉換為客戶端所期望的另一個介面,讓原本因介面不相容而無法協作的類能夠一起工作。

2. UML 類圖

classDiagram
    class Target {
        <>
        +request()
    }
    class Adaptee {
        +specificRequest()
    }
    class Adapter {
        -adaptee Adaptee
        +request()
    }
    Target <|.. Adapter
    Adapter --> Adaptee

3. 何時用 / 何時別用

用:

  • 整合第三方 SDK,其介面與系統定義不同
  • 改造遺留系統,在不修改舊程式的前提下接入新介面
  • 統一多個來源的異構實作(如多家支付閘道)

別用:

  • 介面差異極大,轉換邏輯超過 50 行 — 考慮重新設計
  • 新系統,沒有遺留限制 — 直接設計統一介面即可
  • 只為了「看起來統一」而包裝,沒有實際轉換需求

4. Java 範例

Object Adapter(組合,優先選用):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// 目標介面(系統期望)
public interface PaymentGateway {
    boolean charge(long amountCents, String currency);
}

// 第三方 SDK(不可修改)
public class StripeClient {
    public StripeResponse createCharge(String amount, String currency, Map<String, String> meta) {
        // ... Stripe API call
        return new StripeResponse(true, "ch_123");
    }
}

// Object Adapter
public class StripeAdapter implements PaymentGateway {
    private final StripeClient stripe;

    public StripeAdapter(StripeClient stripe) {
        this.stripe = stripe;
    }

    @Override
    public boolean charge(long amountCents, String currency) {
        String amount = String.valueOf(amountCents);
        Map<String, String> meta = Map.of("source", "adapter");
        StripeResponse resp = stripe.createCharge(amount, currency, meta);
        return resp.isSuccess();
    }
}

Class Adapter(繼承,Java 以 implements 模擬):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
// 遺留日誌類
public class LegacyLogger {
    public void writeLog(String level, String message) { /* ... */ }
}

// 目標介面
public interface Logger {
    void info(String msg);
    void error(String msg);
}

// Class Adapter:繼承 Adaptee,實作 Target
public class LegacyLoggerAdapter extends LegacyLogger implements Logger {
    @Override public void info(String msg)  { writeLog("INFO",  msg); }
    @Override public void error(String msg) { writeLog("ERROR", msg); }
}

5. JDK / Spring 真實案例

InputStreamReader:將位元組流 InputStream(Adaptee)適配為字元流 Reader(Target)。new InputStreamReader(socket.getInputStream()) 是教科書級範例。

Arrays.asList():將陣列適配為 List,讓陣列可被 Collection API 操作。

Spring MVC HandlerAdapter:DispatcherServlet 透過 HandlerAdapter 統一呼叫各種 Handler(Controller、HttpRequestHandler、Servlet),無需關心具體型別。

6. 與相近 Pattern 的差異

面向AdapterDecoratorFacade
目的轉換介面(相容性)疊加行為(功能擴充)簡化介面(隱藏複雜度)
介面變化轉換為不同介面保持相同介面提供更簡單的介面
典型時機整合既有元件動態增加功能封裝子系統

7. 現代 Java 取代方案

Java 8+ 的 lambda 可在介面只有一個方法時直接充當輕量 Adapter:

1
2
3
// 目標:Runnable;Adaptee:舊版 Task
Task legacyTask = new LegacyTask();
Runnable adapter = legacyTask::execute; // 單方法 Adapter,無需額外類別

多方法介面仍需傳統 Adapter 類別,此 pattern 仍是標準做法。

8. 參考資料

  • GoF Design Patterns (1994), Chapter 4 — Adapter
  • Effective Java, 3rd ed., Item 20: Prefer interfaces to abstract classes

留言討論