全面解析JAVA注解详解

定义：注解（Annotation），也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。
作用分类：
①编写文档：通过代码里标识的元数据生成文档【生成文档doc文档】
② 代码分析：通过代码里标识的元数据对代码进行分析【使用反射】
③编译检查：通过代码里标识的元数据让编译器能够实现基本的编译检查【Override】
 一、为什么要学习注解呢？
    在实际的项目中我们会使用大量的框架，很多框架就会使用大量的注解。学习注解能够使我们读懂别人的代码。我们也可以使用注解，自定义注解使我们的代码更清晰更整洁。
二、JDK注解。
  1，@Override代表实现和覆盖父类的方法
  2，@Deprecate代表这个方法已经过时
  3，@SuppressWarnings()意思是忽略，这里是忽略这个deprecation过时的警告
  

package note.demo;

public interface People {

public String name();
public String age();
//代表这个方法已经过时
@Deprecated
public void song();

}

package note.demo;

public class ChilePeople implements People{
//@Override代表实现和覆盖父类的方法
@Override
public String name() {
// TODO Auto-generated method stub
return null;
}

@Override
public String age() {
// TODO Auto-generated method stub
return null;
}
//@SuppressWarnings()意思是忽略，这里是忽略这个deprecation过时的警告
@SuppressWarnings("deprecation")
@Override
public void song() {
// TODO Auto-generated method stub
People people = new ChilePeople();
//化了横线代表此方法已经过时
people.song();
}

}

三、注解的分类。
  1，按照运行机制划分
   源码注解：注解只在源码中存在，编译成Class文件就不存在。
   编译时注解:注解在源码和Class文件中都会存在注解信息。
  运行时注解：在运行阶段还会起作用，甚至会影响运行逻辑的注解。比如很多第三方类库的自定义注解。
  2，按照来源划分
   JDK注解、第三方注解、自定义的注解
  3，元注解
   就是注解的注解
四、自定义注解
  1，使用@interface关键字定义注解
  2，成员的基本类型包括所有的基本类型和String,Class,Annotation,Enumeration
  3，如果注解只有一个成员，成员名必须取名为value().
  4， 注解类可以没有成员，没有成员的注解类成为标识注解
  5，@Target({ElementType.METHOD,ElementType.TYPE})表示注解的作用域（元注解）
  6，@Retention(RetentionPolicy.RUNTIME) 注解的生命周期（元注解）
  7，@Inherited 标识允许子注解来继承这个注解 （注意这里只能是继承不能是接口上使用，而且只能继承类上的注解，不能继承方法上的注解）（元注解）
  8，@Documented 生成javadoc时会包含注解 （元注解）

 

package note.demo;

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;

//表示注解的作用域METHOD方法上，TYPE类或接口
@Target({ElementType.METHOD,ElementType.TYPE})
//生命周期，运行时
@Retention(RetentionPolicy.RUNTIME)
//表示子注解可以继承
@Inherited
//生成doc文档依然存在
@Documented
//使用@interface关键字定义注解
public @interface CustomNoto {
/**
* 成员的基本类型包括所有的基本类型和String,Class,Annotation,Enumeration
* */
String desc();  //这个表示注解的成员，不是方法。成员必须是无参数，无异常
String author();
int age() default 18;  //可以用default给成员制定一个默认的值
}

五、解析注解
  通过反射来获取类，方法，接口，或成员上的运行时注解信息，从而实现动态控制程序运行时的逻辑。
反射是在运行时的，所以我们使用反射时解析，必须注解的生命周期是运行时。

package note.demo;

import java.lang.reflect.Method;

//解析注解
public class ParseNoto {

public static void main(String[] args) {
// TODO Auto-generated method stub
//第一步拿到类类型
try {
Class class1 = Class.forName("note.demo.ChilePeople");
//判断这个类型是否存在这个注解
boolean is = class1.isAnnotationPresent(CustomNoto.class);
if (is == true) {
CustomNoto noto = (CustomNoto) class1.getAnnotation(CustomNoto.class);
System.out.println(noto.desc());
}

//解析方法上的注解
Method[] methods = class1.getMethods();
for (Method method : methods) {
boolean isx = method.isAnnotationPresent(CustomNoto.class);
if (isx) {
CustomNoto cNoto = (CustomNoto)method.getAnnotation(CustomNoto.class);
System.out.println(cNoto.age()+"");
}
}
} catch (ClassNotFoundException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}

}

}