适配器模式 rust

适配器模式

适配器模式（Adapter Pattern）是作为两个不兼容的接口之间的桥梁。这种类型的设计模式属于结构型模式，它结合了两个独立接口的功能。

这种模式涉及到一个单一的类，该类负责加入独立的或不兼容的接口功能。举个真实的例子，读卡器是作为内存卡和笔记本之间的适配器。您将内存卡插入读卡器，再将读卡器插入笔记本，这样就可以通过笔记本来读取内存卡。

介绍

• 意图：将一个类的接口转换成客户希望的另外一个接口。适配器模式使得原本由于接口不兼容而不能一起工作的那些类可以一起工作。
• 主要解决：主要解决在软件系统中，常常要将一些"现存的对象"放到新的环境中，而新环境要求的接口是现对象不能满足的。
• 关键代码：适配器继承或依赖已有的对象，实现想要的目标接口。

何时使用

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

应用实例

1、美国电器 110V，中国 220V，就要有一个适配器将 110V 转化为 220V。
2、在 LINUX 上运行 WINDOWS 程序。
3、JAVA 中的 jdbc。

优点

1、可以让任何两个没有关联的类一起运行。
2、提高了类的复用。
3、增加了类的透明度。
4、灵活性好。

缺点

1、过多地使用适配器，会让系统非常零乱，不易整体进行把握。比如，明明看到调用的是 A 接口，其实内部被适配成了 B 接口的实现，一个系统如果太多出现这种情况，无异于一场灾难。因此如果不是很有必要，可以不使用适配器，而是直接对系统进行重构。
2.由于 JAVA 至多继承一个类，所以至多只能适配一个适配者类，而且目标类必须是抽象类。

使用场景

有动机地修改一个正常运行的系统的接口，这时应该考虑使用适配器模式。

实现

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

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

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

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

适配器模式的 UML 图

rust 实现

use std::error::Error;
// 播放器接口
trait  MediaPlayer{
    fn paly(&mut self,audio_type:String, file_name:String);
}
// 适配器接口
trait AdvancedMediaPlayer {
    fn play_vlc(&self ,file_name:String);
    fn play_mp4(&self,file_name:String );
}
// vlc播器放实体类
struct  VlcPlayer {}
impl AdvancedMediaPlayer for VlcPlayer {
    fn play_vlc(&self ,file_name:String) {
        println!("Playing vlc file. Name: {}",file_name)
    }

    fn play_mp4(&self,file_name:String ) {
        todo!()
    }
}
// MP4播放器实体类
struct  Mp4Player {}
impl AdvancedMediaPlayer for Mp4Player {
    fn play_mp4(&self ,file_name:String) {
        println!("Playing mp4 file. Name: {}",file_name)
    }

    fn play_vlc(&self,file_name:String ) {
        todo!()
    }
}
// 播放器适配器实体类
struct MediaAdapter{
    advanced_music_player:Box<dyn AdvancedMediaPlayer>
}
impl MediaPlayer for MediaAdapter {
    fn paly(&mut self,audio_type:String, file_name:String) {
        match &audio_type as &str{
            "vlc"=> self.advanced_music_player.play_vlc(file_name),
            "mp4"=>self.advanced_music_player.play_mp4(file_name),
            _ =>println!("不支持此格式文件")
        }
    }
}
impl MediaAdapter {
    fn new (audio_type:String )->Result<MediaAdapter,Box<dyn Error>>{
        //进行字符产匹配
        match &audio_type as &str{
            "vlc"=> Ok(MediaAdapter{advanced_music_player:Box::new(VlcPlayer{})}),
            "mp4"=>Ok(MediaAdapter{advanced_music_player:Box::new(Mp4Player{})}),
            _ =>Err(panic!("输入运行格式错误"))
        }
    }
}
struct AudioPlayer{
    media_adapter:MediaAdapter 
}
impl AudioPlayer {
    fn new()->AudioPlayer{
        AudioPlayer{media_adapter:MediaAdapter { advanced_music_player:Box::new(Mp4Player{})}}
    }
}
impl  MediaPlayer for AudioPlayer {
    fn paly(&mut self,audio_type:String, file_name:String) {
        match &audio_type as &str{
            "vlc"|"mp4"=>{
                self.media_adapter=MediaAdapter::new(audio_type.clone()).unwrap();
                self.media_adapter.paly(audio_type, file_name);
            },
            _ =>println!("不支持此格式文件")
        }
    }
}
    
fn main() {
    let mut audioPlayer =AudioPlayer::new();
    // 进行不同文件的播放测试
    audioPlayer.paly(String::from("mp3"), String::from("beyond the horizon.mp3"));
    audioPlayer.paly(String::from("mp4"), String::from("alone.mp4"));
    audioPlayer.paly(String::from("mp4"), String::from("far far away.vlc"));
}

rust代码仓库

https://github.com/onenewcode/design.git
本教程项目在bin文件夹下的singleobject.rs文件中