生活中的适配器模式——身高不够鞋来凑

【故事剧情】

春节对每一个中国人来说都是最重要的节日,春节才算是真正的过年,因为它意味着家人的团圆,故土的重温!Tony也是一样,自己在北京漂泊,哥哥姐姐也在外地工作,只有爸妈在老家,一大家子人只有在这时才能全部团聚在一起。

过年大家聚在一起,一定是要拍照的,当然也少不了全家福。拍全家福时,一种最经典的姿势:爸爸妈妈并排坐在最前面,兄弟姐妹并排站在后面,小孩子爸爸妈抱着或站在他们两侧…… 拍照时姐姐就站在我边上,平时没太在在意,当挤平站着的时候才注意到,她好像还挺高的!于是有了一下这样段对话。
Tony:姐,你有多高?
姐姐:我1米55啊,你不是知道吗?怎么,想嘲笑我啊!
Tony:不是不是,看着你挺高的,完全不像是1米55,感觉至少1米65啊!
姐姐:哈哈!因为今天穿着高跟鞋呗,身高不够鞋来凑!谁叫你姐我长的瘦,所以看着高啊!

"身高不够鞋来凑!" 这句话以前也没少听过,但真正发生在最亲的人身上时,Tony才意识到:高跟鞋对于一些女孩来说是多么重要,真是一双鞋拯救整个身材啊!

生活中的适配器模式——身高不够鞋来凑

用程序来模拟生活

身材苗条、长像出众是每个人梦寐以求的,尤其是女孩子!但很多人却因为先天的原因并不能如意,这时就需要通过服装、化妆去弥补。所谓美女,三分靠长相七分靠打扮!比如身高不够,就可以通过穿高跟鞋让你看起来显得高一点;如果你本身就比较高,那穿不穿高跟鞋就没那么重要了。这里高跟鞋就起着一个适配的作用,能让你的形象增高四五厘米,下面我们就用代码来模拟一下高跟鞋在生活中的场景吧!

源码示例:

class IHightPerson:
    "接口类,提供空实现的方法,由子类去实现"

    def getName(self):
        "获取姓名"
        pass

    def getHeight(self):
        "获取身高"
        pass


class HighPerson(IHightPerson):
    "个高的人"

    def __init__(self, name):
        self.__name = name

    def getName(self):
        return self.__name

    def getHeight(self):
        return 170

class ShortPerson:
    "个矮的人"

    def __init__(self, name):
        self.__name = name

    def getName(self):
        return self.__name

    def getRealHeight(self):
        return 160

    def getShoesHeight(self):
        return 6

class DecoratePerson(ShortPerson, IHightPerson):
    "有高跟鞋搭配的人"

    def getHeight(self):
        return super().getRealHeight() + super().getShoesHeight()

测试代码:

def canPlayReceptionist(person):
    """
    是否可以成为(高级酒店)接待员
    :param person: IHightPerson的对象
    :return: 是否符合做接待员的条件
    """
    return person.getHeight() >= 165;


def testPerson():
    lira = HighPerson("Lira")
    print(lira.getName() + "身高" + str(lira.getHeight()) + ",完美如你,天生的美女!" )
    print("是否适合做接待员:", "符合" if canPlayReceptionist(lira) else "不符合")
    print()
    demi = DecoratePerson("Demi");
    print(demi.getName() + "身高" + str(demi.getHeight()) + "在高跟鞋的适配下,你身高不输高圆圆,气质不输范冰冰!")
    print("是否适合做接待员:", "符合" if canPlayReceptionist(lira) else "不符合")

输出结果:

Lira身高170,完美如你,天生的美女!
是否适合做接待员: 符合

Demi身高166在高跟鞋的适配下,你身高不输高圆圆,气质不输范冰冰!
是否适合做接待员: 符合

从剧情中思考适配器模式

上面的例子中,高跟鞋起着一个适配的作用, 让你的形象增高5-7厘米,完全不在话下,而且效果立竿见影!使得一些女孩原本不符合接待员的真实身高,在鞋子的帮助下也能符合条件。如高跟鞋一样,使原本不匹配某种功能的对象变得匹配这种功能,这在程序中就叫做适配器模式。

适配器模式

Convert the interface of a class into another interface clients expect. Adapter lets classes work together that couldn't otherwise because of incompatible interfaces.
将一个类的接口变成客户端所期望的另一种接口,从而使原本因接口不匹配而无法一起工作的两个类能够在一起工作。

