Java 适配器模式从入门到实战指南

/**
 * 1. 目标接口（Target）：新系统期望的接口（返回JSON格式）
 * 调用方（前端）只关注这个接口，无需关心适配逻辑
 */
public interface OrderJsonService {
    // 目标方法：查询订单，返回JSON字符串
    String queryOrderJson(String orderNo);
}
/**
 * 2. 适配者（Adaptee）：需要被适配的旧接口（返回XML格式）
 * 假设这个类是旧系统代码，不能修改
 */
public class OrderXmlService {
    // 适配者方法：查询订单，返回XML字符串
    public String queryOrderXml(String orderNo) {
        // 模拟旧系统业务逻辑，返回XML格式数据
        return "<order><orderNo>" + orderNo + "</orderNo><amount>199.9</amount></order>";
    }
}

/**
 * 类适配器：继承适配者（OrderXmlService），实现目标接口（OrderJsonService）
 * 缺点：因Java单继承特性，适配器无法继承其他类，耦合度较高，实际开发中较少使用
 */
public class OrderClassAdapter extends OrderXmlService implements OrderJsonService {
    @Override
    public String queryOrderJson(String orderNo) {
        // 1. 调用适配者（旧接口）的方法，获取XML数据
        String xmlData = super.queryOrderXml(orderNo);
        // 2. 核心：将XML格式转换为JSON格式（模拟转换逻辑，实际开发中可用FastJSON等工具）
        String jsonData = xmlToJson(xmlData);
        // 3. 返回JSON数据，满足目标接口要求
        return jsonData;
    }
    // 模拟XML转JSON的工具方法（实际开发中可使用第三方工具类）
    private String xmlToJson(String xml) {
        // 简化逻辑，实际需解析XML节点
        String orderNo = xml.substring(xml.indexOf("<orderNo>") + 9, xml.indexOf("</orderNo>"));
        String amount = xml.substring(xml.indexOf("<amount>") + 8, xml.indexOf("</amount>"));
        return "{\"orderNo\":\"" + orderNo + "\",\"amount\":" + amount + "}";
    }
}

/**
 * 类适配器测试类
 */
public class ClassAdapterTest {
    public static void main(String[] args) {
        // 调用方直接使用目标接口，无需关心适配细节
        OrderJsonService orderService = new OrderClassAdapter();
        // 调用目标方法，获取JSON格式数据
        String json = orderService.queryOrderJson("ORDER20260415001");
        System.out.println("类适配器返回JSON：" + json);
    }
}

/**
 * 对象适配器：持有适配者引用，实现目标接口（推荐使用）
 * 优点：不依赖继承，耦合度低，可适配多个适配者，扩展性强
 */
public class OrderObjectAdapter implements OrderJsonService {
    // 持有适配者引用（通过构造方法注入，便于扩展和测试）
    private OrderXmlService orderXmlService;
    // 构造方法：注入适配者实例
    public OrderObjectAdapter(OrderXmlService orderXmlService) {
        this.orderXmlService = orderXmlService;
    }
    @Override
    public String queryOrderJson(String orderNo) {
        // 1. 调用适配者（旧接口）的方法，获取XML数据
        String xmlData = orderXmlService.queryOrderXml(orderNo);
        // 2. XML转JSON（复用工具方法）
        String jsonData = xmlToJson(xmlData);
        // 3. 返回JSON数据
        return jsonData;
    }
    // 复用XML转JSON工具方法
    private String xmlToJson(String xml) {
        String orderNo = xml.substring(xml.indexOf("<orderNo>") + 9, xml.indexOf("</orderNo>"));
        String amount = xml.substring(xml.indexOf("<amount>") + 8, xml.indexOf("</amount>"));
        return "{\"orderNo\":\"" + orderNo + "\",\"amount\":" + amount + "}";
    }
}

/**
 * 对象适配器测试类（企业开发常用）
 */
public class ObjectAdapterTest {
    public static void main(String[] args) {
        // 1. 创建适配者实例（旧接口）
        OrderXmlService xmlService = new OrderXmlService();
        // 2. 创建适配器，注入适配者
        OrderJsonService orderService = new OrderObjectAdapter(xmlService);
        // 3. 调用目标方法，获取JSON数据
        String json = orderService.queryOrderJson("ORDER20260415002");
        System.out.println("对象适配器返回JSON：" + json);
    }
}

/**
 * 目标接口（方法较多，调用方只需要部分方法）
 * 模拟一个复杂的订单接口，包含多个方法
 */
public interface OrderService {
    // 方法1：查询订单（JSON格式）
    String queryOrderJson(String orderNo);
    // 方法2：查询订单（XML格式，备用）
    String queryOrderXml(String orderNo);
    // 方法3：取消订单
    boolean cancelOrder(String orderNo);
    // 方法4：修改订单金额
    boolean updateOrderAmount(String orderNo, double amount);
}
/**
 * 接口适配器：抽象类，实现目标接口，空实现所有方法
 * 作用：避免调用方实现不必要的方法，简化开发
 */
public abstract class OrderInterfaceAdapter implements OrderService {
    // 空实现所有方法，调用方按需重写
    @Override
    public String queryOrderJson(String orderNo) {
        return null;
    }
    @Override
    public String queryOrderXml(String orderNo) {
        return null;
    }
    @Override
    public boolean cancelOrder(String orderNo) {
        return false;
    }
    @Override
    public boolean updateOrderAmount(String orderNo, double amount) {
        return false;
    }
}
/**
 * 调用方：只需要使用“查询订单JSON”和“取消订单”方法
 * 继承接口适配器，只重写需要的方法，无需实现所有方法
 */
