第十八章 自定义泛型、枚举与注释

18.1　自定义泛型

泛型定义：

（1）仅定义在方法上的泛型语法 
（2）用来限制泛型可用类型的extends与super关键字
（3）？类型通配字符的使用

18.1.1　使用extends与?

1、若extends之后指定了类与接口，想再指定其他接口，可以使用&连接。

2、如果B是A的子类，而Node< B>可视为一种Node< A>，则称Node具有共变性或有弹性的。Java泛型不具有共变性，可以使用类型通配字符？与extends来声明变量，使其达到类似的共变性。

3、若声明？不搭配extends，则默认为？ extends Object。

Node<?> node = null；//相当于Node<? extends Object>

4、java的泛型语法在执行时期实际上只会知道是Object类型，由于无法在执行时期获得类型信息，编译程序只能就编译时期看到的类型来做检查，因而造成以上谈及的限制。

18.1.2　使用super与?

1、如果B是A的子类，而Node< A>可视为一种Node< B>，则称为Node具有逆变性。Java泛型不具有逆变性，可以使用类型通配字符？与super来声明，使其达到类似的逆变性的效果。

2、若泛型类或接口不具共变性或逆变性，则称为不可变的或严谨的。

18.2　自定义枚举

18.2.1　了解java.lang.Enum类

1、直接撰写程序继承Enum类会被编译程序拒绝。

2、Enum是个抽象类，无法直接实例化，它操作了Comparable接口。Action的构造函数被声明为private，因此只能在Action类中调用。

3、在JDK1.4之前撰写的API，仍是使用interface定义常数作为枚举值。

4、Enum的equals()方法与hashCode()方法基本上继承了Object的行为，但被标示为final。由于标示为final，所以定义枚举是，不能重新操作equals()与hashCode()，这是因为枚举成员，在JVM中智慧存在单一实例，Object定义的equals()与hashCode()作为对象相等性比较是适当的定义。

18.2.2　enum高级运用

1、values()方法，将内部维护Action枚举实例的数据复制后返回。如果想要知道有哪些枚举成员，就可以使用这个方法。

2、Enum类可以自行定义构造函数，但不得为公开构造函数，也不可以在构造函数中调用super()。

3、在enum中调用构造函数比较特别，直接在枚举成员后加上括号，就可以指定构造函数需要的自变量。

4、在static区块中，编译程序仍自行维护name与ordinal的值，接着才是调用自定义构造函数时传入的value值。

5、特定值类本体语法：在枚举成员后，直接加上{}操作Command的execute()方法，这代表着每个枚举实例都会有不同的execute()曹组欧，在职责分配上，比switch的方式清楚许多。特定值类本体语法不仅在操作接口时可以使用，，也可以运用在重新定义父类方法。

18.3　关于注释

在原始码中使用注释，对编译程序提供额外编译提示，或提供应用程序执行时期可读取的组态信息。注释可以仅用于原始码，编译后留在.class文档仅供编译程序读取或开放执行时期读取。

18.3.1　常用标准注释

1、@Override 
就是标准注释，被注释的方法必须是父类或接口中已定义的方法，请编译程序协助是否真的为重新定义方法。

2、@Deprecated 
如果某个方法原先存在与API中，后来不建议再使用，可以在该方法上注释。若有用户后续想调用或重新定义这个方法，编译程序会提出警告。对于支持泛型的API，建议明确指定泛型真正类型，如果没有指定，编译程序会提出警告。

3、@SuppressWarnings 
指定抑制unchecked的警告产生：

@SuppressWarnings(value={"unchecked"})

4、@SafeVarargs 
表明开发人员确定避免了heap pollution问题。heap pollution问题就是编译程序无法检查执行时期的类型错误，无法具体确认自变量类型。

5、@FunctionalInterface 
让编译程序可协助检查interface是否可做为lambda的目标类型

18.3.2　自定义注释类型

1、标示注释：就是注释名称本身就是信息，对编译程序或应用程序来说，主要是检查是否有注释出现，并作出对应的动作。

2、相关规则：

（1）如果注释名称本身无法提供足够信息，设置单值注释 
（2）注释属性也可以用数组形式指定。 
（3）在定义注释属性时，如果属性名称为value，则可以省略属性名称，直接指定值。 
（4）对成员设定默认值，使用default关键字即可。 
（5）要设定数组默认值，可以在default之后加上{}，必要时{}中可放置元素值。

3、定义注释时，可使用java.lang.annotation.Target限定时可指定java.lang.annotation.ElementType的枚举值。

4、在制作JavaDoc文件时，默认不会将注释数据加入文件中，如果想要将注释数据加入文件，可以使用java.lang.annotation.Documented。

5、默认父类设定的注释，不会被继承至子类，在定义注释时，设定java.lang.annotation.Inherited注释，就可以让注释被子类继承。

18.3.3　JDK8标注增强功能

1、ElementType的枚举成员是用来限定哪个声明位置可以进行标注。在JDK8中，增加了两个枚举成员TYPE _PARAMETER、TYPE _USE。

2、ElementType.TYPE _ USE可用于标注在各式类型，一个标注如果被设定为ElementType.TYPE_USE，只要是类型名称，都可以进行标注。

3、@Repeatable 
可以让你在同一个位置重复相同标注

4、@Filters 
作为收集重复标注信息的容器，而每个@Filters储存各自指定的字符串值。

18.3.4　执行时期读取注释信息

1、自定义注释，默认会将注释信息存储于.class文档，可被编译程序或位码分析工具读取，但执行时期无法读取注释信息，在执行时期读取注释信息，可以使用java.lang.annotation.Retention搭配java.lang.annotation.RetentionPolicy枚举指定。

2、RetentionPolicy为RUNTIME的时机，在于让注释在执行时期提供应用程序信息，可使用java.lang.reflect.AnnotatedElement接口操作对象取得注释信息。

3、JDK 8中新增了getDeclaredAnnotation()、getDeclaredAnnotationsByType()、getAnnotationsByType()三个方法。 
getDeclaredAnnotation()可以让你取回指定的标注，在指定@Repeatable的标注时，会寻找收集重复标注的容器。 
getDeclaredAnnotationsByType()、getAnnotationsByType()就不会处理@Repeatable的标记。