Java设计模式——适配器模式：解锁接口兼容的神奇“魔法”

在软件开发领域，接口不兼容是常见难题。如同不同国度的人语言不通，软件世界中许多功能完备的类，却因接口定义差异无法直接协作。适配器模式（Adapter Pattern） 正如一位“翻译官”，通过转换接口，使原本不兼容的类能够协同工作。本文将深入探讨适配器模式的核心原理、应用场景及 Java 实现方式。

一、核心定义：适配器模式的使命🎯

在构建软件系统时，各类组件本应紧密协作。然而，接口不兼容往往导致组件间无法对接。适配器模式的核心目标，是将一个类的接口转换成客户期望的另一种接口。它如同桥梁建筑师，连接因接口差异而“隔离”的类，使它们能够和谐共处，确保系统如精密齿轮般顺畅运转。

二、生活类比：现实中的适配器🤔

生活中处处可见适配器模式的影子。例如，你遇到一位韩国友人，双方语言不通。若从零开始学习对方语言，成本高昂且效率低下。此时，一位专业翻译便能轻松解决沟通障碍。翻译官在双方之间协调语言差异，成本低、效率高且灵活。若后续遇到日本友人，只需更换精通日语的翻译即可。

编程中的适配器模式与此类似：它通过“转换接口”这一机制，让不同“语言体系”（接口）的类顺利“对话”与合作。

三、应用场景：绘图编辑器中的巧思🎨

以绘图编辑器为例，该工具需绘制直线、多边形、文本等基本图元。直线和多边形的实现较为简单，但文本处理若从头开发，既耗时又难保质量。此时可复用现有的文本编辑器组件（如 TextView）。

通过定义一个适配器类（如 TextShape），将 TextView 的接口转换为绘图编辑器所需的图元接口。这种“移花接木”的方式避免了重复造轮子，显著提升了开发效率与系统可靠性。

四、Java 实现：类适配器与对象适配器🧐

在 GoF 设计模式中，适配器模式分为类适配器和对象适配器两种实现方式。由于 Java 不支持多重继承，类适配器需通过继承被适配类（Adaptee）并实现目标接口（Target）来实现。这种方式存在一定局限性：

Target 必须为接口：否则适配器无法实现多重继承。
耦合度较高：适配器成为被适配类的子类，灵活性受限。

对象适配器则采用委托（Delegation） 机制，适配器持有被适配类的实例。这种方式解耦了两者关系，灵活性更高。以下将详细对比两种模式的特性。

五、模式对比：类适配器 VS 对象适配器🌈

（一）对被适配类（Adaptee）的定制能力

类适配器：适配器是适配类的子类，可直接重写父类方法。若需优化适配类的某些方法，可直接在适配器中修改，如同给老房子翻新，得心应手。
对象适配器：适配器与适配类是委托关系。若需修改适配类方法，需新建适配类的子类，再由适配器委托该子类。虽步骤稍繁，但提供了更大的操作空间。

（二）应对适配类家族扩展

类适配器：继承关系在编译期确定。若适配类层次结构扩展，适配器需相应调整，扩展性较差。
对象适配器：基于委托关联，运行时可灵活替换适配类实例。当适配类家族扩展时，适配器能从容应对，适应性强。

对比维度	类适配器	对象适配器
对 Adaptee 方法特殊定制	可直接重定义，方便优化拓展	需新建子类配合，灵活性高
应对 Adaptee 类层次扩展	编译后难更换，扩展不便	运行时可灵活替换，适应性强

六、代码实战：图形绘制场景下的实现🎯

（一）对象适配器实现

基础坐标类：Point
用于标识画面坐标中的点。

package qinysong.pattern.adapter;

public class Point {
    private int coordinateX;
    private int coordinateY;

    public Point(int coordinateX, int coordinateY) {
        this.coordinateX = coordinateX;
        this.coordinateY = coordinateY;
    }

    public String toString() {
        return "Point[x=" + coordinateX + ",y=" + coordinateY + "]";
    }

    public int getCoordinateX() {
        return coordinateX;
    }

    public int getCoordinateY() {
        return coordinateY;
    }
}

目标接口：Shape
对应适配器模式中的 Target 角色，为图元形状勾勒统一规范。

