Adapter — 介面轉換橋接

Tue, 07 Aug 2018 12:12:36 +0800

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（組合，優先選用）：

// 目標介面（系統期望）
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 模擬）：

Adapter on Bill.Lin's Notes

Adapter — 介面轉換橋接

1. 意圖

2. UML 類圖

3. 何時用 / 何時別用

4. Java 範例