适配器模式的作用:

  1. 接口转换,将原有的接口(或方法)转换成另一种接口;
  2. 用新的接口包装一个已有的类;
  3. 匹配一个老的组件到一个新的接口。

设计思想

适配器模式又叫变压器模式,也叫包装模式(Wrapper),它的核心思想是将一个对象经过包装或转换后使它符合指定的接口,使得调用方可以像使用这接口的一般对象一样使用它。这一思想,在我们生活中可谓是处处可见,比如变压器插座,能让你像使用国内电器一样使用美标(110V)电器;还有就是各种转接头,如MiniDP转HDMI转接头、HDMI转VGA线转换器、Micro USB转Type-C转接头等。

你们知道吗?“设计模式”一词最初是来源于建筑领域,而中国古建筑是世界建筑史的一大奇迹(如最具代表性的紫禁城),中国古建筑的灵魂是一种叫榫卯结构的建造理念。

榫卯(sǔn mǎo)是两个木构件上所采用的一种凹凸结合的连接方式。凸出部分叫榫(或榫头);凹进部分叫卯(或榫眼、榫槽)。它是古代中国建筑、家具及其它木制器械的主要结构方式。

榫卯结构的经典模型如下图:
生活中的适配器模式——身高不够鞋来凑

榫卯是藏在木头里的灵魂!而随着时代的变化,其结构也发生着一些变化,现在很多建材生产商也在发明和生产新型的具有榫卯结构的木板。假设木板生产商有下面两块木板,木板A是榫,木板B是卯,A、B两块木板就完全吻合。他们之间的榫卯接口是一种T字形的接口。
生活中的适配器模式——身高不够鞋来凑

后来,随着业务的拓展,木板厂商增加了一种新木板C。但C是L形的接口,不能与木板A对接。为了让木板C能与木板A进行对接,就需要增加一个衔接板D进行适配,而这个D就相当于适配器。如下图:
生活中的适配器模式——身高不够鞋来凑

适配器模式通常用于对已有的系统拓展新功能时,尤其适用于在设计良好的系统框架下接入第三方的接口或第三方的SDK时。在系统的最初设计阶段,最好不要把适配器模式考虑进去,除非一些特殊的场景(如你的系统本身就是要去对接和适配多种类型的硬件接口)。

适配器模式的模型抽象

类图

适配器模式的类图如下:
生活中的适配器模式——身高不够鞋来凑
Target是一个接口类,是提供给用户调用的接口抽象,如上面示例中的IHightPerson。Adaptee是你要进行适配的对象类,如上面的ShortPerson。Adapter是一个适配器,是对Adaptee的适配,它将Adaptee的对象转换(或说包装)成符合Target接口的对象;如上面的DecoratePerson,将ShortPerson的getRealHeight和getShoesHeight方法包装成IHightPerson的getHeight接口。

模型说明

设计要点

适配器模式中主要三个角色,在设计适配器模式时要找到并区分这些角色:

  1. 目标(Target): 即你期望的目标接口,要转换成的接口。
  2. 源对象(Adaptee): 即要被转换的角色,要把谁转换成目标角色。
  3. 适配器(Adapter): 适配器模式的核心角色,负责把源对象转换和包装成目标对象。

优缺点

适配器模式的优点:
  1. 可以让两个没有关联的类一起运行,起着中间转换的作用。
  2. 提高了类的复用。
  3. 灵活性好,不会破坏原有的系统。
适配器模式的缺点:
  1. 如果原有系统没有设计好(如Target不是抽象类或接口,而一个实体类),适配器模式将很难实现。
  2. 过多地使用适配器,容易使代码结构混乱,如明明看到调用的是 A 接口,内部调用的却是B接口的实现。

实战应用

有一个电子书阅读器的项目(Reader),研发之初,产品经理经过各方讨论,最后告诉我们只支持TXT和Epub格式的电子书。然后你经过仔细思考、精心设计,采用了如下图1的代码架构。在这个类图中,有一个阅读器的核心类Reader,一个TXT文档的关键类TxtBook(负责TXT格式文件的解析),和一个Epub文档的关键类EpubBook(负责Epub格式文件的解析)。
生活中的适配器模式——身高不够鞋来凑
图1:阅读器类图

