java @interface 注解基础知识

注解

    java用  @interface test{ } 定义一个注解 @test，一个注解是一个类

    注解相当于一种标记，在程序中加上了注解就等于为程序加上了某种标记，以后，JAVAC编译器，开发工具和其他程序可以用反射来了解你的类以及各种元素上有无任何标记，看你有什么标记，就去干相应的事

    @Override，@Deprecated，@SuppressWarnings为常见的3个注解

     注解@Override用在方法上，当我们想重写一个方法时，在方法上加@Override，当我们方法的名字出错时，编译器就会报错，如图：

    注解@Deprecated，用来表示某个类的属性或方法已经过时，不想别人再用时，在属性和方法上用@Deprecated修饰，如图：

     注解@SuppressWarnings用来压制程序中出来的警告，比如在没有用泛型或是方法已经过时的时候会有黄线警告

@Retention

    注解@Retention可以用来修饰注解，是注解的注解，称为元注解 

    Retention注解有一个属性value，是RetentionPolicy类型的，Enum RetentionPolicy是一个枚举类型

    这个枚举决定了Retention注解应该如何去保持，也可理解为Rentention 搭配 RententionPolicy使用

    RetentionPolicy有3个值：CLASS  RUNTIME   SOURCE

@Retention(RetentionPolicy.CLASS)	表示注解的信息被保留在class文件(字节码文件)中当程序编译时，但不会被虚拟机读取在运行的时候
@Retention(RetentionPolicy.SOURCE)	表示注解的信息会被编译器抛弃，不会留在class文件中，注解的信息只会留在源文件中
@Retention(RetentionPolicy.RUNTIME)	表示注解的信息被保留在class文件(字节码文件)中当程序编译时，会被虚拟机保留在运行时

@Target

    注解@Target也是用来修饰注解的元注解，它有一个属性ElementType也是枚举类型

    值为：ANNOTATION_TYPE CONSTRUCTOR  FIELD LOCAL_VARIABLE METHOD PACKAGE PARAMETER TYPE

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

    如@Target(ElementType.METHOD) 修饰的注解表示该注解只能用来修饰在方法上，如果放到其他上面如类，则程序报错，如图：

@Inherited

    注解@Inherited也是用来修饰注解的元注解,作用是使用此注解声明的自定义注解，如果使用在类上时，子类会自动继承该自定义的注解，否则子类不会继承次注解。注意：使用Inherited声明的注解，只能在类上有效，对方法、参数其他无效，代码例子：

/**
 * 声明的此注解使用了Inherited元注解，表示此注解用在类上时，会被子类所继承
 */
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface InheritedTest {
 
	String value();
}

/**
 * 声明的此注解没有使用Inherited元注解，表示此注解用在类上时，不会被子类所继承
 */
@Retention(RetentionPolicy.RUNTIME)
public @interface InheritedTest2 {
 
	String value();
}

/**
 * 父类
 */
@InheritedTest("使用Inherited的注解 class")
@InheritedTest2("未使用Inherited的注解 class")
public class Parent {
 
	@InheritedTest("使用Inherited的注解 method")
	@InheritedTest2("未使用Inherited的注解 method")
	public void method(){
		
	}
}

/**
 * 子类
 */
public class Child extends Parent {
 
	@Override
	public void method() {
	}
}

/**
 * 通过反射进行测试
 */
public class test {
 
	public static void main(String[] args) throws NoSuchMethodException, SecurityException, NoSuchFieldException {
		Class<Child> clazz = Child.class;
		//对类进行测试 
		System.out.println("对类进行测试");
		if(clazz.isAnnotationPresent(InheritedTest.class)){
			System.out.println(clazz.getAnnotation(InheritedTest.class).value());
		}
		if(clazz.isAnnotationPresent(InheritedTest2.class)){
			System.out.println(clazz.getAnnotation(InheritedTest2.class).value());
		}
		System.out.println();
		//对方法 进行测试
		System.out.println("对方法进行测试");
		Method method = clazz.getMethod("method", null);
		if(method.isAnnotationPresent(InheritedTest.class)){
			System.out.println(method.getAnnotation(InheritedTest.class).value());
		}
		if(method.isAnnotationPresent(InheritedTest2.class)){
			System.out.println(method.getAnnotation(InheritedTest2.class).value());
		}
		System.out.println();
	}
}

     输出如下

对类进行测试
使用Inherited的注解 class

对方法进行测试

    通过结果可以看出，@Inhreited注解声明的自定义注解，在类上使用时可以被子类继承，而通过重写父类的方法来测试看，证明@Inherited对除了类以为的地方无效。

    例子2：

@Inherited
public @interface MyParentObject { 
      boolean isInherited() default true;
      String doSomething() default "Do what?";
}

@MyParentObject
public Class MyChildObject {
}

    因为使用 @Inherited标记，isInherited()、doSomething()这些都自动继承了