Java的注解

一：什么是注解

    Annotation(注解)就是java提供了一种元程序中元素关联任何信息和任何元数据的途径和方法。注解是一个接口，程序可以通过反射来获取注解中的元数据。

二：注解有什么用？

    1：生成文档，这也是java最早提供的注解。

    2：跟踪代码的依赖性，实现替代配置文件功能。

    3：在编译时进行格式检查，如@Override放在方法前，如果你这个方法并不是覆盖了超类方法，则编译时就能检查出错误。

三：JDK自带的注解

    1：@Override：用来覆盖父类的一个方法

    2：@Deprecated：弃用这个注解是程序员不鼓励使用的，通常是因为它是危险的。当使用或覆盖弃用的程序元素时，编辑器会发出警告

    3：@SuppressWarnings：如果我们一定要用过时的方法，那么可以在过时的方法上面加上这个注解

public interface Person {
	public String name();
	public int age();
	@Deprecated //表示弃用singsong这个方法
	public void singsong();
}

public class Woman implements Person {
	@Override  //重写父类的方法
	public String name() {
		return null;
	}
	@Override
	public int age() {
		return 0;
	}
	@Override
	public void singsong() {
	}
}
public class Test {	
	@SuppressWarnings("deprecation")//  需要使用singsong时应该加这个注解
	public void singsong(){
		Person woman=new Woman();
		woman.singsong();
	}
}

四：注解的分类

    1：按照运行机制分类：

        源码时注解：注解只要源码中存在，编译成.class文件之后就不存在了

        编译时注解：注解在源码和编译文件中都存在。JDK自带的三个注解都属于编译时的注解

        运行时注解：在运行阶段还起作用，并且还会影响程序的逻辑。

    2：按来源来分：

        JDK自带的注解

        三方的注解

        自定义的注解

    3：按照注解的参数个数来分：

        标记注解：一个没有成员定义的Annotation类型被称为标记注解。这种Annotation类型仅适用自身的存在与否来为我们提供信息。比如@Override

        单值注解

        完整注解

五：元注解

    元注解的作用就是给注解进行注解，java5.0定义的元注解有：

        1）：@Target：可以用来修饰哪些程序元素，如TYPE，METHOD，TIELD，PARAMETER，CONSTRUCTOR等，为标注则可以修饰所有

        2）：@Documented：是否会保存到javadoc文档中

        3）：@Retention：保留时间，可选值：SOURCE（源码时），CLASS（编译时），也是默认值，RUNTIME（运行时）

        4）：Inherited：是否可以被继承，默认值为false

六：什么是元数据

    就是关于数据的数据的意思。它的作用大致有三类：

        1）：编写文档：通过代码里标识的元数据生成文档

        2）：代码分析：通过代码里标识的元数据对代码进行分析

        3）：编译检查：通过代码里标识的元数据让编译器能实现基本的编译检查

七：自定义的注解

    1：语法要求：

public @interface Desription{   //-->①：使用@interface关键字定义注解
	string desc();   //-->②：成员无参无异常方式声明
	
	String author();
	
	int age() default 18;  //-->可以用default为成员指定一个默认值
}

 注意：①：成员类型是受限制的，合法的类型包括原始类型以及String，Class，Annotation，Enummeration

           ②：如果注解只有一个成员变量，则成员名必须为value()，在使用的时候可以忽略成员名和赋值号。

           ③：注解类可以没有成员，没有成员的注解为标识注解

    2：使用自定义注解的语法： 

@<注解名>(<成员名1>=<成员值1>..)

    3：解析注解：通过反射获取类，函数或成员上的运行时注解信息，从而实现动态控制程序运行的逻辑

public interface Person {
	public String name();
	public int age();
	public void singsong();
}

@Description("i am a class annotation")
public class Woman implements Person {
	
	@Description("the name method")
	@Override
	public String name() {
		return null;
	}
	@Override
	public int age() {
		return 0;
	}
	@Override
	public void singsong() {
	}
}

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target({ElementType.METHOD,ElementType.TYPE}) //表明这个注解在什么类型上可以使用 
@Retention(RetentionPolicy.RUNTIME) //表示注解的运行机制
@Inherited //注解能否被继承,当注解被用在接口上时，不能被继承，要被用在类上
@Documented //注解生成Javadoc文件
public @interface Description {
	String value();
}

public class ParseAnnotation {

	public static void main(String[] args) {
		try {
			//1.使用类加载器加载类
			Class c = Class.forName("com.swpu.Woman");
			//2.找到类上面的注解
			Boolean isExist=c.isAnnotationPresent(Description.class);
			if(isExist){
			//3.拿到注解实例
				Description d=(Description)c.getAnnotation(Description.class);
				System.out.println(d.value());
			}
			//4.找到方法上面的注解
				Method[] ms=c.getMethods();
				for(Method m:ms){
				Boolean isMExist=m.isAnnotationPresent(Description.class);
				if(isMExist){
					Description d=(Description)m.getAnnotation(Description.class);
					System.out.println(d.value());
				}
				}
			//另外一种解析方法
				for(Method m:ms){
					Annotation[] as=m.getAnnotations();
					for(Annotation a:as){
						if(a instanceof Description){
							System.out.println(((Description) a).value());
						}
					}
				}
		} catch (ClassNotFoundException e) {
			e.printStackTrace();
		}
	}
}

运行结果为：