Java 知识归纳-注解

注解介绍

注解(Annotation)相信大家都不陌生，它是 JDK1.5 的新特性，是一种特殊的类，作用类似于注释，相当于是一个标记，可以标记在一个类身上的不同位置，可以修饰不同的成员变量、方法甚至是类。注解在实际开发中用的非常广泛，尤其是现在流行的基于注解式开发，所以对于深入掌握注解是有必要的。

内置注解

JDK已经给我们提供了三种内置注解，分别是：@Override , @Deprecated , @SuppressWarings。
@Override：注解修饰在方法上，表示被修饰的方法用来重写父类上的方法。
@Deprecated：表示被修饰的方法是不被推荐使用的。
@SuppressWarings：表示被修饰的方法压制警告。

按运行机制分类注解

1、源码注解：注解只存在源码中，编译成class文件就不存在了。
2、编译时注解：存在于源码和class文件中。
3、运行时注解：运行时还存在，并且起作用。

注解术语

原注解：给注解，注解(动词)的注解。
标识注解：没有成员的注解。

自定义注解

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,ElementType.PARAMETER,ElementType.FIELD})
// 运行机制：运行时注解。
@Retention(RetentionPolicy.RUNTIME)
// 允许被继承。
@Inherited
// 生成javadoc的时候会包含注解的信息。
@Documented
public @interface Fei_Annotation {
    String name();
	
    int [] nums();
	
    String age() default "18";
	
    String description() default "贼鸡儿帅";
}

1、注解中只有一个属性，那么这个属性必须为 value()，赋值可以不必明确写上valueName=xxx 的形式，直接使用xxx即可。
2、注解中有 value 属性，同时也包含有其他属性时候，那么在对属性赋值时候，必须明确的以 valueName=xxx 的形式赋值。
3、注解中存在数组属性，那么在对其赋值的时候，如果是单个值，可不使用"{}"的形式，如果是多个值，必须使用"{}"。
4、使用 default 关键字，那么在赋值的时候，可以不指定值，那么使用的就是默认值，同时也可以对于赋予新的值。

解析注解

概念：通过反射获取类、函数、或者成员上的运行时注解，从而动态监控程序的运行逻辑。
Feigel类

package com.feige;
@Fei_Annotation(name="feige", age = 24)
public class Feige {
    @Fei_Annotation(name="feige", age = 24)
    public String hello() {
        return null;
    }
}

测试类

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;
public class Test {
    public static void main(String[] args) {
        try {
            Class c = Class.forName("com.feige.Feige");
            // 找到类上面的注解。
            boolean isExist = c.isAnnotationPresent(Fei_Annotation.class);
            if(isExist) {
                // 获取注解实例
                Fei_Annotation fei = (Fei_Annotation) c.getAnnotation(Fei_Annotation.class);
                // 打印注解属性
                System.out.println(fei.description());
            }

            // 找到方法数组
            Method[] ms = c.getMethods();
            // 第一种获取方法上的注解
            for(Method m : ms) {
                boolean isMExist = m.isAnnotationPresent(Fei_Annotation.class);
                if(isMExist) {
                    Fei_Annotation anno = (Fei_Annotation) m.getAnnotation(
                                                               Fei_Annotation.class);
                    System.out.println(anno.name());
                }
            }
			
            // 另一种获得方法上的注解
            for(Method m : ms) {
                Annotation[] annotations = m.getAnnotations();
                for(Annotation annotation : annotations) {
                    if(annotation instanceof Fei_Annotation) {
                        Fei_Annotation anno = (Fei_Annotation)annotation;
                        System.out.println(anno.description());
                    }
                }			
            }
        } catch (Exception e) {			
            e.printStackTrace();
        }
    }
}
结果：
贼鸡儿帅
feige
贼鸡儿帅