Java案例怎么实现适配器模式？

wen java案例 2026-06-11 12

Java案例实战：适配器模式的高效实现与场景解析

目录导读

适配器模式概述与核心思想
为什么需要适配器模式？真实痛点分析
Java适配器模式的三种实现方式
经典案例：第三方支付接口适配
JDBC驱动中的适配器角色
日志系统统一适配
适配器模式与装饰器、代理模式的区别
高频面试问答与最佳实践
总结与适用场景建议

适配器模式概述与核心思想

适配器模式（Adapter Pattern）是一种结构型设计模式，它允许将不兼容的接口转换为客户端期望的另一个接口，在日常生活中，最常见的例子是电源插头转换器——当你的设备插头是两脚圆头，而墙上的插座是三脚扁孔时，转换器就扮演了适配器的角色。

Java案例怎么实现适配器模式？

核心三要素：

目标接口（Target）：客户端期望调用的接口
被适配者（Adaptee）：现有的、需要被适配的类或接口
适配器（Adapter）：实现目标接口，并持有被适配者的引用，完成转换

关键思想：不修改现有代码，通过引入中间层解决接口不兼容问题。

为什么需要适配器模式？真实痛点分析

在Java项目中,以下场景会频繁触发适配器需求：

第三方库集成：不同的支付、短信、邮件服务商提供不同的API
遗留系统重构：老系统的接口无法直接与新模块协作
数据库连接管理：JDBC使用统一接口适配不同数据库驱动
日志框架切换：从Log4j迁移到Logback时接口不同

典型痛点案例： 假设你的系统已经稳定运行了一套内部邮件发送API，突然需要接入阿里云邮件服务，但阿里云的sendEmail(String to, String subject, String body)与你的接口send(String to, String content)参数顺序和名称都不同，如果不做适配，你需要修改大量业务代码——这正是适配器模式大显身手的时刻。

Java适配器模式的三种实现方式

类适配器（通过继承实现）

// 目标接口
interface Target {
    void request();
}
// 被适配者
class Adaptee {
    public void specificRequest() {
        System.out.println("被适配者的方法");
    }
}
// 类适配器
class ClassAdapter extends Adaptee implements Target {
    @Override
    public void request() {
        specificRequest(); // 直接调用父类方法
    }
}

优点：代码简洁，可以重写Adaptee的部分方法
缺点：需要继承，Java单继承限制较大

对象适配器（通过组合实现，推荐）

class ObjectAdapter implements Target {
    private Adaptee adaptee;
    public ObjectAdapter(Adaptee adaptee) {
        this.adaptee = adaptee;
    }
    @Override
    public void request() {
        adaptee.specificRequest();
    }
}

优点：灵活，可以适配多个不同的被适配者
缺点：需要手动创建适配器实例

接口适配器（默认适配模式）

适用于不需要实现接口所有方法时：

interface Service {
    void methodA();
    void methodB();
    void methodC();
}
abstract class ServiceAdapter implements Service {
    public void methodA() {} // 提供空实现
    public void methodB() {}
    public void methodC() {}
}
class ConcreteService extends ServiceAdapter {
    @Override
    public void methodA() {
        System.out.println("只实现需要的方法");
    }
}

经典案例：第三方支付接口适配

需求描述：
假设你的电商平台使用统一的支付接口 PaymentProcessor，现在需要接入支付宝、微信、银联三种不同的支付渠道。

Step 1: 定义统一目标接口

public interface PaymentProcessor {
    Response pay(String orderId, double amount);
    Response refund(String transactionId);
}

Step 2: 现有第三方SDK（被适配者）

public class AlipaySDK {
    public String alipayTradePay(String tradeNo, String totalAmount) {
        return "支付宝交易成功: " + tradeNo;
    }
    public String alipayRefund(String tradeNo) {
        return "支付宝退款成功";
    }
}
public class WechatPaySDK {
    public String wxPay(String orderId, BigDecimal total) {
        return "微信支付成功";
    }
    public String wxRefund(String orderId) {
        return "微信退款成功";
    }
}

Step 3: 创建适配器