产品上线半年后,市场响应良好,业务部门反映:有很多办公人员也在用我们的阅读器,他们希望这个阅读器能同时支持PDF格式,这样就不用在多个阅读器神之间来回切换了。这个时候我们的程序就需要增加对PDF格式的支持,而PDF并不是核心业务,我们不会单独为其开发一套PDF解析内核,而会使用一些开源的PDF库(我们称它为第三方库),如MuPDF、TCPDF等。而开源库的接口和我们的接口并不相同(如下图2),返回的内容也不是我们直接需要的,需要经过一些转换才能符合我们的要求。
生活中的适配器模式——身高不够鞋来凑
图2:第三方PDF解析库的类图

这时,我们就需要对PDF的解析库MuPDF进行适配。经过上面的学习,你一定知道这时该用适配器模式了,于是我们有了如下图3的类图结构。
生活中的适配器模式——身高不够鞋来凑
图3:兼容PDF的类图结构

代码实现如下:

class Page:
    "电子书一页的内容"
    def __init__(self, pageNum):
        self.__pageNum = pageNum

    def getContent(self):
        return "第 " + str(self.__pageNum) + " 页的内容..."

class Catalogue:
    "目录结构"

    def __init__(self, title):
        self.__title = title
        self.__chapters = []
        self.setChapter("第一章")
        self.setChapter("第二章")

    def setChapter(self, title):
        self.__chapters.append(title)

    def showInfo(self):
        print("标题:" + self.__title)
        for chapter in self.__chapters:
            print(chapter)

class IBook:
    "电子书文档的接口类"

    def parseFile(self, filePath):
        pass

    def getCatalogue(self):
        pass

    def getPageCount(self):
        pass

    def getPage(self, pageNum):
        pass

class TxtBook(IBook):
    "TXT解析类"

    def parseFile(self, filePath):
        # 模拟文档的解析
        print(filePath + " 文件解析成功")
        self.__pageCount = 500
        return True

    def getCatalogue(self):
        return Catalogue("TXT电子书")

    def getPageCount(self):
        return self.__pageCount

    def getPage(self, pageNum):
        return Page(pageNum)

class EpubBook(IBook):
    "TXT解析类"

    def parseFile(self, filePath):
        # 模拟文档的解析
        print(filePath + " 文件解析成功")
        self.__pageCount = 800
        return True

    def getCatalogue(self):
        return Catalogue("Epub电子书")

    def getPageCount(self):
        return self.__pageCount

    def getPage(self, pageNum):
        return Page(pageNum)


class Outline:
    "第三方PDF解析库的目录类"
    pass


class PdfPage:
    "PDF页"

    def __init__(self, pageNum):
        self.__pageNum = pageNum

    def getPageNum(self):
        return self.__pageNum


class ThirdPdf:
    "第三方PDF解析库"

    def __init__(self):
        self.__pageSize = 0

    def open(self, filePath):
        print("第三方解析PDF文件:" + filePath)
        self.__pageSize = 1000
        return True

    def getOutline(self):
        return Outline()

    def pageSize(self):
        return self.__pageSize

    def page(self, index):
        return PdfPage(index)

class PdfAdapterBook(ThirdPdf, IBook):
    "TXT解析类"

    def parseFile(self, filePath):
        # 模拟文档的解析
        rtn = super().open(filePath)
        if(rtn):
            print(filePath + "文件解析成功")
        return rtn

    def getCatalogue(self):
        outline = super().getOutline()
        print("将Outline结构的目录转换成Catalogue结构的目录")
        return Catalogue("PDF电子书")

    def getPageCount(self):
        return super().pageSize()

    def getPage(self, pageNum):
        page = self.page(pageNum)
        print("将PdfPage的面对象转换成Page的对象")
        return Page(page.getPageNum())


# 导入os库
import os

