Day28 Java 注解

●Java 自定义注解
创建自定义注解类似於编写接口，不同之处在於interface关键字以@符号为前缀,可以在注解中声明方法。

关於java注解的一些要点是：1.注解方法不能有参数。2.注释方法返回类型仅限於原始类型、字符串、注释或这些类型的数组。3.Java Annotation方法可以有默认值。4.注释可以附有元注释(meta annotations),元注释用於提供有关注释的讯息。

●java中的元注解有五种
1.@Documented:使用此注释的元素要由javadoc和类似工具记录,此类型应用於注释类型声明,这些类型的注释会影响它的客户端对带注释元素的使用,如果使用 Documented对类型声明进行注释,则其注释将成为带注释元素公共API的一部分。

2.@Target:注释类型适用的程序元素的种类,一些可能的值是类型、方法、构造函数、字段等,如果目标元注释不存在,就可以在任何程序元素上使用注释。

3.@Inherited:表示自动继承注解类型,如果用户在类声明上查询注解类型,并且类声明没有针对该类型的注解,则将自动查询该类的超类以获取注解类型,将重复此过程,直到找到此类型的注释,或到达类层次结构的顶部。

4.@Retention:带有注释类型的注释将保留长时间,它采用RetentionPolicy参数,其可能的值为SOURCE、CLASS和RUNTIME。

5.@Repeatable:用於指示其注释的注释类型是可重复的。

●Java 中的内置注解
1.@Override:想要覆盖超类方法时,就应该使用这个注解来通知编译器我们正在覆盖一个方法,因此,当移除或更改超类方法时,编译器将显示错误消息。

2.@Deprecated:希望编译器知道某个方法已被弃用时,应该使用这个注解,Java建议在javadoc中,我们应该提供有关为什麽不推荐使用此方法以及可以使用的替代方法的信息。

3.@SuppressWarnings:这只是告诉编译器忽略它们产生的特定警告,例如在java generics 中使用原始类型,它的保留策略是SOURCE,会被编译器丢弃。

4.@FunctionalInterface:这个注解是在Java 8中引入的，以表明该接口想要成为一个功能接口。

5.@SafeVarargs:程序员表示带注释的方法或构造函数的主体不会对其varargs参数执行潜在的不安全操作。