Java——注解

Java——注解

注解的作用

Java中注解和注释一样，都可以为代码做一些说明，但是在编译后注释并不会保留，但注解仍可以通过反射获取一些标注内容。注解还可以在一些情况下代替配置文件的使用，结构简单，使用简单，效率也会比配置文件的解析高一些。

注解的分类

注解按照参数个数可以分为标记注解（没有参数）、单值注解（参数只有一个）、完整注解（参数多个）。

按照功能分，可以分为元注解、一般内置注解、自定义注解。java中的元注解就是用来描述注解类型的一类注解。元注解总共有四个：

• @Target - 标记这个注解应该作用于哪种 Java 成员。内部一个参数，类型为ElementType[]，这是一个枚举数组，参数可选一个或多个。

public enum ElementType {
    TYPE,                 //类、接口（包括注释类型）或枚举声明
    FIELD,                //字段声明（包括枚举常量）
    METHOD,               //方法声明
    PARAMETER,            //参数声明
    CONSTRUCTOR,          //构造方法声明
    LOCAL_VARIABLE,       //局部变量声明
    ANNOTATION_TYPE,      //注释类型声明
    PACKAGE               //包声明
}

• @Retention 定义注解的生命周期，参数为RetentionPolicy枚举类，SOURCE->编译器检查语法时有效 …

public enum RetentionPolicy {
    SOURCE,			//作用在源码期
    CLASS,			//作用在字节码期
    RUNTIME			//作用在运行期
}

• @Documented 表示使用该注解的元素应被javadoc或类似工具文档化显示\
• @Inherited标识这注解类型可以被继承。例如A类被@Inherited注解，它的子类可以继承这个注解。

java的其它内置注解：

• @Override，没有参数，标注在方法上，检查方法是否为重写方法。
• @Deprecated ，标识这是一个过时的类型，可以注解在ElementType的所有枚举成员上。
• @SuppressWarnings，抑制警告。指示编译器去忽略注解中声明的警告。
• @FunctionalInterface，检查是否为函数式接口

自定义注解

注解用@interface来表示，写一个自定义注解：

/*
 *自定义注解
 */
@Documented
@Target(ElementType.TYPE)  				//注解作用范围
@Retention(RetentionPolicy.RUNTIME)     //注解生命周期
@interface MyAnnotation1{
	//注解的参数value()不是方法，String[]类型，default后为默认值。
    String[] value() default {"光头强","熊大","熊二"};
}

注解可以在运行期间通过反射获取参数等内容。

//自定义注解标注在类上，生命周期为运行时期，参数默认赋值
@MyAnnotation1()
public class Demo01 {
	public static void main(String[] args) throws NoSuchMethodException, SecurityException {
        //获取当前类的Class对象
		Class cls = Demo01.class;
        //getAnnotation(Class类型表示要获取的标注)，需要强转才能获取value值
		MyAnnotation1 anno = (MyAnnotation1) cls.getAnnotation(MyAnnotation1.class);
		//获取value
        String[] str = anno.value();
		System.out.println(Arrays.toString(str));//打印结果：[光头强, 熊大, 熊二]
	}
}