擴充卡模式在 MyBatis 中的妙用，面試可以拿來吹了！

作者：須臾之餘

寫在前面：設計模式源于生活，而又高于生活！

什麼是擴充卡模式

定義：将一個系統的接口轉換成另外一種形式，進而使原來不能直接調用的接口變得可以調用。

擴充卡模式角色劃分

擴充卡模式涉及3個角色：
1.源（Adaptee）：需要被适配的對象或類型，相當于插頭。
2.擴充卡（Adapter）：連接配接目标和源的中間對象，相當于插頭轉換器。
3.目标（Target）：期待得到的目标，相當于插座。
擴充卡模式包括3種形式：類擴充卡模式、對象擴充卡模式、接口擴充卡模式（或又稱作預設擴充卡模式）。      

擴充卡模式應用場景

1、新老版本接口的相容
2、Mybatis多種日志架構的整合      

擴充卡建立的方式

1.對象擴充卡(組合模式)
2.類擴充卡(繼承模式)      

擴充卡快速入門例子

比如早期的時候 V1 版本訂單接口的入參為 Map 類型，随着業務的更新和疊代在 V2 版本的時候該訂單接口的入參需要支援 List 的類型？ 請問不改變的該接口代碼的情況下，如何支援 List 類型。

1. 源（Adaptee）：需要被适配的對象或類型，相當于插頭。

public void froOrderMap(Map map) {
    for (int i = 0; i < map.size(); i++) {
        // 使用I作為MapKey擷取資料
        String value = (String) map.get(i);
        System.out.println("value:" + value);
    }
}      

2. 目标（Target）：期待得到的目标，相當于插座。

public interface List<E> extends Collection<E> {
    ......
    int size();
    E get(int index);
    E set(int index, E element);
}      

3. 擴充卡（Adapter）：連接配接目标和源的中間對象，相當于插頭轉換器

public class ListAdapter extends HashMap {

    private List list;
    public ListAdapter(List list) {
        this.list = list;
    }
    @Override
    public int size() {
        return list.size();
    }
    @Override
    public Object get(Object key) {
        return list.get(Integer.valueOf(key.toString()).intValue());
    }
}      

測試運作效果

public class Test {
    public static void main(String[] args) {
        // 1.擷取集合類型使用者
        List member = new MemberService().getMember();
        //new OrderService().froOrderMap(member);
        ListAdapter listAdapter = new ListAdapter(member);
        new OrderService().froOrderMap(listAdapter);
    }
}      

使用擴充卡模式實作日志收集

比如設計一個日志收集系統，可能會考慮檔案寫入、也可能考慮寫入 MQ、也可能考慮寫入資料庫等。

對象擴充卡方式實作

定義基本實體類

@Data
public class LogBean {
    /**
     * 日志ID
     */
    private String logId;
    /**
     * 日志内容
     */
    private String logText;
}      

1. 源目标接口

public interface LogWriteFileService {

    /**
     * 将日志寫入到檔案中
     */
    void logWriteFile();
    /**
     * 從本地檔案中讀取日志
     *
     * @return
     */
    List<LogBean> readLogFile();
}      

1. 源目标接口實作類

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<LogBean>();
        listArrayList.add(log1);
        listArrayList.add(log2);
        return listArrayList;
    }
}      

2. 目标接口

public interface LogWriteDbService {

    /**
     * 将日志寫入到資料庫中
     */
   public void writeDbFile(LogBean logBean);
}      

2. 擴充卡

//LogAdapter ：擴充卡
//LogWriteDbService：目标
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();
    }
}      

擴充卡模式優缺點

擴充卡模式的優點
　　更好的複用性
系統需要使用現有的類，而此類的接口不符合系統的需要。那麼通過擴充卡模式就可以讓這些功能得到更好的複用。
更好的擴充性
在實作擴充卡功能的時候，可以調用自己開發的功能，進而自然地擴充系統的功能。

擴充卡模式的缺點
　　過多的使用擴充卡，會讓系統非常零亂，不易整體進行把握。比如，明明看到調用的是A接口，其實内部被适配成了B接口的實作，一個系統如果太多出現這種情況，無異于一場災難。是以如果不是很有必要，可以不使用擴充卡，而是直接對系統進行重構。      

Mbatis 日志收集分析

Java開發中經常用到的日志架構有很多，Log4j、Log4j2、slf4j等等，Mybatis定義了一套統一的日志接口供上層使用，并為上述常用的日志架構提供了相應的擴充卡

在Mybatis的日志子產品中就是使用了擴充卡模式。Mybatis内部在使用日志子產品時，使用了其内部接口 org.apache.ibatis.logging.Log,但是常用的日志架構的對外接口各不相同，Mybatis為了複用和內建這些第三方日志元件，在其日志子產品中，提供了多種Adapter,将這些第三方日志元件對外接口适配成org.apache.ibatis.logging.Log，這樣Myabtis 就可以通過Log接口調用第三方日志了      

源碼分析圖

源碼剖析

Mybatis Log 接口：相當于源接口

package org.apache.ibatis.logging;

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

Mybatis 源接口實作類

擴充卡第一種

package org.apache.ibatis.logging.slf4j;

import org.apache.ibatis.logging.Log;
import org.slf4j.Logger;

//Slf4jLoggerImpl ：相當于擴充卡
//Log ：相當于源接口
class Slf4jLoggerImpl implements Log {

  //Logger：相當于目标接口
  private Logger log;

  public Slf4jLoggerImpl(Logger logger) {
    //源=目标
    log = logger;
  }      

擴充卡第二種

package org.apache.ibatis.logging.log4j2;

import org.apache.ibatis.logging.Log;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.spi.AbstractLogger;
//Log4j2Impl ：相當于擴充卡
//Log ：相當于源接口
public class Log4j2Impl implements Log {

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

目标接口：Logger