// Target (目标接口) - 英国人期望的交流方式
interface EnglishSpeaker {
    String speakEnglish();
}

// Adaptee (被适配者) - 只会说中文的人
class ChinesePerson {
    public String speakChinese() {
        return "你好，世界！";
    }
}

// Adapter (适配器) - 一个会中英双语的翻译官
// 通过继承 ChinesePerson，并实现 EnglishSpeaker 接口
class TranslatorAdapter extends ChinesePerson implements EnglishSpeaker {
    @Override
    public String speakEnglish() {
        // 调用父类（被适配者）的方法，并进行转换
        String chinese = speakChinese();
        // 假设这里有一个翻译引擎
        String english = "Hello, World!"; // 翻译结果
        System.out.println("翻译官将 '" + chinese + "' 翻译为 '" + english + "'");
        return english;
    }
}

// 客户端 - 英国人
public class BritishClient {
    public void communicate(EnglishSpeaker speaker) {
        System.out.println("英国人听到了: " + speaker.speakEnglish());
    }

    public static void main(String[] args) {
        BritishClient client = new BritishClient();
        EnglishSpeaker translator = new TranslatorAdapter();
        client.communicate(translator);
    }
}

2. 对象适配器模式 (Object Adapter) - 更常用

实现方式： 通过**组合（持有对象引用）**来实现。适配器类实现目标接口，并在内部持有一个被适配者类的实例。
优点： 更加灵活。因为组合比继承的耦合度更低，适配器可以适配一个类的任何子类。这是推荐使用的方式。

a) 结构

Target（目标接口）： 客户端期望的接口。
Adaptee（被适配者）： 需要被适配的、接口不兼容的类。
Adapter（适配器）： 实现了 Target 接口，并在内部持有 Adaptee 的一个实例。

b) 代码实例

我们用对象适配器的方式重构上面的例子。

// Target 和 Adaptee 类与上面完全相同
interface EnglishSpeaker { String speakEnglish(); }
class ChinesePerson { public String speakChinese() { return "你好，世界！"; } }

// Adapter (适配器) - 现在通过组合的方式持有 ChinesePerson
class TranslatorAdapter implements EnglishSpeaker {
    // 持有被适配者对象的引用
    private ChinesePerson adaptee;

    public TranslatorAdapter(ChinesePerson adaptee) {
        this.adaptee = adaptee;
    }

    @Override
    public String speakEnglish() {
        // 调用被适配者实例的方法，并进行转换
        String chinese = adaptee.speakChinese();
        String english = "Hello, World!"; // 翻译结果
        System.out.println("翻译官将 '" + chinese + "' 翻译为 '" + english + "'");
        return english;
    }
}

// 客户端 - 英国人
public class BritishClient {
    public void communicate(EnglishSpeaker speaker) {
        System.out.println("英国人听到了: " + speaker.speakEnglish());
    }

    public static void main(String[] args) {
        BritishClient client = new BritishClient();
        // 创建被适配者实例
        ChinesePerson chinesePerson = new ChinesePerson();
        // 创建适配器，并将被适配者注入
        EnglishSpeaker translator = new TranslatorAdapter(chinesePerson);
        client.communicate(translator);
    }
}

三、类适配器 vs. 对象适配器

特性	类适配器	对象适配器 (推荐)
实现方式	继承	组合
耦合度	高。适配器与被适配者是父子关系。	低。适配器与被适配者是弱关联。
灵活性	差。无法适配一个类的子类。	好。可以适配被适配者及其所有子类。
重写行为	可以重写被适配者的方法。	不能重写被适配者的方法，只能通过其接口调用。

四、优缺点与适用场景

优点

兼容性好： 可以让任何两个没有关联的类一起运行。
提高了类的复用性： 可以复用一些已存在的、但接口不符合要求的类。
透明性： 客户端可以调用同一接口，而完全不知道背后是适配器在工作，符合开闭原则（对客户端而言）。

缺点

增加了系统复杂度： 过多地使用适配器，会让系统非常零乱，不易整体进行把握。
对于类适配器，由于语言限制（如Java单继承），使用场景受限。

适用场景

系统需要使用现有的类，而这些类的接口不符合系统的需要时。（最核心的场景）
想要创建一个可以复用的类，该类可以与一些不相关的类或不可预见的类协同工作。
在设计后期，需要兼容老版本或第三方提供的、无法修改源码的组件时。
实际应用案例：
- java.io.InputStreamReader 就是一个适配器，它将 InputStream（字节流）适配成 Reader（字符流）。
- java.util.Arrays.asList() 方法，它将一个数组适配成一个 List。
- 各种框架中用于连接不同版本API或集成第三方SDK的场景。