关于Java适配器模式，你该了解这些_adpterservice

适配器模式（Adapter）指的是将一个类的接口转换成另一个可以兼容的接口。比如我们日常生活中的转换头、古早时期使用的电池万能充，就相当于程序中使用的适配器模式。

一、适配器模式的介绍

1.1 适配器模式的结构

适配器模式模式主要分为类结构型模式和对象结构型模式两种：

1.1.1 类适配器模式

类适配器模式通过多重继承，将一个接口与另一个接口进行匹配。而对于一些面向对象语言如C#、Java不支持多重继承，那么我们就可以继承一个类，同时实现多个接口来达到适配器的效果。如下图所示：

• Adaptee：适配者类，它是需要被访问的、需要被适配的组件
• Target：目标接口，当前系统业务所使用的接口，可以是抽象类或接口
• Adapter：适配器类，通过继承和实现目标接口，让客户端按照目标接口的方法访问适配者
• Client：客户端，适配器的使用者

1.1.2 对象适配器模式

对象适配器模式相对于类适配器的不同点在于，对象适配器中适配者类和适配器类的耦合度要更低。如下图所示：

• Adaptee：适配者类，它是需要被访问的、需要被适配的组件
• Target：目标接口，当前系统业务所使用的接口，可以是抽象类或接口
• Adapter：适配器类，通过聚合和实现目标接口，让客户端按照目标接口的方法访问适配者
• Client：客户端，适配器的使用者

1.2 适配器模式的应用实现

我们可以根据上面两种模式分别进行实现：

1.2.1 类适配器实现代码

