一、注解(Annotation)简介
Annotation(注解)是JDK1.5及以后版本引入的一个新特性,注解是Java的一个新的类型(与接口很相似),它与类、接口、枚举是在同一个层次,它们都称为Java的一个类型(TYPE)。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面,用来对这些元素进行说明,注释。它的作用非常的多,例如:进行编译检查、生成说明文档,代码分析等。
JDK提供的几个基本注解
- @SuppressWarnings
该注解的作用是阻止编译器发出某些警告信息。
它可以有以下参数:
deprecation:过时的类或方法警告
unchecked:执行了未检查的转换时警告
fallthrough:当Switch程序块直接通往下一种情况而没有Break时的警告
serial: 当在可序化的类上缺少serialVersionUID定义时的警告。
finally:任何finally子句不能完成时的警告。
all:关于以上所有情况的警告。
- @Deprecated
该注解的作用是标记某个过时的类或方法。
- @Override
该注解用在方法前面,用来标识该方法是重写父类的某个方法。
二、元注解
元注解是定义在注解类的前面,注释注解的。
- @Retention
它是被定义在一个注解类的前面,用来说明该注解的生命周期。
它有以下参数:
RetentionPolicy.SOURCE:指定注解只保留在一个源文件当中。
RetentionPolicy.CLASS:指定注解只保留在一个class文件中。
RetentionPolicy.RUNTIME:指定注解可以保留在程序运行期间。
- @Target
它是被定义在一个注解类的前面,用来说明该注解可以被声明在哪些元素前。它有以下参数:
ElementType.TYPE:说明该注解只能被声明在一个类前。
ElementType.FIELD:说明该注解只能被声明在一个类的字段前。
ElementType.METHOD:说明该注解只能在一个类的方法前。
ElementType. PAEAMENTER:说明该注解只能被声明在一个方法参数前。
ElementType.CONSTRUCTOR:说明该注解只能声明在一个类的构造方法前。
ElementType.LOCAL_VARIABLE:说明该注解只能声明在一个局部变量前。
ElementType.ANNOTATION_TYPE:该注解可以声明在一个注解类前。
ElementType.PACKAGE:该注解可以声明在一个包前。
三、注解的生命周期
一个注解可以有三个声明周期,它默认的声明周期是保留在一个CLASS文件。但它也可以有一个@Retetion的元注解来指定它的声明周期。
- Java源文件
当在一个注解前定义了一个@@Retention(RetentionPolicy.SOURCE) 的注解,那么说明该注解只保留在一个源文件当中,当编译器将原文件编译成CLASS文件时,他不会将源文件中定义的注解保留在CLASS文件中。
- CLASS文件
当在一个注解前定义了一个@Retention(RetentionPolicy.CLASS)的注解,那么说明该注解只能保留在一个CLASS文件当中当加载CLASS文件到内存时,虚拟街会将注解去掉,从而在程序中不能访问。
- 程序运行期间
当在一个注解类前定义了一个@Retention(RetentionPolicy.RUNTIME)的注解,那么说明该注解在程序运行期间都会存在内存当中。此时,我们可以通过反射来获得定义在某个类上的所有注解。
四、注解的应用
例: 注解的定义以及反射的调用和为注解增加基本属性
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import javax.lang.model.element.Element;
@Retention(RetentionPolicy.RUNTIME)//说明注解的生命周期
@Target({ElementType.METHOD,ElementType.TYPE})//说明注解声明的位置
public @interface MyAnnotation {
//为注解增加属性
String color() default "Green";
String value();
int[] arrayAccet();
}
public class AnnotationTest1 {
@MyAnnotation(color="BULLOW",value="haha",arrayAccet={1,2,3})//自定义带属性的注解
public static void main(String[] args)throws Exception{
if(AnnotationTest1.class.getMethod("main", String[].class).isAnnotationPresent(MyAnnotation.class)){
MyAnnotation myAnnotation=(MyAnnotation)AnnotationTest1.class.getMethod("main", String[].class).getAnnotation(MyAnnotation.class);
System.out.println(myAnnotation);
System.out.println(myAnnotation.color());
System.out.println(myAnnotation.value());
System.out.println(myAnnotation.arrayAccet().length);
}
}
}
运行结果: