适配器模式

 

适配器模式：将一个类的接口转换成客户希望的另外一个接口，适配器模式让原来由于接口不兼容而不能一起工作的那些类可以一起工作。  

使用场景，系统的数据和行为都正确，但接口不符合，我们应该考虑用适配器类，目的是使控制范围之外的一个原有对象与某个接口匹配，适配器模式主要应用于希望复用一些现存的类，但是接口与复用 环境要求不一致的情况。

主要解决：主要解决在软件系统中，常常要将一些"现存的对象"放到新的环境中，而新环境要求的接口是现对象不能满足的。

何时使用： 1、系统需要使用现有的类，而此类的接口不符合系统的需要。 2、想要建立一个可以重复使用的类，用于与一些彼此之间没有太大关联的一些类，包括一些可能在将来引进的类一起工作，这些源类不一定有一致的接口。 3、通过接口转换，将一个类插入另一个类系中。（比如老虎和飞禽，现在多了一个飞虎，在不增加实体的需求下，增加一个适配器，在里面包容一个虎对象，实现飞的接口。）

实例UML图：

 

实例详情：

我们有一个 MediaPlayer 接口和一个实现了 MediaPlayer 接口的实体类 AudioPlayer。默认情况下，AudioPlayer 可以播放 mp3 格式的音频文件。

我们还有另一个接口 AdvancedMediaPlayer 和实现了 AdvancedMediaPlayer 接口的实体类。该类可以播放 vlc 和 mp4 格式的文件。

我们想要让 AudioPlayer 播放其他格式的音频文件。为了实现这个功能，我们需要创建一个实现了 MediaPlayer 接口的适配器类 MediaAdapter，并使用 AdvancedMediaPlayer 对象来播放所需的格式。

AudioPlayer 使用适配器类 MediaAdapter 传递所需的音频类型，不需要知道能播放所需格式音频的实际类。AdapterPatternDemo，我们的演示类使用 AudioPlayer 类来播放各种格式。

代码实现：

/**
 * @author Shuyu.Wang
 * @package:com.shuyu.adapter
 * @description:媒体播放器接口
 * @date 2018-11-25 22:47
 **/

public interface MediaPlayer {
    void play(String audioType, String fileName);
}





/**
 * @author Shuyu.Wang
 * @package:com.shuyu.adapter
 * @description:更高级的媒体播放器创建接口
 * @date 2018-11-25 22:50
 **/

public interface AdvancedMediaPlayer {
     void playVlc(String fileName);
     void playMp4(String fileName);
}

实现类：

/**
 * @author Shuyu.Wang
 * @package:com.shuyu.adapter
 * @description:
 * @date 2018-11-25 22:52
 **/
@Slf4j
public class Mp4Player implements AdvancedMediaPlayer{
    @Override
    public void playVlc(String fileName) {

    }

    @Override
    public void playMp4(String fileName) {
        log.info("Playing mp4 file. Name: "+ fileName);
    }
}




/**
 * @author Shuyu.Wang
 * @package:com.shuyu.adapter
 * @description:
 * @date 2018-11-25 22:50
 **/
@Slf4j
public class VlcPlayer implements AdvancedMediaPlayer {
    @Override
    public void playVlc(String fileName) {
         log.info("Playing vlc file. Name: "+ fileName);
    }

    @Override
    public void playMp4(String fileName) {

    }
}

 

/**
 * @author Shuyu.Wang
 * @package:com.shuyu.adapter
 * @description:实现了 MediaPlayer 接口的适配器类
 * @date 2018-11-25 22:54
 **/

public class MediaAdapter implements MediaPlayer{

    AdvancedMediaPlayer advancedMusicPlayer;

    public MediaAdapter(String type){
        if(type.equalsIgnoreCase("vlc")){
            advancedMusicPlayer=new VlcPlayer();
        }else if (type.equalsIgnoreCase("mp4")){
            advancedMusicPlayer=new Mp4Player();
        }
    }
    @Override
    public void play(String audioType, String fileName) {
         if (audioType.equalsIgnoreCase("vlc")){
             advancedMusicPlayer.playVlc(fileName);
         }else if (audioType.equalsIgnoreCase("mp4")){
             advancedMusicPlayer.playMp4(fileName);
         }
    }
}

/**
 * @author Shuyu.Wang
 * @package:com.shuyu.adapter
 * @description: 实现了 MediaPlayer 接口的实体类
 * @date 2018-11-25 23:12
 **/
@Slf4j
public class AudioPlayer implements MediaPlayer {
    MediaAdapter mediaAdapter;

    @Override
    public void play(String audioType, String fileName) {
//播放 mp3 音乐文件的内置支持
        if (audioType.equalsIgnoreCase("mp3")) {
            log.info("Playing mp3 file. Name: " + fileName);
        }
        //mediaAdapter 提供了播放其他文件格式的支持
        else if (audioType.equalsIgnoreCase("vlc") || audioType.equalsIgnoreCase("mp4")) {
            mediaAdapter = new MediaAdapter(audioType);
            mediaAdapter.play(audioType, fileName);
        } else {
            log.info("Invalid media. " + audioType + " format not supported");
        }
    }
}

测试代码：

@RunWith(SpringRunner.class)
@SpringBootTest
public class AdapterApplicationTests {

	@Test
	public void contextLoads() {

		AudioPlayer audioPlayer = new AudioPlayer();

		audioPlayer.play("mp3", "beyond the horizon.mp3");
		audioPlayer.play("mp4", "alone.mp4");
		audioPlayer.play("vlc", "far far away.vlc");
		audioPlayer.play("avi", "mind me.avi");
	}

}

执行结果如下：

2018-11-25 23:20:21.849  INFO 4576 --- [           main] com.shuyu.adapter.AudioPlayer            : Playing mp3 file. Name: beyond the horizon.mp3
2018-11-25 23:20:21.850  INFO 4576 --- [           main] com.shuyu.adapter.Mp4Player              : Playing mp4 file. Name: alone.mp4
2018-11-25 23:20:21.851  INFO 4576 --- [           main] com.shuyu.adapter.VlcPlayer              : Playing vlc file. Name: far far away.vlc
2018-11-25 23:20:21.851  INFO 4576 --- [           main] com.shuyu.adapter.AudioPlayer            : Invalid media. avi format not supported

 

代码github地址：https://github.com/iot-wangshuyu/designpatterns/tree/master/adapter