//适配者类
public class Adaptee {
    public void specificRequest(){
        System.out.println("我是适配者类");
    }
}
//目标接口
public interface Target {
    public void request();
}
//适配器类
public class Adapter extends Adaptee implements Target{
    @Override
    public void request() {
        specificRequest();
    }
}
//客户端类
public class Client {
    public static void main(String[] args) {
        Target target = new Adapter();
        target.request();
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

1.2.2 对象适配器实现代码

//适配者类
public class Adaptee {
    public void specificRequest(){
        System.out.println("我是适配者类");
    }
}
//对象适配器类
public class ObjectAdapter implements Target{

    private Adaptee adaptee;

    public ObjectAdapter(Adaptee adaptee) {
        this.adaptee = adaptee;
    }

    @Override
    public void request() {
        adaptee.specificRequest();
    }
}
//客户端类
public class Client {
    public static void main(String[] args) {
        Adaptee adaptee = new Adaptee();
        Target target = new ObjectAdapter(adaptee);
        target.request();
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

我们发现，对象适配器模式是在适配器类中引入了适配者，这样就利用聚合的方式将两个类连接在一起。而根据设计原则，聚合优先于继承，所以在我们日常的使用中，应该多选择对象适配器模式。

三、适配器的应用场景

3.1 MyBatis中的日志适配应用

在MyBatis 中的典型代表是日志模块，比如其中适配了slf4j、Apache Commons Logging、Log4j2和JDK logging等的日志类型，下面来看看具体实现：

//统一的Log接口
public interface Log {
  boolean isDebugEnabled();
  boolean isTraceEnabled();
  void error(String s, Throwable e);
  void error(String s);
  void debug(String s);
  void trace(String s);
  void warn(String s);
}
1
2
3
4
5
6
7
8
9
10

MyBatis 定义了多个日志类型的适配器，以Log4j2实现为例：

public class Log4j2Impl implements Log {

  private final Log log;

  public Log4j2Impl(String clazz) {
    Logger logger = LogManager.getLogger(clazz);
    if (logger instanceof AbstractLogger) {
      log = new Log4j2AbstractLoggerImpl((AbstractLogger) logger);
    } else {
      log = new Log4j2LoggerImpl(logger);
    }
  }

  @Override
  public boolean isDebugEnabled() {
    return log.isDebugEnabled();
  }

  @Override
  public boolean isTraceEnabled() {
    return log.isTraceEnabled();
  }

  @Override
  public void error(String s, Throwable e) {
    log.error(s, e);
  }

  @Override
  public void error(String s) {
    log.error(s);
  }

  @Override
  public void debug(String s) {
    log.debug(s);
  }

  @Override
  public void trace(String s) {
    log.trace(s);
  }

  @Override
  public void warn(String s) {
    log.warn(s);
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

所以在项目添加Log4j2后，就可以直接使用它打印MyBatis的日志信息。

3.2 营销系统中的各种MQ消息或接口的适配应用

3.2.1 代码工程介绍

在营销系统中系统会接收各种各样的MQ消息或接口，比如有邀请用户、内部订单、外部订单的消息。这个时候就可以利用适配器模式对这些MQ消息进行适配。如下图所示：

代码目录结构如下：

src
 ├─main
 │  ├─java
 │  │  └─cn
 │  │      └─ethan
 │  │          └─design
 │  │              │  OrderAdapterService.java
 │  │              │
 │  │              ├─adapter
 │  │              │      MQAdapter.java
 │  │              │      RebateInfo.java
 │  │              │
 │  │              ├─impl
 │  │              │      InsideOrderService.java
 │  │              │      POPOrderAdapterService.java
 │  │              │
 │  │              ├─mq
 │  │              │      create_account.java
 │  │              │      OrderMq.java
 │  │              │      POPOrderDelivered.java
 │  │              │
 │  │              └─service
 │  │                      OrderService.java
 │  │                      POPOrderService.java
 │  │
 │  └─resources
 └─test
      └─java
              ApiTest.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

• mq和service 目录中是MQ消息类型和提供的服务
• adapter目录中是适配MQ消息体和一些属性信息
• service目录中是模拟的接口适配

3.2.2 代码实现

1. MQ消息体和属性信息适配

//MQ属性信息适配
public class RebateInfo {

    private String userId;
    private String bizId;
    private Date bizTime;
    private String desc;
}
//MQ消息体适配，将不同MQ的各种属性，映射成我们需要的属性并返回
public class MQAdapter {

    public static RebateInfo filter(String strJson, Map<String, String> link) throws NoSuchMethodException, InvocationTargetException, IllegalAccessException {
        return filter(JSON.parseObject(strJson, Map.class), link);
    }

    public static RebateInfo filter(Map obj, Map<String, String> link) throws NoSuchMethodException, InvocationTargetException, IllegalAccessException {
        RebateInfo rebateInfo = new RebateInfo();
        for (String key : link.keySet()) {
            Object val = obj.get(link.get(key));
            RebateInfo.class.getMethod("set" + key.substring(0, 1).toUpperCase() + key.substring(1), String.class).invoke(rebateInfo, val.toString());
        }
        return rebateInfo;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

2. 接口服务适配

提供了两个接口，一个是直接判断是否首单，另外一个需要根据订单数量进行判断。定义统一的适配接口：

//统一适配接口
public interface OrderAdapterService {

    boolean isFirst(String uId);
}
//内部商品接口
public class InsideOrderService implements OrderAdapterService {

    private OrderService orderService = new OrderService();

    @Override
    public boolean isFirst(String uId) {
        return orderService.queryUserOrderCount(uId) <= 1;
    }
}
//第三方商品接口
public class POPOrderAdapterService implements OrderAdapterService {

    private POPOrderService popOrderService = new POPOrderService();

    @Override
    public boolean isFirst(String uId) {
        return popOrderService.isFirstOrder(uId);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

最后进行测试

public class ApiTest {

    @Test
    public void test_MQAdapter() throws ParseException, NoSuchMethodException, IllegalAccessException, InvocationTargetException {
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        Date parse = simpleDateFormat.parse("2022-3-29 23:09:17");

        create_account create_account = new create_account();
        create_account.setNumber("100001");
        create_account.setAddress("河北省.廊坊市.广阳区.大学里职业技术学院");
        create_account.setAccountDate(parse);
        create_account.setDesc("在校开户");

        HashMap<String, String> link01 = new HashMap<>();
        link01.put("userId", "number");
        link01.put("bizId", "number");
        link01.put("bizTime", "accountDate");
        link01.put("desc", "desc");
        RebateInfo rebateInfo01 = MQAdapter.filter(create_account.toString(), link01);
        System.out.println("mq.create_account(适配前)" + create_account.toString());
        System.out.println("mq.create_account(适配后)" + JSON.toJSONString(rebateInfo01));

        OrderMq orderMq = new OrderMq();
        orderMq.setUid("100001");
        orderMq.setSku("10928092093111123");
        orderMq.setOrderId("100000890193847111");
        orderMq.setCreateOrderTime(parse);

        HashMap<String, String> link02 = new HashMap<String, String>();
        link02.put("userId", "uid");
        link02.put("bizId", "orderId");
        link02.put("bizTime", "createOrderTime");
        RebateInfo rebateInfo02 = MQAdapter.filter(orderMq.toString(), link02);
        System.out.println("mq.orderMq(适配前)" + orderMq.toString());
        System.out.println("mq.orderMq(适配后)" + JSON.toJSONString(rebateInfo02));
    }

    @Test
    public void test_itfAdapter() {
        OrderAdapterService popOrderAdapterService = new POPOrderAdapterService();
        System.out.println("判断首单，接口适配(POP)：" + popOrderAdapterService.isFirst("100001"));

        OrderAdapterService insideOrderService = new InsideOrderService();
        System.out.println("判断首单，接口适配(自营)：" + insideOrderService.isFirst("100001"));
    }

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

测试结果如下：

mq.create_account(适配前){"accountDate":1648566557000,"address":"河北省.廊坊市.广阳区.大学里职业技术学院","desc":"在校开户","number":"100001"}
mq.create_account(适配后){"bizId":"100001","bizTime":1591077840669,"desc":"在校开户","userId":"100001"}
mq.orderMq(适配前){"createOrderTime":1648566557000,"orderId":"100000890193847111","sku":"10928092093111123","uid":"100001"}
mq.orderMq(适配后){"bizId":"100000890193847111","bizTime":1591077840669,"userId":"100001"}
---------------------------------------------------------------------------------
13:12:20.335 [main] INFO  c.e.design.service.POPOrderService - POP商家，查询⽤户的订单是否为⾸单：100001
判断首单，接口适配(POP)：true
13:12:20.339 [main] INFO  cn.ethan.design.service.OrderService - 自营商家，查询用户的订单是否为首单：100001
判断首单，接口适配(自营)：false
1
2
3
4
5
6
7
8
9

参考资料

《重学Java设计模式》

https://kaiwu.lagou.com/course/courseInfo.htm?courseId=59#/detail/pc?id=1773