概述
注解时在Java5中开始引入的概念。可以将注解想象成标签,给指定的方法、类、变量、参数、包等贴上一个标签。
@Override 注解就是告诉编译器,这个方法是重写的父类方法。
还有@Test、@Deprecated等等
自定义注解
自己定义注解的语法也很简单:
然后就可以使用该注解了。
注意,注解时不可以继承的,默认继承Annotation接口。
在Java中有一些特殊的注解,被称为元注解,简单说就是可以注解注解的注解,用来标识注解的作用范围等,有如下元注解:
1.@Retention
Retention是保留的意思,它标注了注解的存活时间,取值如下:
- RetentionPolicy.SOURCE:注解只在源码阶段保留,在编译器进行编译时它将被丢弃忽视。
- RetentionPolicy.CLASS:注解只被保留到编译进行的时候,它并不会被加载到 JVM 中。
- RetentionPolicy.RUNTIME:注解可以保留到程序运行的时候,它会被加载进入到 JVM 中,所以在程序运行时可以获取到它们。
2.@Documented
Docmented是将注解中的元素包含到Javadoc中
3.@Target
target是目标的意思, 它指明了注解运用的地方,如方法、类等,有如下取值:
- ElementType.ANNOTATION_TYPE: 对注解进行注解
- ElementType.CONSTRUCTOR:对构造方法进行注解
- ElementType.FIELD:对属性进行注解
- ElementType.LOCAL_VARIABLE:对局部变量进行注解
- ElementType.METHOD:对方法进行注解
- ElementType.PACKAGE:对一个包进行注解
- ElementType.PARAMETER:对一个方法内的参数进行注解
- ElementType.TYPE:对一个类型进行注解,比如类、接口、枚举
当有多个时用逗号隔开,如:
@Target(value={ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR})
4.@Inherited
Inherited是继承的意思,若一个超类被@Inherited注解过的注解进行了注解的话,那么它的子类如果没有被任何注解进行注解的话,就会继承超类的注解。
5.@Repeatable
Repeatable是可重复的意思,就是说这个注解可以进行多次注解,即可以进行多个注解。
以上就是Java中的元注解。
注解属性:
注解的属性就是他的成员变量,注解只有成员变量,属性在注解中以无参的方法形式来声明,方法名为变量名,返回值为该变量的类型,属性若没有默认值需要在使用的时候进行赋值
属性的声明如下形式:
// int类型的id
int id();
// 字符串类型的msg变量
String msg();
// int类型的id,默认值为-1,即在声明的可以给该变量赋值,为默认值
int id() default -1;
如以下注解:
同时,若注解中只有一个value属性,在使用时可以不指定属性名,如下所示:
若注解中没有任何属性,则使用注解时括号可以省略,如下所示:
以上,就是自定义注解的方式
注解的提取
有了自定义的注解,还要去使用它,下面看看注解的提取
在Java中用来描述注解的基类是Annotation
要提取注解就要使用到反射,Class对象的如下方法:
- isAnnotationPresent(Class<? extends Annotation>): 验证Class对象是否应用了某个注解
- getAnnotation(Class): 获取注解对象
- getAnnotations(): 获取所有注解对象数组,包含从父类继承的
- getDeclaredAnnotations():获取所有注解对象数组,不包含从父类继承的
注解添加如下:
获取操作如下所示:
运行结果:
需要注意的是,若一个注解需要在运行时被提取,那么@Retention(RetentionPolicy.RUNTIME)是必须的。
以上就是注解的定义与提取
Java预置的注解
- @Deprecated:标记过时的方法
- @Override:标记重写父类的方法
- @SuppressWarnings:阻止警告
- @FunctionallInterface:函数式接口注解