本文由码农网 – 孙腾浩原创翻译，转载请看清文末的转载要求，欢迎参与我们的付费投稿计划！
当java 1.5引入注解，企业开发者对简化ejb和其他企业产品开发抱有很大期望。可以看一看同一时期的一篇文章用ejb 3.0简化企业java开发。
然而从那时起，java企业使用注解出现一些无法预料的后果和副作用，一些甚至到今天都没有被注意到。幸运的是，并非所有的副作用都没有被注意到，来看一些例子，在stackoverflow标题为“why java annotations?”有很多有价值的评论，“are annotations bad?”这篇文章有很棒的观点，还有“magics is evil”，“annotations…good, bad or worse?”。
并非所有的注解都相同尽管上面许多讨论都包含有价值的观点，但并不是所有注解都是相同的。
这里有两类注解，区别在于他们是否在运行期影响程序。首先，说一下无害的一类，它们并不会在运行期对代码产生任何影响；另一种是有害的一类，它们会修改运行期行为。无害的注解包括@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被称赞为”轻量级”和”简单”，表面上看起来是这样。但是一个微小的，同时也是至关重要的误用蔓延开来。
@stateless public class documentrepository { public document getdocument(string title) { ... } ... }
如果想要获取一个stateless ejb，“只需要”在类上声明@stateless注解。确实，编写这个类只需要只一点动作，但是请注意这个类中有害的注解绑定了几百页的说明文档，而且只能在百万字节的应用服务器(application server)上运行。这又怎么能称的上是”轻量级”呢。所以，这个注解仅仅是真正需要编写的java代码的占位符而已，代码仍需要以某种形式存在。现在只不过是隐藏在注解之下。
不幸的是，这种变通方案称为一种模式，现在有害的注解广泛分布：jpa, cdi, common annotations, jaxb 等等。
有害的注解有时会出现在错误的地点因为注解通常作为开发环境，有时有害的注解被当做单一职责原则(single responsibility principle)或关注点分离(separation of concerns)的最佳实践。
让我们来考虑一下下面这个cdi例子：
@applicationscoped public class documentformatter { ... }
上面的注解描述这个类应该是一个cdi bean，意味着它应该只能由cdi实例化，并确保每个应用中只有一个实例。
这些信息并不属于这个类。这个服务在功能上(无论什么方式)并不会对它在当前应用中的作用产生影响。这里有两个明显的关注点。
一个jpa的简单例子：
@entity @table("person") public class person { ... }
问题在于这种类往往是”领域对象(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中万恶的注解 的内容。