南宁Java培训
达内南宁JAVA中心

13471155827
qq:269520999

热门课程

Java中万恶的注解

  • 时间:2018-04-09 11:58
  • 发布: 脚本之家
  • 来源: 脚本之家

当Java 1.5引入注解,企业开发者对简化EJB和其他企业产品开发抱有很大期望。

然而从那时起,Java企业使用注解出现一些无法预料的后果和副作用,一些甚至到今天都没有被注意到。

并非所有的注解都相同

尽管上面许多讨论都包含有价值的观点,但并不是所有注解都是相同的。

这里有两类注解,区别在于他们是否在运行期影响程序。首先,说一下无害的一类,它们并不会在运行期对代码产生任何影响;另一种是有害的一类,它们会修改运行期行为。无害的注解包括@Deprecated, @Override, @SuppressWarnings, 等等。有害的注解包括@Entity, @Table, @PostConstruct, @ApplicationScoped,等等。

在无害的注解中存在一小部分注解,它们非常实用。有一些提供在编译期间(静态检查)捕获错误或提供安全保障。一些实用的注解包括:@Override, @NonNull/@Nullable 来自(Checker Framework), 等等。

为什么有害的注解不好?

我们定义了一些有害的注解,为什么要避免使用它们呢?

想象一个标准的Java Data类拥有@PostConstruct方法。这个注解表示所标注的方法应该在对象创建好之后被调用。这个功能并不是由JVM处理,所以Date类隐式获取未知的框架和容器,而自身语义上并没有做任何事情。如果这些代码并不运行在任何容器中,而只是运行在JVM中呢?这个注解大大降低了这个类的重用性。另外对于任何使用Date的地方进行单元测试就变成了噩梦,因为你必须确保每次都正确绑定post-construction,要模拟一个兼容的容器。这就有点可笑了,一个Date类需要一个容器来运行,但这确实是有害的注解对类、方法和参数的影响。

无可否认,业务逻辑往往复杂,需要更多依赖和关系,而不仅仅是一个简单的Date类。然而没有理由在一个类中显式或隐式地添加不必要的依赖或约束,有害的注解就是:依赖和约束。

企业陷阱

不幸的是有害的声明在Java Enterprise 5大规模合法化。为了更正早期企业API的易用性问题,注解用来隐藏系统中冗余的和难用的部分。新的JEE 5被称赞为”轻量级”和”简单”,表面上看起来是这样。但是一个微小的,同时也是至关重要的误用蔓延开来。

@StatelesspublicclassDocumentRepository{publicDocumentgetDocument(String title){ ... } ...}

如果想要获取一个Stateless EJB,“只需要”在类上声明@Stateless注解。确实,编写这个类只需要只一点动作,但是请注意这个类中有害的注解绑定了几百页的说明文档,而且只能在百万字节的应用服务器(Application Server)上运行。这又怎么能称的上是”轻量级”呢。所以,这个注解仅仅是真正需要编写的Java代码的占位符而已,代码仍需要以某种形式存在。现在只不过是隐藏在注解之下。

不幸的是,这种变通方案称为一种模式,现在有害的注解广泛分布:JPA, CDI, Common Annotations, JAXB 等等。

有害的注解有时会出现在错误的地点

因为注解通常作为开发环境,有时有害的注解被当做单一职责原则(Single Responsibility Principle)或关注点分离(Separation of Concerns)的最佳实践。

让我们来考虑一下下面这个CDI例子:

@ApplicationScopedpublicclassDocumentFormatter{ ...}

上面的注解描述这个类应该是一个CDI Bean,意味着它应该只能由CDI实例化,并确保每个应用中只有一个实例。

这些信息并不属于这个类。这个服务在功能上(无论什么方式)并不会对它在当前应用中的作用产生影响。这里有两个明显的关注点。

一个JPA的简单例子:

@Entity@Table("PERSON")publicclassPerson{ ...}

问题在于这种类往往是”领域对象(domain objects)”,它们直接将领域模型持久化。更糟的是,数据传送对象(DTO)用来在对象之间传送数据,使得整个构造变得脆弱,因为对象间耦合过于紧密。不管怎样,这是一种错误的方式。

所有的这些附加的功能和(或)信息应该从这些类中分离出来,但是它们却悄悄混在一起,因为它们”只不过”是注解。

有害的注解有时蔓延

注解有时会传染其他对象。回顾上面那个CDI Bean。每个使用它的对象,每个依赖它的对象现在都拥有一个CDI注解,否则依赖关系树就不会构建成功。

@Entity注解也一样。因为对象之间的关系,其他对象也通过注解持久化,很快所有的持久化对象都会有这个注解。我们无法使用原生的第三方对象(除非序列化或包装它们),我们无法使用其他持久化机制(比如用NoSQL DB存放对象)。

这些注解使得这些对象无法复用。它们只能在一个严格的、受控制的、不透明的环境中使用,不能和任何东西整合。

有什么替代品?

是XML吗?当然不是,至少对于上面的例子来说不是。

Spring框架使用配置来管理对象,因此可以用XML当做配置文件。然而,是否某个依赖需要在运行期改变,而不通过重新编译?如果不需要,那么很难说配置应该用另一门语言来表示,尤其重构困难、测试困难、管理需要特殊工具。

真正的替代品当然是好的Java代码,正确封装并解耦的。是的,用代码来管理对象,尽管有时被当做样板(boilerplate),但并不算糟糕。它带来一些好处,比如让代码可读、可调试、可重构。只有那些长片的、复杂的、冗余的样板是糟糕的,比如“关于EJB 2.0”。但是解决方案并不是摆脱所有的样板或用另一种语言隐藏样板,而是简单干净的架构,直接而不多余的信息,简单并合适的方式来面向对象。

这也适用于JPA、Spring和其他东西。误用注解来表示功能会发生Stcakoverflow上这个问题“Arguments Against Annotations”,为什么不用已有的工具呢:比如Java语言本身和编译器,来解决这类问题,面向对象和软件最佳实践。

总结

如果注解在代码运行期加上了额外功能和约束,那它是有害的。这很糟糕,因为它隐藏了类或方法的切面,使之难懂、难复用、难重构、难测试。

不幸的是Java Enterprise不理睬Java开发者社区中发对注解的声音。所以企业级Java和其他”官方”框架更不可能重视这类问题。

至少我们可以持续关注有害的注解,如果可能尽量避免使用,编写新的框架和软件替换掉注解,不会出现有害注解所带来的问题。

上一篇:Java语言的2018展望
下一篇:java的面向对象的三大特性

java练习题【含答案】

java面试题(1)

JavaWeb项目为什么我们要放弃jsp?为什么要前后端解耦?为什么要前后端分离?

Java内存管理

选择城市和中心
贵州省

广西省

海南省