public class AlipayAdapter implements PaymentProcessor {
    private AlipaySDK alipaySDK = new AlipaySDK();
    @Override
    public Response pay(String orderId, double amount) {
        String result = alipaySDK.alipayTradePay(orderId, String.valueOf(amount));
        return new Response(true, result);
    }
    @Override
    public Response refund(String transactionId) {
        String result = alipaySDK.alipayRefund(transactionId);
        return new Response(true, result);
    }
}
public class WechatAdapter implements PaymentProcessor {
    private WechatPaySDK wechatPaySDK = new WechatPaySDK();
    @Override
    public Response pay(String orderId, double amount) {
        String result = wechatPaySDK.wxPay(orderId, BigDecimal.valueOf(amount));
        return new Response(true, result);
    }
    // ... 类似实现refund
}

Step 4: 客户端使用

public class PaymentService {
    public void processPayment(PaymentProcessor processor) {
        Response resp = processor.pay("ORDER20231001", 99.99);
        // 统一处理响应
    }
}

效果： 新增银联支付时，只需编写 UnionPayAdapter 即可，无需修改现有业务代码。

案例二：JDBC驱动中的适配器角色

Java的JDBC规范是适配器模式的完美体现。java.sql.Driver 接口是目标接口，不同数据库的驱动类是被适配者。

// 统一的JDBC目标接口
public interface Driver {
    Connection connect(String url, Properties info) throws SQLException;
    boolean acceptsURL(String url) throws SQLException;
}
// MySQL驱动适配器（简化版）
public class com.mysql.cj.jdbc.Driver implements java.sql.Driver {
    @Override
    public Connection connect(String url, Properties info) {
        // 将MySQL特有的连接协议转换为标准Connection
        return new MySQLConnectionImpl(url, info);
    }
}

通过这种适配,开发者只需掌握JDBC标准API，无论底层是MySQL、Oracle还是PostgreSQL，代码编写方式完全相同。

案例三：日志系统统一适配

当公司从Log4j迁移到Logback时,可以通过适配器平滑过渡：

// 定义统一日志接口
public interface Logger {
    void info(String message);
    void error(String message);
}
// Log4j适配器
public class Log4jAdapter implements Logger {
    private org.apache.log4j.Logger log4jLogger;
    public Log4jAdapter(Class<?> clazz) {
        log4jLogger = org.apache.log4j.Logger.getLogger(clazz);
    }
    @Override
    public void info(String message) {
        log4jLogger.info(message);
    }
    // ... 其他方法
}
// Logback适配器
public class LogbackAdapter implements Logger {
    private ch.qos.logback.classic.Logger logbackLogger;
    public LogbackAdapter(Class<?> clazz) {
        logbackLogger = (ch.qos.logback.classic.Logger) 
            LoggerFactory.getLogger(clazz);
    }
    @Override
    public void info(String message) {
        logbackLogger.info(message);
    }
}

适配器模式与装饰器、代理模式的区别

很多开发者容易混淆这三种结构型模式,这里用表格清晰对比：

维度	适配器模式	装饰器模式	代理模式
目的	接口转换	动态增强功能	控制访问或延迟加载
关注点	解决接口不兼容	不改变接口添加行为	不改变接口控制访问
实现方式	包装被适配者	递归包装组件	代理真实对象
典型场景	支付、日志适配	IO流Buffer包装	远程代理、虚拟代理

错误示范识别： 如果支付适配器中增加了“支付成功后发送短信”的功能，这就变成了装饰器模式而非适配器——适配器不应增加新行为，只做接口转换。

高频面试问答与最佳实践

Q1: 什么时候该用类适配器，什么时候该用对象适配器？

A: 绝大多数场景推荐使用对象适配器（组合方式），因为它更灵活，不破坏封装性，可以同时适配多个Adaptee，类适配器仅在需要重写Adaptee的部分方法时考虑，且Java单继承限制会降低其可用性。

Q2: 适配器模式与桥接模式有何区别？

A: 适配器模式主要解决接口不匹配问题，通常在系统构建后、集成外部组件时使用；桥接模式用于分离抽象与实现，允许它们独立变化，通常在系统设计阶段使用，简言之：适配器是事后补救，桥接是预先设计。

Q3: 如何测试适配器？

A: 使用Mockito或JMock模拟被适配者（Adaptee），验证适配器是否按预期调用Adaptee的方法并正确转换参数和返回结果。

@Test
void testAlipayAdapter() {
    AlipaySDK mockSDK = mock(AlipaySDK.class);
    when(mockSDK.alipayTradePay("123", "10.00")).thenReturn("success");
    AlipayAdapter adapter = new AlipayAdapter(mockSDK);
    Response resp = adapter.pay("123", 10.00);
    assertEquals(true, resp.isSuccess());
    verify(mockSDK).alipayTradePay("123", "10.00");
}