运用适配器模式应对项目中的变化

作者:张纪刚

链接:

http://blog.csdn.net/zhangjg_blog/article/details/18779607

(点击文末阅读原文前往)

相关链接:

我为什么要学习linux

http://blog.csdn.net/zhangjg_blog/article/details/17621339

一个示例让你明白适配器模式

http://blog.csdn.net/zhangjg_blog/article/details/18735243

在前一篇文章一个示例让你明白适配器模式中,详细介绍了适配器模式,本文以实际项目中遇到的问题来演示适配器模式的实际应用。

项目中使用的原有接口

原来的项目中使用到了一个类ESPMenu,该类的代码很简单:

public class ESPMenu {
private String id;
private String caption;
private String normalIcon;
private String selectedIcon;
private String viewType;
private String icon
private String content;
public String getId() {
return id;
}
public String getCaption() {
return caption;
}
public String getNormalIcon() {
return normalIcon;
}
public String getViewType() {
return viewType;
}
public String getSelectedIcon() {
return selectedIcon;
}
public String getIcon() {
return icon;
}
public String getContent() {
return content;
}
}

从上面的代码可见,这是一个普通的实体类。 在项目中一个ESPMenu对象代表一个菜单项。这里的菜单是从后台中的XML中配置的。一个菜单项对应对应一个XML中的一个标签

<node id="my_task" caption="任务" selectedIcon="myTask.png" normalIcon="myTask_n.png"/>

这个标签和上面的ESPMenu对象表达的是相同的意思,都是表示一个菜单项,包括菜单的id,菜单显示的标题,显示的背景图片等信息。

目前,项目原有接口指的就是这个类了。这里要做一个说明:并不是只有实现一个interface才叫接口, 这里所说的接口是广义上的接口概念,能被外界访问到的部分都可以称作接口。 比如ESPMenu中有一个公共方法getIcon(), 这个方法就可以称作接口的一部分,因为它能被外界访问。

需求的变更

随着项目的进行,越来越多的需求被提出。上面的菜单对象ESPMenu能表述的信息太少了,并且无法扩展。Java语言的动态性远不如Python和Ruby,Java只能动态的加载类,不能在运行时改变类的结构,而Python和Ruby能够在运行时改变类的结构。现在必须要在菜单中增加一些扩展信息,比如必须由这样的信息:点了菜单之后,如何显示这个菜单项指定的内容。举例来说,一个菜单项指定, 点击菜单项后, 使用webview来显示内容, 显示的内容来源用一个url指定。这就要求菜单项有以下扩展:

<node id="xinwen" caption="新闻" normalIcon="/images/icons/mobile/myHome.png" viewType="webView" url="3g.sina.com.cn"/>

那么我就得在上面的ESPMenu中增加一个url字段。这是不可行的,因为增加一个字段没什么大不了, 但是每次扩展都要增加字段,这就毫无扩展性可言。所以后台提供了实现方式,用一个叫做StubObject的对象表示每个菜单项。这个对象是面向抽象的,使用基本的键值存储来描述菜单中的各个属性,不会有具体的字段名字。比如要获得菜单的标题,只需要调用getObject("caption"), 要获取url字段,只需调用getObject("url"), 使用一个getObject方法获取所有信息,只要传入对应的参数。

StubObject应该是我们公司的大牛写的,内部代码较多, 我们只关注一个方法就行了:

public Object getObject(Object Key) {

参数是Object类型的,返回值也是Object类型的,能适应所有的需求。

将XML菜单解析成Java对象的方法后台也实现好了, 我们回去XML后, 只需要调用一个解析的方法,XML就能解析成功, 解析成StubObject对象。

所以, 现在面临一个严重的问题, 我使用的接口是ESPMenu, 而后台提供的是StubObject。这就表示接口已经变了。

使用适配器模式应对需求变更

从上面可知随着项目的进行, 导致了接口的改变。但是我的前端工程中已经大量使用了ESPMenu对象, 大量调用了ESPMenu的方法,并且对ESPMenu的访问分散在不同的文件中。如果要把ESPMenu替换成StubObject, 那就得该多个文件, 容易引起不一致和混乱。这不是一个好的对策。

那么怎样才能在不改变原有接口的情况下, 有能使用新的接口呢? 那就要使用适配器模式。使用适配器模式,需要做以下的修改。

1)将ESPMenu抽象成一个接口, 项目中已经使用过的方法,在接口中保持不变。并且扩展在这个接口中新加入一个getObject方法:

public interface ESPMenu {
public String getId();
public String getCaption();
public String getNormalIcon();
public String getViewType() ;
public String getSelectedIcon() ;
public String getIcon() ;
public String getContent() ;
public Object getObject(Object key);
}

2) 为这一个接口编写一个实现类ESPMenuImpl, 这个实现类本质上就是一个适配器:

/*package*/ class ESPMenuImpl implements ESPMenu{
private StubObject stubObj;
public ESPMenuImpl(StubObject stubObj) {
this.stubObj = stubObj;
}
@Override
public String getId() {
return (String) stubObj.getObject("id");
}
@Override
public String getCaption() {
return (String)stubObj.getObject("caption"));
}
@Override
public String getNormalIcon() {
return (String)stubObj.getObject("normalIcon"));
}
@Override
public String getViewType() {
return (String) stubObj.getObject("viewType");
}
@Override
public String getSelectedIcon() {
return (String) stubObj.getObject("selectedIcon");
}
@Override
public String getIcon() {
return (String) stubObj.getObject("icon");
}
@Override
public String getContent() {
return (String) stubObj.getObject("content");
}
@Override
public Object getObject(Object key) {
return stubObj.getObject(key, "");
}
}

这个实现类在成员变量位置组合了一个StubObject对象, 也就是我们要使用的新接口。 并且将对就接口的调用, 都委托到对StubObject对象的调用。每个获取菜单属性的方法接口都没有改变,只是将调用都分发到StubObject对象的getObject方法,并且传入对应的key。

在该类的最后, 实现了ESPMenu中新加入的getObject方法, 同样将这个方法的调用委托给StubObject中getObject的方法。这样, StubObject的扩展性就传递到了ESPMenuImpl中, 使得ESPMenuImpl和StubObject具有同样的扩展性。

这样就完成了新旧接口的适配。项目上层中使用到的API没有改变, 只是将原来的ESPMenu类改成了ESPMenu接口。将ESPMenuImpl的访问权限设成包访问权限,那么对于上层代码,ESPMenuImpl就是不可见的,上层能使用的只能是ESPMenu接口, 不会涉及任何实现, 这样也就做到了比较好的封装性。

最后给出类图:

总结

设计上的事就是这样,想到了, 就能比较优雅的解决问题,想不到的话, 就只能使用到处修改代码的方法比较笨拙的应对问题,还容易将项目弄的混乱。现在我比较庆幸当初学习了设计模式,而没有听其他人的“建议”, 很多人都说“我们做的项目中用不到设计模式,学这个没用”。关于学习这个问题在我的另一篇博客 我为什么要学习Linux ?中提到过。设计模式是个好东西,以后我肯定还会进一步的学习,并且在项目中多实践,提升自己的设计能力。

其实设计模式并不难,难的是真正领悟他的精妙,并且能灵活的运用于日常项目的开发。

原文发布于微信公众号 - java达人(drjava)

原文发表时间:2017-02-28

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏程序员宝库

Python爬虫抓取纯静态网站及其资源

前段时间需要快速做个静态展示页面,要求是响应式和较美观。由于时间较短,自己动手写的话也有点麻烦,所以就打算上网找现成的。

2962
来自专栏Vamei实验室

快速学习Bash

作者:Vamei 出处:http://www.cnblogs.com/vamei 严禁转载。

1283
来自专栏阮一峰的网络日志

JavaScript Source Map 详解

上周,jQuery 1.9发布。 ? 这是2.0版之前的最后一个新版本,有很多新功能,其中一个就是支持Source Map。 访问 http://ajax.go...

3435
来自专栏技术博文

php面试题整理

1.禁用COOKIE 后 SEESION 还能用吗? 答:通常服务器端的session是借助于seesion cookie来和客户端交互的。 但如果客户端禁用了...

4058
来自专栏北京马哥教育

最详细的 linux grep命令教程

grep (global search regular expression(RE) and print out the line,全面搜索正则表达式并把行打印...

1510
来自专栏技术小讲堂

Angular开发者手册重点翻译之指令(一)文本和属性绑定ngAttr属性绑定

创建自定义的指令 这个文章将解释什么需要在自己的angularjs应用中创建自己的指令,以及如何实现它。 什么是指令 在高的层面上讲,指令是DOM元素中的标记...

3886
来自专栏Vamei实验室

快速学习Bash

作者:Vamei 出处:http://www.cnblogs.com/vamei 严禁转载。

832
来自专栏Golang语言社区

GO语言标准库概览

在Go语言五周系列教程的最后一部分中,我们将带领大家一起来浏览一下Go语言丰富的标准库。 Go标准库包含了大量包,提供了丰富广泛的功能特性。这里提供了概览仅仅是...

38410
来自专栏Golang语言社区

GO语言标准库概览

在Go语言五周系列教程的最后一部分中,我们将带领大家一起来浏览一下Go语言丰富的标准库。 Go标准库包含了大量包,提供了丰富广泛的功能特性。这里提供了概览仅仅是...

7446
来自专栏遊俠扎彪

GNU C之圆括号套花括号(表达式中的复合语句)

GNU C对ANSI C做了很多扩展,除比较知名的0长度数组、typeof关键字之类的以外,还有一个比较有意思的,那就是圆括号里面套花括号的复合语句。举例如下:

2487

扫码关注云+社区

领取腾讯云代金券