public class OrderClientAdapter extends OrderInterfaceAdapter {
    // 持有适配者引用（旧接口）
    private OrderXmlService orderXmlService;
    public OrderClientAdapter(OrderXmlService orderXmlService) {
        this.orderXmlService = orderXmlService;
    }
    // 重写需要的方法1：查询订单JSON
    @Override
    public String queryOrderJson(String orderNo) {
        String xmlData = orderXmlService.queryOrderXml(orderNo);
        return xmlToJson(xmlData);
    }
    // 重写需要的方法2：取消订单
    @Override
    public boolean cancelOrder(String orderNo) {
        // 模拟取消订单逻辑
        System.out.println("取消订单：" + orderNo);
        return true;
    }
    // XML转JSON工具方法
    private String xmlToJson(String xml) {
        String orderNo = xml.substring(xml.indexOf("<orderNo>") + 9, xml.indexOf("</orderNo>"));
        String amount = xml.substring(xml.indexOf("<amount>") + 8, xml.indexOf("</amount>"));
        return "{\"orderNo\":\"" + orderNo + "\",\"amount\":" + amount + "}";
    }
}

/**
 * 接口适配器测试类
 */
public class InterfaceAdapterTest {
    public static void main(String[] args) {
        OrderXmlService xmlService = new OrderXmlService();
        OrderService orderService = new OrderClientAdapter(xmlService);
        // 调用重写的方法
        String json = orderService.queryOrderJson("ORDER20260415003");
        boolean cancel = orderService.cancelOrder("ORDER20260415003");
        System.out.println("接口适配器返回JSON：" + json);
        System.out.println("订单取消结果：" + cancel);
        // 未重写的方法，调用抽象适配器的空实现（返回null/false）
        System.out.println(orderService.queryOrderXml("ORDER20260415003"));
    }
}

/**
 * 项目内部目标接口：支付接口（项目统一规范）
 */
public interface PayService {
    // 项目内部支付方法：参数为订单号、金额，返回支付结果（JSON）
    String pay(String orderNo, double amount);
}

/**
 * 适配者：第三方支付宝SDK接口（无法修改）
 * 接口规范与项目内部PayService不兼容
 */
public class AlipaySdk {
    // 第三方SDK支付方法：参数为订单信息（JSON），返回支付结果（XML）
    public String alipay(String orderInfo) {
        // 模拟第三方SDK支付逻辑
        System.out.println("第三方支付宝SDK支付：" + orderInfo);
        return "<result><orderNo>{orderNo}</orderNo><status>success</status></result>";
    }
}

import org.springframework.stereotype.Component;
// 适配者交给Spring管理（第三方SDK实例）
@Component
public class AlipaySdk {
    public String alipay(String orderInfo) {
        System.out.println("第三方支付宝SDK支付：" + orderInfo);
        return "<result><orderNo>{orderNo}</orderNo><status>success</status></result>";
    }
}
// 适配器交给Spring管理，实现目标接口
@Component
public class AlipayAdapter implements PayService {
    // Autowired注入适配者（第三方SDK实例），无需手动new
    @Autowired
    private AlipaySdk alipaySdk;
    @Override
    public String pay(String orderNo, double amount) {
        // 1. 项目内部参数（订单号、金额）转换为第三方SDK需要的参数（JSON）
        String orderInfo = "{\"orderNo\":\"" + orderNo + "\",\"amount\":" + amount + "}";
        // 2. 调用第三方SDK的方法，获取XML格式结果
        String xmlResult = alipaySdk.alipay(orderInfo);
        // 3. 将XML结果转换为项目内部需要的JSON格式
        String jsonResult = xmlToJson(xmlResult, orderNo);
        // 4. 返回项目内部规范的结果
        return jsonResult;
    }
    // 模拟XML转JSON（实际开发中使用FastJSON、Jackson等工具）
    private String xmlToJson(String xml, String orderNo) {
        return "{\"orderNo\":\"" + orderNo + "\",\"status\":\"success\",\"message\":\"支付成功\"}";
    }
}

import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.ComponentScan;
// Spring配置类：扫描组件（替代XML配置，避免链接失效）
@ComponentScan("com.example.adapter")
public class SpringConfig {
}
// 客户端调用（企业开发常用）
public class SpringAdapterClient {
    public static void main(String[] args) {
        // 加载Spring配置，获取容器（注解配置，无XML，避免链接失效）
        ApplicationContext context = new AnnotationConfigApplicationContext(SpringConfig.class);
        // 获取目标接口实例（Spring自动注入适配器）
        PayService payService = context.getBean(PayService.class);
        // 调用项目内部接口，底层自动通过适配器对接第三方SDK
        String result = payService.pay("ORDER20260415004", 299.9);
        System.out.println("项目内部支付结果：" + result);
    }
}

// 示例：InputStreamReader（字节流转字符流，适配器模式）
InputStream inputStream = new FileInputStream("test.txt");
// InputStreamReader是适配器，将字节流适配为字符流
Reader reader = new InputStreamReader(inputStream, StandardCharsets.UTF_8);