`
ajoo
  • 浏览: 452716 次
社区版块
存档分类
最新评论

依赖是否可以作为一个独立的衡量软件质量的标准?

阅读更多
这个争论的背景有点复杂。我就尽量简化了说。

遗留系统有一个自制的service locator。是一个静态函数:
public static Object newObject(Class interfaceOrDefaultClass, Class[] parameterTypes, Object[] arguments);

使用起来是这样:
ImplFactory.newObject(MyInterface.class, new Class[]{int.class, String.class}, new Object[]{new Integer(1), "abc"});

这个函数会根据一个properties文件的配置来寻找一个带有制定构造函数的实现或者继承MyInterface的类。
比如,如果配置文件里面配置了
com.mycompany.MyInterface=com.mycompany.MyInterfaceImpl

而MyInterfaceImpl有这个构造函数:
public MyInterfaceImpl(int i, String s);

那么,MyInterfaceImpl就会被使用。

而如果调用的时候用了一个缺省类,那么如果配置文件没有配置,就会使用这个缺省类,比如:
ImplFactory.newObject(DefaultMyInterfaceImpl.class, new Class[]{int.class, String.class}, new Object[]{new Integer(1), "abc"});


这个自制的service locator无疑是非常原始,也是很难用的。为了准备向一个真正的ioc container过渡,我实现了一个dynamic proxy来封装ImplFactory。

使用起来如下:
MyInterface = serviceFactory.getMyInterface(1, "abc");

使用者只需要把getMyInterface这个函数声明在ServiceFactory这个接口中,就可以直接使用getMyInterface()函数了。当然,这个serviceFactory是作为倚赖被注射进客户类的。以后,如果我们切换成了ioc容器,比如spring,只要增加一个dynamic proxy就行了,客户代码基本不用动。

我的同事(ImplFactory就是他亲手做的),对这个ServiceFactory不是太感冒。他认为这样做明显的好处就是一个语法糖,语法漂亮一点而已。而因为ImplFactory本身已经是个抽象,ServiceFactory又是包在ImplFactory外面的抽象,那么"abstraction on top of abstraction"就显得多余,或者说过度设计。我对这样一个在我看来毫无争议的问题有点不知道怎么说,不过我跟他说这样以后可以轻易地转移到别的ioc container上面,才说服了他。


ImplFactoryProxy具体怎么实现的,只要懂dynamic proxy的都会,我就不赘述了。



这个实现里面,有一个问题,就是怎么处理这个“缺省实现类”。在原来的代码里面,缺省实现类是硬编码在客户程序里的。而现在的用法里面,客户不能制定缺省实现类,所以这个信息需要额外提供给这个dynamic proxy。

我的做法仍然是注射,通过注射一个java.util.Map对象到这个ImplFactoryProxy类,来给这个类提供缺省实现信息。签名如下:
public class ImplFactoryProxy {
  private final Map defaults;
  ImplFactoryProxy(Map defaults) {
    this.defaults = defaults;
  }
  ...
}


写好了ImplFactoryProxy之后,我面临的下一个问题是怎么得到这个Map。我的做法是通过ClassLoader.loadResourceAsStream()来读入一个存在当前package里面的properties文件,然后调用Properties.load(inputStream)来得到Properties,这个Properties对象自然就可以注射进ImplFactoryProxy了。

至此,希望你会说:没什么亚。大家都是这么做的。


不过,问题来了。
我的那个老资格的同事在review代码的时候看到这个ClassLoader.loadResourceAsStream,说:这个不行,我希望你改成用我们的PropFactory框架。

话说,这个遗留系统有一个相当强大(或者说复杂?)的读取property的框架,这个框架除了一般的按照key读取value,还支持树形的property,也就是说,一个key可能对应一个子property map。(当然,还有其他功能)

用法是:
PropFactory.getInstance().getProperty("property file name").getPropertyValue("key");


这样的代码充斥整个code base。


我对这个框架的态度是相当保留的。主要的原因是我认为大多的配置值应该通过注射,而不是主动地去找PropFactory框架要。这种PropFactory.getInstance()的代码使单元测试变得困难,而且加大了系统耦合,随便一个模块就要依赖于PropFactory。

而我在我的dynamic proxy中不使用PropFactory,除了上面的原因,还有以下几点:
1。我要的就是一个简单的key-value map。根本不需要PropFactory提供的那么多功能。
2。Properties, ClassLoader.loadResourceAsStream都是标准jdk的东西,用起来也不难。而且我也做了一个IOUtils类来封装这部分代码:
IOUtils:
  Properties loadProperties(ClassLoader loader, String resourceName);

3。我这个dynamic proxy相当的self contained。它基本上和现有的遗留系统除了ImplFactory没有任何其它关联。我也不希望引入任何不必要的依赖。

但是,显然,这些观点在同事那里是站不住脚的:
1。不管你需不需要额外的功能,你直接调用这个api就好了。又不需要额外写代码。
2。项目中大家都使用PropFactory来读取配置。如果大家你写一个ajoo way of reading property,他写一个bjoo way of reading property,那不是乱套了?这样做破坏了一致性,增大了团队协作的难度。
3。依赖就依赖了,有什么关系?这个几乎是公司内部的事实标准了。大家都这么用,还是头回听说有人对这个依赖有问题的。
4。如果不用PropFactory,谁能保证你的代码就在任何情况都工作?这个项目的build process, deploy process都很复杂,难以预测你这个代码在nightly build甚至在生产环境中也会工作。


对此,当然我是不同意的。我认为,ClassLoader.loadResourceAsStream几乎是工业界的标准,相比于一个公司自制的标准,我还是更倾向于相信被无数人证明工作的业界标准。
而且,试图让PropFactory包打一切也是不现实的。最起码,你用的commons logging, log4j等等开源库,都不可能依赖于你自己写的PropFactory,它们只能使用ClassLoader。所以这个一致性从一开始就不存在。
最后,我认为“一致性”在项目中被错误解读了。打个比方,项目中大家一致都是用jsp,但是我不认为当只需要一个servlet或者甚至一个静态的html的时候,我们也必须要为了一致性通过jsp来绕一圈生成这个servlet或者html.



经过争论,我还是做了妥协,只要我可以注射Map,你非要用in house framework而不是业界标准来读文件,也罢。

于是我的方案变成:
new ImplFactoryProxy(PropFactory.getInstance().getProperty("defaults.properties").toProperties())

这个toProperties()是PropFactory框架提供的一个函数,可以把我们inhouse的IProperties转换成java.util.Properties。

最终面向用户的接口(在没有采用ioc容器的情况下,只好还是允许客户代码主动取得ServiceFactory实例。)是:
public class ServiceFactoryUtil {
  public static ServiceFactory getServiceFactory();
}

这个类负责调用PropFactory.getInstance(),并且提供singleton服务以避免重复读取properties文件。


这几乎是我可以接受的底线了。


但是,同事仍然不满意。他最喜欢的是我不去注射Map,而是在ImplFactoryProxy内部直接调用PropFactory。这个在我来说是不可考虑的。

当然,他也退了一步,同意我的注射方式。但是认为我不应该注射java.util.Map,而应该注射IProperties。

同事的理由:
1。这样可以避免一个toProperties()调用。别人读代码的时候,可以不会纳闷“为什么这里要这么做?”。
2。java.util.Map这个接口太肥大。我需要的其实就是一个get(),最多加上keySet()和containsKey(),用一个java.util.Map不合适。


而我反对使用IProperties,理由是:
1。IProperties不是标准接口,我宁愿以来jdk标准接口。毕竟熟悉java.util.Map的比IProperties多多了吧?即使IProperties是在公司内部被“一致”使用。
2。没人会纳闷为什么要调用toProperties()。如果这都要纳闷,那么整个遗留系统的那数万行的代码就没法读了。
3。如果说java.util.Map不是最小接口,IProperties也不是。它也有一些我不需要的函数。
4。整个公司从来没有人用注射的方式来使用IProperties。大家都是PropFactory.getInstance()这样从头调用的。难保注射IProperties不会出什么问题。(比如,同步问题?后来,虽然同步问题没法验证,我确实发现了IProperties不支持Serializable,致使我的ServiceFactory也不能Serializable。这样类似的问题,如果真是采用了IProperties,还不知道会不会陆续向外蹦呢)。

最终,因为我是这个功能的开发者,还是以我的意见为主了。但是我并没有说服同事。在争论过程中,让我深感郁闷的是,我的“减小依赖”的论点根本不为同事接受,似乎在他们看来“依赖”并不能作为一个理由。而我也发现要把减小依赖和他们接受的DRY,unit test等原则直观地联系起来不太容易。

那么,你是怎么看这个问题的呢?
分享到:
评论
1 楼 zkj_beyond 2007-02-12  
ImplFactory.newObject(DefaultMyInterfaceImpl.class, new Class[]{int.class, String.class}, new Object[]{new Integer(1), "abc"});
如果是:  new Class[]{YouInterFaceIMpl.class, String.class}???
MyInterface = serviceFactory.getMyInterface(1, "abc"); 

当然喜欢后者。  遗留系统这个service locator很有问题,你的工作是替换!那么何必再引入一个 static的 PropFactory.getInstance(),这个也不要替换。

感觉new ImplFactoryProxy(PropFactory.getInstance().getProperty("defaults.properties").toProperties()) 没必要有构造参数,如果我写客户代码,绝对不希望再考虑如何构造这个参数。

相关推荐

    软件工程质量

    "#$%&’()”旨在帮助软件开发者、需方和独立评价者更好地理解并应用软件质量评价的原则。它不仅为软件开发者提供了一套完整的指南,也使得管理者、开发者或维护者能够有效地评估软件是否达到了预期的质量要求,并在...

    作为软件工程师,你必须知道的20个常识

    - **观察者模式**:定义了对象之间的一种一对多依赖关系,当一个对象的状态发生改变时,所有依赖于它的对象都会得到通知并自动更新。 通过学习和应用这些设计模式,可以有效地解决软件设计中的常见问题,提高软件的...

    软件工程术语标准

    - **定义:**整体部分结构是指一个类可以包含其他类的对象作为其组成部分。 **继承:** 继承是指一个类(子类)从另一个类(父类)继承属性和方法的过程。 **服务:** 服务是指对象能够执行的操作或功能,通常...

    软件测试研究进展 软件质量

    软件测试的充分性准则是衡量测试覆盖度的一个指标,它定义了测试应该达到的最低标准。常见的充分性准则包括语句覆盖、分支覆盖、条件覆盖、路径覆盖等。这些准则帮助测试人员确定测试用例集的完整性和有效性,确保...

    软件测试人员调研报告

    - **公司测试人员与开发人员的比例**:这个比例反映了公司在软件开发生命周期中对测试环节的重视程度,也是衡量软件质量的一个重要指标。 - **公司每年对测试人员的培训次数及类型**:培训是提高软件测试人员技能的...

    软件工程试题及答案82085.doc

    8. **软件质量模型**:McCall提出了一个包含11个软件质量特性的模型,这些特性涵盖了可修改性、可理解性、可测试性等多个方面。 9. **软件结构**:软件结构通常基于模块构建,形成一种控制层次结构,有助于组织和...

    软件工程复习题

    1. **模块独立性**:题目中的第一个选择题提到模块独立性是软件开发中的一个重要原则。模块独立性是指每个模块只完成系统要求的独立子功能,并且与其他模块的联系最少且接口简单。通常通过两个标准来衡量:耦合性和...

    嵌入式软件测试技术[QUALITY]

    2. **度量的标准**:不同的度量方法各有侧重,如何选择合适的度量标准也是一个问题。 3. **度量的意义**:度量结果的意义也需要明确,不是所有可度量的指标都有实际意义。 ##### (三)好的度量标准 1. **直观性**...

    精品标准化评分.pdf

    为了满足您的要求,我将尝试基于一个假设的、与“精品标准化评分”主题相关的知识场景来构建知识点,但请注意,这些内容并非根据您提供的文件信息而生成,而是一个独立的示例。 精品标准化评分通常涉及对产品质量的...

    软件开发工具.pdf

    模块凝聚性和耦合性是衡量软件模块质量的重要指标,凝聚性强调模块功能的单一化,耦合性关注模块间的相互依赖。 面向对象编程中的封装性是指隐藏对象的内部细节,只暴露必要的接口;遗传性允许子类继承父类的属性和...

    面向对象软件构造(第二版)1-6章

    本书前六章共同构建了一个面向对象软件开发的综合视角,涵盖了软件质量的理论基础、面向对象编程的核心原则、模块化设计的最佳实践、复用性的实现策略、对象技术的发展历程以及抽象数据类型的应用。Meyer的论述不仅...

    企业级应用软件架构开发过程与实践1

    这些早期程序虽然简单,却标志着软件作为独立概念的起源。 **传统的业务执行过程** 在信息技术广泛应用之前,传统业务的执行过程大多依赖于手工操作。例如,银行业务处理中涉及大量纸质记录,包括账户信息、交易...

    软件工程概念与术语

    - **软件可靠性**指的是软件在规定条件下和时间内完成预定功能的能力,它是衡量软件质量的重要指标之一。 - **软件安全性**关注软件抵御攻击、保护数据和隐私的能力,确保软件在面对恶意行为时仍能正常运行。 - **...

Global site tag (gtag.js) - Google Analytics