Java注解参数类型枚举值_EffectiveJava-5-枚举和注解

用enum代替int常量

1. int枚举：

引入枚举前，一般是声明一组具名的int常量，每个常量代表一个类型成员，这种方法叫做int枚举模式。

int枚举模式是类型不安全的，例如下面两组常量：性别和动物种类，二者不存在任何关系，然而却可以将ANIMAL_DOG传入一个需要性别参数的方法中，编译器不会出现警告，而且方法内部逻辑还会继续执行比较等操作。

采用int枚举模式的程序是十分脆弱的，因为int枚举是编译时常量，被编译到使用它们的客户端中，如果与枚举常量关联的int值发生变化客户端就必须重新编译，然而不重新编译却不会报错，但是会导致程序的结果不准确，例如上面的常量SEX_MAN被客户端使用，于是将其值1编译到客户端的.class中，然后如果API类中将SEX_MAN的值改为2，却不重新编译客户端，那么客户端得到的结果就是不准确的了。

int枚举常量很难被翻译成可打印的字符串，不利于开发调试。

开发过程中还可能遇到这种模式的变体，如String枚举模式，同样是存在上述问题。

2. 枚举类型：

由一组固定的常量组成的合法值的类型，例如:

实现思路：通过公有静态的final域为每个枚举常量导出实例的类。

枚举类型是类型安全的枚举模式，而且完善类int枚举模式的不足。

枚举类型还允许添加任意的方法和域，并实现任意的接口，它提供类所以Object方法的高级实现，实现了Comparable和Serializable接口，并针对枚举类型的可任意改变性设计了序列化方式。

特定于常量的方法实现：

在枚举类型中声明一个抽象方法，并在特定于常量的类主体中，用具体的方法覆盖每个常量的抽象方法。例如下面这样定义一个代表加减乘除等运算符的枚举。

策略枚举：多个枚举常量同时共享相同的行为时，考虑使用策略枚举。

例如下面这样：

用实例域代替序数

序数：枚举天生就与一个单独的int值相关联，所有枚举都有一个ordinal()方法，返回每个枚举常量在类型中的数字位置(类似于数组索引)。

永远不要根据枚举的序数导出与他相关联的值，而是将它保存在一个实例域中 (Enum规范中关于ordinal()写到："大多数程序员都不需要这个方法，它是设计成用于像EnumSet，EnumMap这种基于枚举的通用数据结构的)。

用EnumSet代替位域

位域：可以用or(|)位运算将几个常量合并到一个集合中,例如下面代码这样：

位域的不足：具有int枚举的所有缺点

替代方案--EnumSet：从单个枚举类型中提取多个值，每个EnumSet内容都表示为位矢量， 如果底层的枚举类型有64或更少的元素(大多如此)，整个EnumSet就是用单个long来表示， 因此，它的性能比得上位域的性能

用EnumMap代替序数索引

使用序数索引ordinal的场景：

上面代码实现了对花园中对植物进行分类，然而存在许多问题:

1.数组不能与泛型兼容，需要进行未受检对转换；

2.set数组并不知道每个索引set的set代表什么；

3. 之前有提到不推荐使用ordinal；

解决方案：EnumMap

用接口模拟可伸缩的枚举：

虽然无法编写可扩展的枚举类型，却可以通过编写接口以及实现该接口的基础枚举类型，对它进行模拟，这样允许客户端编写自己的枚举来实现接口；如果API是根据接口编写的，那么在使用基础枚举类型的任何地方，也都可以使用这些枚举。例如下面代码，还是用之前的算数运算符举例：(但是这样还是有些不足，就是无法实现从一个枚举类型继承到另一个枚举类型，代码少的当然可以直接复制粘贴， 如果功能比较多则可以将他们封装在一个辅助类或静态辅助方法中，避免代码的复制工作)。

注解优先于命名模式

- 命名模式：有些程序元素需要通过某种工具或框架进行特殊处理

例1：JUnit测试框架原本要求用户一定要用test作为测试方法名的开头

例2：iOS中的init方法要求必须是initXXX()

- 命名模式缺陷：

1. 文字拼写错误会导致失败，且没有任何提示，造成错误的安全感，如JUnit的测试方法testXX写成textXX或tsetXX等

2. 无法确保他们只用于相应的程序元素，如JUnit的命名只对方法生效，将某个类命名testXX是无效的，不会报错，但不会执行测试

3. 没有提供将参数值与程序元素关联起来的好方法，如JUnit想增加一种测试类别，只在抛出某种特定异常时才会成功, 而这个异常类型需要用户通过参数进行自定义，这种实现通过命名模式实现(将异常类型编写到方法名中)并不理想。

注解对上面问题的解决，请看下面代码:

坚持使用Override注解

应该在想要覆盖超类声明的每个方法声明中使用Override注解 例如我们经常会重写自定义模型类的equals方法，下面用代码说明使用Override注解的优势。

使用Override还有一点好处，就是可以区分哪些方法是超类对，哪些方法子类扩展对

用标记接口定义类型

标记接口：没有方法声明，只是表示具有某种属性，如Serializable接口

标记接口的优点 ：

1. 标记接口定义的类型是由被标记类的实例实现的，标记注解则没有这样的类型

2. 标记接口可以更加精确的被锁定，可以是对其他接口的扩展，也可以被其他标记接口扩展，如Collection和Set

标记注解的优点：1. 可以通过默认方式添加一个或多个注解类型的元素，给已被使用的注解类型添加更多的信息，方便扩展

2. 另一个优点在于它们是更大的注解机制的一部分，因此，标记注解，在那些支持注解作为编程元素之一的框架中同样具有一致性

如何选择？

- 如果标记是应用到任何程序元素而不只是类或接口，那就必须使用注解

- 如果只是用于类或接口，需要考虑要编写只接受有这种标记的方法，使用接口作为相关方法的参数类型， 可以提供编译时就进行类型检查的好处

- 是否要永远限制这个标记只用于特殊接口的元素，如果是，最好将标记定义成该接口的一个子接口

我是今阳，如果想要进阶和了解更多的干货，欢迎关注公众号”今阳说“接收我的最新文章