package qinysong.pattern.adapter;

public interface Shape {
    Point getBottomLeftPoint();
    Point getTopRightPoint();
}

被适配类：TextView
对应适配器模式中的 Adaptee 角色，自带文本属性获取方法。

package qinysong.pattern.adapter;

public class TextView {
    public int getCoordinateX() {
        System.out.println("TextView.getCoordinateX()...");
        return 10;
    }

    public int getCoordinateY() {
        System.out.println("TextView.getCoordinateY()...");
        return 20;
    }

    public int getHeight() {
        System.out.println("TextView.getHeight()...");
        return 30;
    }

    public int getWidth() {
        System.out.println("TextView.getWidth()...");
        return 40;
    }

    public boolean isEmpty() {
        return false;
    }
}

适配器类：TextShape
对象模式下的适配器，持有 TextView 实例，通过委托协调实现 Shape 接口。

package qinysong.pattern.adapter;

public class TextShape implements Shape {
    private TextView textView;

    public TextShape(TextView textView) {
        this.textView = textView;
    }

    // 借助委托，调用 TextView 方法实现接口功能
    public Point getBottomLeftPoint() {
        System.out.println("TextShape.getBottomLeftPoint()...");
        int coordinateX = textView.getCoordinateX();
        int coordinateY = textView.getCoordinateY();
        return new Point(coordinateX, coordinateY);
    }

    // 借助委托，调用 TextView 方法实现接口功能
    public Point getTopRightPoint() {
        System.out.println("TextShape.getTopRightPoint()...");
        int coordinateX = textView.getCoordinateX();
        int coordinateY = textView.getCoordinateY();
        int height = textView.getHeight();
        int width = textView.getWidth();
        return new Point(coordinateX + width, coordinateY + height);
    }
}

客户端测试：Client
验证适配器模式的效果。

package qinysong.pattern.adapter;

public class Client {
    public static void main(String[] args) {
        System.out.println("Client.main begin..........");
        System.out.println("Client.main 以下是通过实例委托方式实现的 Adapter");
        Shape shape = new TextShape(new TextView());
        Point bottomLeft = shape.getBottomLeftPoint();
        Point topRight = shape.getTopRightPoint();
        System.out.println("Client.main shape's bottomLeft: " + bottomLeft);
        System.out.println("Client.main shape's topRight: " + topRight);
        System.out.println("Client.main end..........");
    }
}

（二）类适配器实现

类适配器通过继承 TextView 并实现 Shape 接口来完成适配。此处省略 Point、Shape、TextView 的重复定义，重点展示 TextShape2 类。

package qinysong.pattern.adapter;

public class TextShape2 extends TextView implements Shape {
    // 利用继承自 TextView 的优势，协调实现接口方法
    public Point getBottomLeftPoint() {
        System.out.println("TextShape2.getBottomLeftPoint()...");
        int coordinateX = getCoordinateX();
        int coordinateY = getCoordinateY();
        return new Point(coordinateX, coordinateY);
    }

    // 利用继承自 TextView 的优势，协调实现接口方法
    public Point getTopRightPoint() {
        System.out.println("TextShape2.getTopRightPoint()...");
        int coordinateX = getCoordinateX();
        int coordinateY = getCoordinateY();
        int height = getHeight();
        int width = getWidth();
        return new Point(coordinateX + width, coordinateY + height);
    }

    // 凸显类模式特色，重定义父类方法
    public int getCoordinateX() {
        System.out.println("TextShape2.getCoordinateX()...");
        return 100;
    }
}

通过上述代码实战，可清晰洞察类适配器与对象适配器在实现细节与灵活性上的差异。在实际开发中，应依据项目需求选择合适的实现方式，充分发挥适配器模式的价值，构建灵活稳健的软件系统。

说明：本文代码基于标准 Java SE 编写，适用于 Java 5 及以上版本。设计模式核心思想不受版本限制，但具体语法特性需结合当前开发环境调整。

本文地址：https://1diff.fun/archives/java-she-ji-mo-shi--shi-pei-qi-mo-shi--jie-suo-jie-kou-jian-rong-de-shen-qi--mo-fa.html

如果对本文有什么问题或疑问都可以在评论区留言，我看到后会尽量解答。