优雅编程之这样处理边界,你就“正常”了(八)

开心一笑

【猫和狗结婚,不久闹离婚。 法官问原因,狗说:猫婚后每晚都不回家,行为不轨。 猫大喊:冤枉啊,我只是去追老鼠。 狗说:法官你听听。】

提出问题

如何优雅处理与第三方API的边界问题???

解决问题

我们很少控制系统中的全部软件,有时我们购买第三方程序包时或使用开源源代码,有时我们依靠公司中其他团队打造组件或者系统。不管是哪种情况我们都得将外来代码干净利落地整合到自己的系统中。下面是自己对《代码整洁之道》中的几点总结:

美图

1)学习性测试:在项目中引入第三方API的新版本,测试项目是否正常工作,当然我们基本上没有时间去重头学习和研究第三方工具或者自己写代码来实现第三方工具的功能,但是我们至少应该先对第三方工具进行测试。

2)编写测试来遍览和理解第三方代码,同时也是一种免费学习;

3)处理边界问题方法:适配器模式是非常好的设计,用新类包装第三方API,用Adapter模式将我们的接口转换为第三方提供的接口,它不仅能将不兼容的接口改写成兼容的接口,还能够对通过对第三方工具重新封装来避免边界的变化对系统的影响;

这里举一个适配器例子:

适配器模式

IPOISlide类:

package com.evada.de.common.pptExport.xlsfpoi.api;

/**
 * PPT单页接口(这是自己公司写的一个接口)
 */
public interface IPOISlide {

    /**新建一个文本框
     *
     * @return IPOISlideText    新建的文本框对象接口
     * @throws Exception
     */
    public IPOISlideText CreateText() throws Exception;

}

POISlideXslfImpl是IPOISlide类的实现:

package com.evada.de.common.pptExport.xlsfpoi.impl;

/**
 * PPT文档页对象poi xslf实现(这是自己公司写的一个接口实现)
 */

public class POISlideXslfImpl implements IPOISlide {
    
    /** 这里是重点,这个是POI的一个类,我们用POISlideXslfImpl类
    包装XSLFSlide类,除了可以提供XSLFSlide所有的方法之外,
    还可以提供我们自己扩展的方法CreateText **/
    private XSLFSlide slide;

    private IPOISlideShow ppt;

    public POISlideXslfImpl(XSLFSlide slide, IPOISlideShow ppt) {
        this.slide = slide;
        this.ppt = ppt;
    }    

    /** 新建一个文本框,这个方法当作是自己扩展的一个方法 **/
    public IPOISlideText CreateText() throws Exception
    {
        XSLFTextBox shape1 = slide.createTextBox();
        IPOISlideText text = new POISlideTextXslfImpl(shape1);
        return text;

    }
}

这里所谓的边界,就是划清项目代码和第三方API之间的界限,一旦第三方API出现问题,我们可以修改我们自己的实现,而不用去修改第三方API的源码,同时,我们可以在自己实现里,扩展其他方法,妙不可言啊!

读书感悟

来自《菜根谭》

  • 弄权一时,凄凉万古。栖守道德者,寂寞一时;依阿权势者,凄凉万古。达人观物外之物,思身后之身,守受一时之寂寞,毋取万古之凄凉。
  • 路要让一步,味须减三分。径路窄处,留一步与人行;滋味浓的,减三分让人尝;此是涉世一极安乐法。
  • 厚德以积福,逸心以补劳,修道以解厄。天薄我以福,吾厚吾德以迓之;天劳我以形,吾补吾心以逸之;天厄我以遇,吾亨吾道以通之;天且奈我何哉?
  • 临崖勒马,起死回生。念头起处,才觉向欲路上去,便挽从理路上来。一起便觉,一觉便走,此是转祸为福,起死回生的关头,切莫轻易放过。
  • 君子德行,其道中庸。清能有容,仁能善断,明不伤察,直不过矫,是谓蜜饯不甜,海味不咸,才是懿德。
  • 苦中有乐,乐中有苦。苦心中常得悦心之趣,得意时便生失意之悲。
  • 处世要方圆自在,待人要宽严得宜。处治世宜方,处乱世宜圆,处叔季之世当方圆并用;
    待善人宜宽,待恶人宜严,待庸众之人当宽严互存。
  • 闲时吃紧,忙里悠闲。天地寂然不动,而气机无息稍停;日月尽夜奔驰,而贞明万古不易;
    故君子闲时要有吃紧的心思,忙处要有悠闲的趣味。
  • 良药苦口,忠言逆耳。耳中常闻逆耳之言,心中常有拂心之事,才是进修德行的砥石。若言言悦耳,事事快心,便把此生埋在鸩毒中矣。
  • 退即是进,与即是得。处世让一步为高,退步即进步的张本;待人宽一分是福,利人实利己的根基。

其他

如果有带给你一丝丝小快乐,就让快乐继续传递下去,欢迎转载,点赞,顶,欢迎留下宝贵的意见,多谢支持!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,522评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,033评论 4 62
  • SQL语句构成 .Keyword组成clause,关键字不能独立用,要配合别的关键字才能使用,由多个关键字组合成一...
    ghbsunny阅读 1,299评论 0 0
  • 重新认识自己 我们的记忆是被自我意识改造过的记忆。我们对自己的评价总是构建在他人反馈的基础之上。懒惰、放纵、自制力...
    玲珑娘娘阅读 574评论 0 0
  • 今日读书 《学习的革命》书中那些有感觉的句子 1.简洁明了,去除行话。 每个初级文案广告会将kiss深深烙进脑海。...
    Pheeb阅读 278评论 0 1