设计模式之适配器模式

突然想到一句话：“软件开发不存在兼容问题，如果有问题，那么再加一层”。

适配器模式应该是平时业务开发中无论是有意还是无意提到的比较多的一种设计模式。因为业务的变化是非常之快的，所以经常会出现“XXX 需要适配”一下，所以适配器模式也是个比较尴尬的模式，用的好，首先代码的复用性提高了，而且在对原有类不需改变或者改变不大的情况下可以扩展原有功能，从而快速完成新功能的开发，这是符合开闭原则的。但是如果用的不好，代码会杂乱无章，难以阅读，系统复杂度提高。

根据《图解设计模式》中的介绍，适配器模式分为两种：

• 类适配器模式（使用继承的适配器）
• 对象适配器模式（使用委托的适配器）

看一个例子，比如在开发中我们需要读取 Excel 文件的内容。文件读取接口：

public interface FileReader {
    
    String read(String path);
    
}

我们写的读取 Excel 文件的类：

public class ExcelReader implements FileReader {

    @Override
    public String read(String path) {
        return "excel read-->" + path;
    }
}

这时候有需求需要读取 PDF 文件，假设我们这里需要引入第三方依赖 PdfProjetReader：

public class PdfProjetReader {

    public String readPdf(File file) throws FileNotFoundException {
        return "pdf project read -->" + file.getPath();
    }
}

此时 PdfProjetReader 就是被适配者。

类适配器模式

这时候可以创建一个读取 PDF 文件适配器 PdfReadAdaptor：

public class PdfReadAdaptor extends PdfProjetReader implements FileReader{
    
    @Override
    public String read(String path) {
        try {
            return readPdf(new File(path));
        } catch (FileNotFoundException ignored) {
            //todo
           return null;
        }
    }
}

PdfReadAdaptor 继承了 PdfProjetReader 并且实现了 FileReader，从而使用继承的方式进行了方法的适配，测试一下：

public class Test {

    public static void main(String[] args) {
        FileReader excelReader = new ExcelReader();
        System.out.println(excelReader.read("a.xlsx"));
        FileReader pdfReader = new PdfReadAdaptor();
        System.out.println(pdfReader.read("b.pdf"));
    }
}

输出：

excel read-->a.xlsx
pdf project read -->b.pdf

UML 图：

对象适配器模式

将上面的例子改造一下。其中 ExcelReader、FileReader、PdfProjetReader 都不变。创建一个 PDF 文件读取适配器 PdfReadAdaptor2：

public class PdfReadAdaptor2  implements FileReader{
    
    private PdfProjetReader pdfProjetReader;

    @Override
    public String read(String path) {
        try {
            return pdfProjetReader.readPdf(new File(path));
        } catch (FileNotFoundException ignored) {
            //todo
           return null;
        }
    }

    public PdfReadAdaptor2(PdfProjetReader pdfProjetReader) {
        this.pdfProjetReader = pdfProjetReader;
    }
}

这里适配器与 PdfProjetReader 被适配者是组合的关系。测试一下：

public class Test {

    public static void main(String[] args) {
        FileReader excelReader = new ExcelReader();
        System.out.println(excelReader.read("a.xlsx"));
        FileReader pdfReader = new PdfReadAdaptor2(new PdfProjetReader());
        System.out.println(pdfReader.read("b.pdf"));
    }
}

UML 图：

进一步改造

上面两个例子都非常的简单，但是如果文件类型过多，那么还是不够优雅。那么来改造一下。其中 ExcelReader、FileReader、PdfProjetReader 都不变。增加一个 DOC 文件第三方读取依赖：

public class DocProjectReader {

    public String readDoc(File file) throws FileNotFoundException {
        return "doc project read -->" + file.getPath();
    }
}

创建一个扩展的文件适配器：

public interface FileReaderAdaptor {

    /**
     * 返回当前适配器是否支持
     * @param reader
     * @return
     */
    boolean support(Object reader);

    String read(String path);
}

DOC 文件读取适配器：

public class DocReaderAdaptor implements FileReaderAdaptor{

    private DocProjectReader docProjectReader = new DocProjectReader();

    @Override
    public boolean support(Object reader) {
        return reader instanceof DocReaderAdaptor;
    }

    @Override
    public String read(String path) {
        try {
            return docProjectReader.readDoc(new File(path));
        } catch (FileNotFoundException e) {
            return null;
        }
    }
}

PDF 文件读取适配器：

public class PdfReaderAdaptor3 implements FileReaderAdaptor{

    private PdfProjetReader pdfProjetReader = new PdfProjetReader();

    @Override
    public boolean support(Object reader) {
        return reader instanceof PdfReaderAdaptor3;
    }

    @Override
    public String read(String path) {
        try {
            return pdfProjetReader.readPdf(new File(path));
        } catch (FileNotFoundException e) {
            return null;
        }
    }
}

扩展的文件读取器：

public class ExtendFileReader extends ExcelReader {

    //todo 默认 reader

    private FileReaderAdaptor fileReaderAdaptor;

    public String read(String path) {
        if (fileReaderAdaptor.support(fileReaderAdaptor)) {
            return fileReaderAdaptor.read(path);
        }
        return null;
    }

    public ExtendFileReader(FileReaderAdaptor fileReaderAdaptor) {
        this.fileReaderAdaptor = fileReaderAdaptor;
    }

}

测试一下：

public class Test {

    public static void main(String[] args) {
        FileReader exclReader = new ExcelReader();
        System.out.println(exclReader.read("a.xlsx"));
        FileReader docReader = new ExtendFileReader(new DocReaderAdaptor());
        System.out.println(docReader.read("b.doc"));
        FileReader pdfReader = new ExtendFileReader(new PdfReaderAdaptor3());
        System.out.println(pdfReader.read("c.pdf"));

    }
}

在 Spring 中的应用

最熟悉的当属 HandlerAdaptor 了。在 org.springframework.web.servlet.DispatcherServlet#doDispatch 方法中会 调用 org.springframework.web.servlet.DispatcherServlet#getHandlerAdapter 方法获取处理器适配器：

	protected HandlerAdapter getHandlerAdapter(Object handler) throws ServletException {
		if (this.handlerAdapters != null) {
			for (HandlerAdapter adapter : this.handlerAdapters) {
				if (adapter.supports(handler)) {
					return adapter;
				}
			}
		}
		throw new ServletException("No adapter for handler [" + handler +
				"]: The DispatcherServlet configuration needs to include a HandlerAdapter that supports this handler");
	}

这里首先系统会初始化加载所有的处理策略，然后根据 request 获取相应的处理器，从而获取处理器适配器。

References

• 《图解设计模式》

欢迎关注公众号
​​​​​​