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);