2018-05-25java注解

一、定义：注解是一系列元数据，它提供数据用来解释程序代码，但是注解并非是所解释的代码本身的一部分。注解对于代码的运行效果没有直接影响。

注解有许多用处，主要如下：

• 提供信息给编译器： 编译器可以利用注解来探测错误和警告信息
• 编译阶段时的处理： 软件工具可以用来利用注解信息来生成代码、Html文档或者做其它相应处理。
• 运行时的处理： 某些注解可以在程序运行的时候接受代码的提取

---

二、注解的类型

• java预置的注解

@Deprecated: 用以告知用户该方法、属性或类已过时
@Override:子类复写父类中被@Override修饰的方法
@SupressWarnings:消除警告
@SafeVarargs:参数安全类型注解
@FunctionalInterface:函数式接口（指只有一个方法的普通接口）
函数式接口很容易转换为Lambda表达式。

• 元注解（注解上的注解。。。）

@Retention:解释说明了这个注解的存活时间，有以下取值：

（1）RetentionPolicy.SOURCE：该注解只在源码阶段保留，编译阶段忽略丢弃
（2）RetentionPolicy.CLASS: 该注解只被保留到编译进行的时候，不会加载到JVM
（3）RetentionPolicy.RUNTIME:该注解可以保留到程序运行时，会被加载到JVM，程序运行时可以获得他们

@Target:指定了注解运用的地方，有以下取值：

（1）ElementType.ANNOTATION_TYPE:该注解给一个注解进行注解
（2）ElementType.CONSTRUCTOR：该注解给构造函数进行注解
类似的还有：ElementType.FIELD（属性）,ElementType.LOCAL_VARIABLE（局部变量）,ElenmentType.METHOD（方法）,ElementType.PACKAGE（包）,ElenmentType.PARAMETER（参数）,ElementType.TYPE（给一个数据类型注解，枚举类型，class类型,接口类型，基本数据类型）

@Inherited:子类将拥有父类的注解

@Repeatable:java8新特性，注解的属性值可以取多个

---

三、自定义注解

先创建个User注解

package annotation;

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

@Target(ElementType.METHOD)             //指明该注解出现在method上方
@Retention(RetentionPolicy.RUNTIME)     //指明该注解直至运行时依旧有效

public @interface User {
    int id();
    String name();
}

在School类中的方法试试@User注解

package annotation;

public class School {
    
    //@User()                   //该注解出现在此处编译器会报错，因为我们之前指定
                                //了该注解作用在方法上
    private int size;
    
    @User(id=20)
    public void whoIsAm(int id){
        System.out.println(id);
    }
    
    @User(name="哼哈")
    public void _whoIsAm(String name){
        System.out.println(name);
    }
}

接下来试试通过反射提取注解，嘿嘿嘿

package annotation;

import java.lang.annotation.Annotation;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;

public class Demo1 {

    /**
     *@throws InvocationTargetException 
     * @throws IllegalArgumentException 
     * @throws IllegalAccessException 
     * @throws Exception 
     * @throws NoSuchMethodException 
     * @annotation demo 
     */
    public static void main(String[] args) throws Exception {
        
        School school = new School();
        //得到whoIsAm()方法
        Method method1 = school.getClass()
            .getMethod("whoIsAm", int.class);          
        //得到_whoIsAm()方法
        Method method2 = school.getClass()
            .getMethod("_whoIsAm", String.class);      
        //获得whoIsAm()上的@User注解
        User user1 = method1.getAnnotation(User.class);
        //通过反射执行whoIsAm()方法
        method1.invoke(school, user1.id());            
        //获得_whoIsAm()上的@User注解
        User user2 = method2.getAnnotation(User.class);
        //通过反射执行_whoIsAm()方法
        method2.invoke(school,user2.name());
    }

}

---

四、利用注解搞点事

比如spring中有个@Autowired，下面模仿出这样一个功能
（好吧，这个问题貌似很难，日后再更。。。）

• 首先构造一个@_Autowired

• 在目标类中使用该注解

• 然后提取目标类上的该注解，并完成赋值