开心一笑
【猫和狗结婚,不久闹离婚。 法官问原因,狗说:猫婚后每晚都不回家,行为不轨。 猫大喊:冤枉啊,我只是去追老鼠。 狗说:法官你听听。】
提出问题
如何优雅处理与第三方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的源码,同时,我们可以在自己实现里,扩展其他方法,妙不可言啊!
读书感悟
来自《菜根谭》
- 弄权一时,凄凉万古。栖守道德者,寂寞一时;依阿权势者,凄凉万古。达人观物外之物,思身后之身,守受一时之寂寞,毋取万古之凄凉。
- 路要让一步,味须减三分。径路窄处,留一步与人行;滋味浓的,减三分让人尝;此是涉世一极安乐法。
- 厚德以积福,逸心以补劳,修道以解厄。天薄我以福,吾厚吾德以迓之;天劳我以形,吾补吾心以逸之;天厄我以遇,吾亨吾道以通之;天且奈我何哉?
- 临崖勒马,起死回生。念头起处,才觉向欲路上去,便挽从理路上来。一起便觉,一觉便走,此是转祸为福,起死回生的关头,切莫轻易放过。
- 君子德行,其道中庸。清能有容,仁能善断,明不伤察,直不过矫,是谓蜜饯不甜,海味不咸,才是懿德。
- 苦中有乐,乐中有苦。苦心中常得悦心之趣,得意时便生失意之悲。
- 处世要方圆自在,待人要宽严得宜。处治世宜方,处乱世宜圆,处叔季之世当方圆并用;
待善人宜宽,待恶人宜严,待庸众之人当宽严互存。 - 闲时吃紧,忙里悠闲。天地寂然不动,而气机无息稍停;日月尽夜奔驰,而贞明万古不易;
故君子闲时要有吃紧的心思,忙处要有悠闲的趣味。 - 良药苦口,忠言逆耳。耳中常闻逆耳之言,心中常有拂心之事,才是进修德行的砥石。若言言悦耳,事事快心,便把此生埋在鸩毒中矣。
- 退即是进,与即是得。处世让一步为高,退步即进步的张本;待人宽一分是福,利人实利己的根基。
其他
如果有带给你一丝丝小快乐,就让快乐继续传递下去,欢迎转载,点赞,顶,欢迎留下宝贵的意见,多谢支持!