设计模式精讲：适配器模式的原理与 Java 实现

测试运行效果如下：

public class Test {
    public static void main(String[] args) {
        // 1. 获取集合类型用户
        List member = new MemberService().getMember();
        
        // 2. 创建适配器，将 List 包装成 Map 风格
        ListAdapter listAdapter = new ListAdapter(member);
        
        // 3. 调用原有接口，适配器自动完成转换
        new OrderService().froOrderMap(listAdapter);
    }
}

实战案例：日志收集系统

设计一个日志收集系统，可能需要写入文件、MQ 或数据库。为了统一接口，我们定义一个标准的目标接口 LogWriteDbService，并通过适配器将现有的文件服务适配过去。

1. 定义基本实体与接口

public class LogBean {
    private String logId;
    private String logText;

    public String getLogId() { return logId; }
    public String getLogText() { return logText; }
    public void setLogId(String logId) { this.logId = logId; }
    public void setLogText(String logText) { this.logText = logText; }
}

public interface LogWriteFileService {
    void logWriteFile();
    List<LogBean> readLogFile();
}

public class LogWriteFileServiceImpl implements LogWriteFileService {
    @Override
    public void logWriteFile() {
        System.out.println(">>>将日志写入文件中...");
    }

    @Override
    public List<LogBean> readLogFile() {
        LogBean log1 = new LogBean();
        log1.setLogId("0001");
        log1.setLogText("Tomcat 启动成功..");
        
        LogBean log2 = new LogBean();
        log2.setLogId("0002");
        log2.setLogText("Jetty 启动成功..");
        
        List<LogBean> listArrayList = new ArrayList<>();
        listArrayList.add(log1);
        listArrayList.add(log2);
        return listArrayList;
    }
}

2. 对象适配器实现

对象适配器通过组合的方式，将源对象注入适配器中，实现目标接口。

public class LogAdapter implements LogWriteDbService {
    private LogWriteFileService logWriteFileService;

    public LogAdapter(LogWriteFileService logWriteFileService) {
        this.logWriteFileService = logWriteFileService;
    }

    @Override
    public void writeDbFile(LogBean logBean) {
        // 1. 从文件中读取日志文件
        List<LogBean> logBeans = logWriteFileService.readLogFile();
        // 2. 写入到数据库中
        logBeans.add(logBean);
        System.out.println(">>>将数据写入到数据库中..");
        // 3. 写入到本地文件中
        logWriteFileService.logWriteFile();
    }
}

3. 类适配器实现

类适配器直接继承源类，实现目标接口。这种方式在 Java 中受限于单继承特性，不如对象适配器灵活，但在某些场景下更轻量。

public class ClassAdapter extends LogWriteFileServiceImpl implements LogWriteDbService {
    @Override
    public void writeDbFile(LogBean logBean) {
        // 1. 从文件中读取日志文件
        List<LogBean> logBeans = readLogFile();
        // 2. 写入到数据库中
        logBeans.add(logBean);
        System.out.println(">>>将数据写入到数据库中..");
        // 3. 写入到本地文件中
        logWriteFile();
    }
}

MyBatis 日志收集分析

Java 开发中常用的日志框架有 Log4j、Log4j2、SLF4J 等。MyBatis 定义了一套统一的日志接口供上层使用，并为上述常用框架提供了相应的适配器。

在 MyBatis 的日志模块中，内部使用了 org.apache.ibatis.logging.Log 接口。由于第三方日志框架的对外接口各不相同，MyBatis 为了复用和集成这些组件，在其日志模块中提供了多种 Adapter，将这些第三方日志组件的接口适配成 org.apache.ibatis.logging.Log。这样 MyBatis 就可以通过统一的 Log 接口调用第三方日志了。在这里，MyBatis 内部的统一日志接口对应适配器模式中的源，而各类第三方日志系统提供的 Logger 对应目标，MyBatis 提供的各类 Adapter 则负责兼容这两者。

在实际开发中，合理使用适配器模式能有效降低耦合度，但也要警惕过度设计带来的维护成本。