Adapter-适配器
##############

.. note:: allows classes with incompatible interfaces to work together by wrapping its own interface around that of an already existing class.将不兼容的接口转换为可兼容的接口，让原本由于接口不兼容而不能一起工作的类可以一起工作。


下面这样 5 种场景会出现接口不兼容呢::

    1. 封装有缺陷的接口设计
    2. 统一多个类的接口设计
    3. 替换依赖的外部系统
    4. 兼容老版本接口
    5. 适配不同格式的数据

.. note:: 适配器模式可以看作一种“补偿模式”，用来补救设计上的缺陷。应用这种模式算是“无奈之举”。




实现方式
========

适配器模式有两种实现方式::

    1. 类适配器(使用继承关系来实现)
    2. 对象适配器(使用组合关系来实现)


实例::

    public interface ITarget {
      void f1();
      void f2();
      void fc();
    }
    public class Adaptee {
      public void fa() { //... }
      public void fb() { //... }
      public void fc() { //... }
    }

方式1-类适配器: 基于继承::

    public class Adaptor extends Adaptee implements ITarget {
      public void f1() {
        super.fa();
      }
      
      public void f2() {
        //...重新实现f2()...
      }
      
      // 这里fc()不需要实现，直接继承自Adaptee，这是跟对象适配器最大的不同点
    }

方式2-对象适配器：基于组合::

    public class Adaptor implements ITarget {
      private Adaptee adaptee;
      
      public Adaptor(Adaptee adaptee) {
        this.adaptee = adaptee;
      }
      
      public void f1() {
        adaptee.fa(); //委托给Adaptee
      }
      
      public void f2() {
        //...重新实现f2()...
      }
      
      public void fc() {
        adaptee.fc();
      }
    }

到底该如何选择使用哪一种实现方式::

    判断的标准主要有两个:
      一个是 Adaptee 接口的个数，
      另一个是 Adaptee 和 ITarget 的契合程度。

    1. 如果 Adaptee 接口并不多，那两种实现方式都可以。
    2. 如果 Adaptee 接口很多，而且 Adaptee 和 ITarget 接口定义大部分都相同，
        推荐使用类适配器
    3. 如果 Adaptee 接口很多，而且 Adaptee 和 ITarget 接口定义大部分都不相同，
        那推荐使用对象适配器，因为组合结构相对于继承更加灵活。









代理/桥接/装饰器/适配器的区别
=============================

共同点::

    它们都可以称为 Wrapper 模式，也就是通过 Wrapper 类二次封装原始类

4 种设计模式的用意完全不同::

    也就是说要解决的问题、应用场景不同，这也是它们的主要区别

    1. 代理模式：
        代理模式在不改变原始类接口的条件下，为原始类定义一个代理类，
        主要目的是控制访问，而非加强功能，这是它跟装饰器模式最大的不同。
    2. 桥接模式：
        桥接模式的目的是将接口部分和实现部分分离，
        从而让它们可以较为容易、也相对独立地加以改变。
    3. 装饰器模式：
        装饰者模式在不改变原始类接口的情况下，对原始类功能进行增强，
        并且支持多个装饰器的嵌套使用。
    4. 适配器模式：
        适配器模式是一种事后的补救策略。
        适配器提供跟原始类不同的接口，而代理模式、装饰器模式提供的都是跟原始类相同的接口。