class Reader:
    "阅读器"

    def __init__(self, name):
        self.__name = name
        self.__filePath = ""
        self.__curBook = None
        self.__curPageNum = -1

    def __initBook(self, filePath):
        self.__filePath = filePath
        extName = os.path.splitext(filePath)[1]
        if(extName.lower() == ".epub"):
            self.__curBook = EpubBook()
        elif(extName.lower() == ".txt"):
            self.__curBook = TxtBook()
        elif(extName.lower() == ".pdf"):
            self.__curBook = PdfAdapterBook()
        else:
            self.__curBook = None

    def openFile(self, filePath):
        self.__initBook(filePath)
        if(self.__curBook is not None):
            rtn = self.__curBook.parseFile(filePath)
            if(rtn):
                self.__curPageNum = 1
            return rtn
        return False

    def closeFile(self):
        print("关闭 " + self.__filePath + " 文件")
        return True

    def showCatalogue(self):
        catalogue = self.__curBook.getCatalogue()
        catalogue.showInfo()

    def prePage(self):
        return self.gotoPage(self.__curPageNum - 1)

    def nextPage(self):
        return self.gotoPage(self.__curPageNum + 1)

    def gotoPage(self, pageNum):
        if(pageNum < 1 or pageNum > self.__curBook.getPageCount()):
            return None

        self.__curPageNum = pageNum
        print("显示第" + str(self.__curPageNum) + "页")
        page = self.__curBook.getPage(self.__curPageNum)
        page.getContent()
        return page

测试代码:

def testReader():
    reader = Reader("阅读器")
    if(not reader.openFile("平凡的世界.txt")):
        return
    reader.showCatalogue()
    reader.gotoPage(1)
    reader.nextPage()
    reader.closeFile()
    print()

    if (not reader.openFile("平凡的世界.epub")):
        return
    reader.showCatalogue()
    reader.gotoPage(5)
    reader.nextPage()
    reader.closeFile()
    print()

    if (not reader.openFile("平凡的世界.pdf")):
        return
    reader.showCatalogue()
    reader.gotoPage(10)
    reader.nextPage()
    reader.closeFile()

输出结果:

平凡的世界.txt 文件解析成功
标题:TXT电子书
第一章
第二章
显示第1页
显示第2页
关闭 平凡的世界.txt 文件

平凡的世界.epub 文件解析成功
标题:Epub电子书
第一章
第二章
显示第5页
显示第6页
关闭 平凡的世界.epub 文件

第三方解析PDF文件:平凡的世界.pdf
平凡的世界.pdf文件解析成功
将Outline结构的目录转换成Catalogue结构的目录
标题:PDF电子书
第一章
第二章
显示第10页
将PdfPage的面对象转换成Page的对象
显示第11页
将PdfPage的面对象转换成Page的对象
关闭 平凡的世界.pdf 文件

应用场景

  1. 系统需要使用现有的类,而这些类的接口不符合现有系统的要求。
  2. 对已有的系统拓展新功能时,尤其适用于在设计良好的系统框架下增加接入第三方的接口或第三方的SDK时。


更多更有趣的文章

想获得更多更有趣的设计模式吗?一起来阅读以下系列文章吧!

引导篇

生活中的设计模式——启程之前,请不要错过我【试读】

基础篇

生活中的监听模式——一坑爹的热水器

生活中的适配模式——身高不够鞋来凑

生活中的状态模式——人有少、壮、老, 水之冰、液、汽

生活中的单例模式——你是我生命的唯一

生活中的职责模式——我的假条去哪了

生活中的中介模式——找房子问中介

生活中的代理模式——帮我拿一下快递

生活中的装饰模式——你想怎么穿就怎么穿

生活中的工厂模式——你要拿铁还是摩卡

生活中的迭代模式——下一个就是你了

生活中的组合模式——自己电脑组装,价格再降三折

生活中的构建模式——你想要一辆车还是一座房

生活中的克隆模式——给你一个分身术

生活中的策略模式——怎么来不重要,人到就行

生活中的命令模式——大闸蟹,走起!

生活中的备忘模式——好记性不如烂笔头

生活中的享元模式——颜料很贵必须充分利用

生活中的外观模式——学妹别慌,学长帮你

生活中的访问模式——一千个读者一千个哈姆雷特

生活中的设计模式——与经典23种设计模式的不解渊源

生活中的设计模式——那些未完待续的设计模式

进阶篇

深入解读过滤器模式——制作一杯鲜纯细腻的豆浆

深入解读对象池技术——共享让生活更便捷

深入解读回调机制——把你技能亮出来

经验篇

谈谈我对设计模式的理解

谈谈我对设计原则的思考

谈谈我对项目重构的看法



关注【SunLogging】
生活中的适配器模式——身高不够鞋来凑
长按或扫码二维码,在手机端阅读更多内容
上一篇:PHP中的字符串函数


下一篇:客户案例 | 居然之家:用宜搭全新改造OA系统