详述自定义注解

注解

概念

1，JDK5及其以后JDK版本开始支持Java注解；,
2，Java注解（Annotation）也叫作元数据，以‘@注解名’在代码中存在，它是一种在源代码中标注的特殊标记，可以标注源代码中的类、属性、方法、参数等代码，主要用于创建文档，跟踪代码中的依赖性，甚至执行基本编译时检查。

分类

Java注解按照是否含有参数分为三种：
1，不带参数，语法结构为：@Annotation

2，带一个参数的注解，语法结构为：@Annotation(参数)

红框中代码也可写为@SuppressWarnings(value = “unused”)

3，带多个参数的注解，语法结构为：@Annotiation(参数1, 参数2, 参数3…)

红框中代码也可@SuppressWarnings(value = { “unused”, “deprecation” })

内置注解

@Override

@Override被用于标注方法，用于说明所标注的方法是重写父类的方法：


子类重写父类的方法可用@Override标注
为了支持@Override，需要将项目工程升级为1.6或其以上版本；如果升级后Java代码没问题，但是工程报错，可以通过如下操作解决：右键项目“Properties”——>“Project Facets”——>右边java项选择相应的版本就OK了。

@Deprecated

@Deprecated 用于说明所标注元素（成员变量或方法）因存在安全问题或有更好选择而不鼓励程序员使用，如果强行使用，则编译器会发出警告。

因Date类中getHours()添加了@Deprecated注解，所以使用时出现了黄色波浪线

@SuppressWarnings

@SuppressWarnings用于取消编译器所显示的警告，该注解常用属性值如下：
1，deprecation：使用已被@Deprecated标注的程序元素；

2，unused：程序含有未被使用的元素；

3，serial：在可序列化的类上缺少serialVersionUID定义；

自定义注解

注解语法结构：

[public] @interface 注解名 {
	[属性1;]
	[属性2;]
	...
	[属性n;]
}

属性语法结构：

定义一个String []类型的value注解属性


注意：
1，注解属性默认没有默认值，如果注解中定义了无默认值的注解属性，则使用该注解时必须指定值：
看如下例子：
定义一个String []类型的value注解属性，但是没有设定默认值。


由于使用@SuppressWarnings自定义注解，该注解value属性没有默认，并且使用时又没有设定具体值，所以代码语法不通过，下边语法正确。

2，如果注解属性名为value，使用该注解时可以直接赋值：
看如下例子：


由于@SuppressWarnings注解内定义的注解属性的属性名为value，所以赋值时可以省略“value=”。
3，如果注解属性的数据类型为数组类型，赋多个值时必须使用{}括起来；但若只赋一个值，则无需使用{}：
看如下例子：


由于value注解属性有多个值，所以赋值时必须使用{}将值括起来

value注解属性只有一个值，所以赋值时无需使用{}将值括起来

元注解

Java提供了四个用于修饰自定义注解的元注解：@Target、@Retention 、@Documented和@Inherited
1，@Target：用于指定被修饰的自定义注解只能用于修饰程序中哪些元素，该元注解常见属性值如下：
ElementType.FIELD：应用于全局属性
ElementType.METHOD：应用于方法
ElementType.PARAMETER：应用于方法的参数
ElementType.TYPE：应用于类、接口或者枚举声明
看如下例子：

限制自定义注解@Override只能用来标注方法。注意：由前面知识可知大括号可以去掉

2，@Retention：用于指定被修饰的自定义注解可以保留多久，该元注解有如下属性值：
RetentionPolicy.SOURCE：编译器将直接丢弃被修饰的注解。
RetentionPolicy.CLASS：默认值，编译器将把注解记录在class文件中，当运行Java程序时，虚拟机不再保留注解；
RetentionPolicy.RUNTIME：编译器将把注解记录在class文件中，当运行java程序时，虚拟机保留注解，程序可以通过反射获取该注解；
看如下例子：

当运行java程序时，JVM虚拟机保留注解


3，@Documented：执行javadoc命令时，被该元注解修饰的自定义注解也会生成在文档中，
看如下例子：


4，@Inherited：如果父类所使用的注解有@Inherited修饰，则子类可以继承该注解，否则不能继承。
看如下例子：

Father类添加了由@Inherited元注释所修饰的Bean自定义注解，所以有内容输出；如果将@Inherited元注释去掉，尽管Father类依然有Bean自定义注解，但却没有内容输出。