java注解入门（含源码下载）

注解（Annotation）是从jdk1.5开始增加的特性。学习注解能够读懂框架的代码；让编程更加简洁，代码更加清晰。

注解概念：java提供了一种原程序中的元素关联任何信息和任何元数据的途径和方法。
注解需要import java.lang.annotation.*;

java自带的3个注解：

• 　　@Override//覆盖
• 　　@Deprecated//过时
• 　　@SuppressWarnings()//抑制警告

自定义注解的语法要求
　　一般自定义注解的代码如下：//“Description 注解”在下面的栗子中会用到哦O(∩_∩)O
　　@Target({ElementType.METHOD,ElementType.TYPE})//作用域是在方法上、类或者接口上。
　　@Retention(RetentionPolicy.RUNTIME)
　　@Inherited//允许子类继承（你给某个父类注解了，子类会继承父类的注解）
　　@Documented//生成doc时会包含注解的信息
　　public @interface Description {//使用@interface关键字定义注解
　　　　String desc();//成员以无参无异常方式声明
　　　　String author();
　　　　int age() default 18;//可以用default为成员制定一个默认值
　　}

讲解：
元注解，就是注解的注解，@Target, @Retention, @Inherited, @Documented都是元注解。

@Target的取值有：

1. ElementType.TYPE //接口、类、枚举、注解
2. ElementType.FIELD/字段、枚举的常量
3. ElementType.METHOD//方法
4. ElementType.PARAMETER//方法参数
5. ElementType.CONSTRUCTOR//构造函数
6. ElementType.LOCAL_VARIABLE//局部变量
7. ElementType.ANNOTATION_TYPE//注解
8. ElementType.PACKAGE///包

 

Retention：保留，定义注解的保留策略。有3个值：SOURCE、CLASS、RUNTIME。

• SOURCE只在源码显示，编译时会丢弃。
• CLASS编译时会记录到class中，运行时忽略。
• RUNTIME运行时存在，可以通过反射读取。在执行main方法就是运行时。

成员类型是受限的，合法的类型包括原始类型及String，Class，Annotation, Enumeration。
当注解只有一个成员时，成员名必须取名为value()，因为约定俗成，我们可以不用写参数名和赋值号。直接给参数值。简洁方便。允许你偷看下面的注解类MyDescription。
注解类可以没有成员，没有成员的注解称为标识注解。如SpringMVC里面的@Controller，就是标识注解。

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

package com.rainmer.anno;

import java.lang.annotation.*;

/**
 * Created by Simon  Sun on 2015/7/22.
 */
@Target({ElementType.METHOD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface MyDescription {
    public String value();
}

package com.rainmer.anno;

/**
 * Created by Simon  Sun on 2015/7/22.
 */
@MyDescription("i am interface")
public interface Person {
    @MyDescription("i am interface method")
    public String name();
    public int age();
    public void sing();
}

package com.rainmer.anno;

/**
 * Created by Simon  Sun on 2015/7/22.
 */
@MyDescription("i am a class annotation")
public class Child implements Person {
    @Override
    @MyDescription("i am a method annotation")
    @Description(desc = "the name method",author = "mook boy")
    public String name() {
        return null;
    }

    @Override
    public int age() {
        return 0;
    }

    @Override
    public void sing() {

    }
}

package com.rainmer.anno;

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

/**
 * Created by Simon  Sun on 2015/7/22.
 */
public class ParseAnno {
    public static void main(String[] args) {
        //1、使用类加载器加载类
        try {
            Class c = Class.forName("com.rainmer.anno.Child");
            //判断雷尚是否有MyDescription这样的注解
            boolean isExist = c.isAnnotationPresent(MyDescription.class);
            if(isExist){
                //3、拿到注解实例
                MyDescription myDescription = (MyDescription) c.getAnnotation(MyDescription.class);
                System.out.println(myDescription.value());
            }

            //4、找到方法上的注解
            Method[] ms = c.getMethods();
            for(Method m : ms){
                boolean isMExist = m.isAnnotationPresent(MyDescription.class);
                if(isMExist){
                    MyDescription d = m.getAnnotation(MyDescription.class);
                    System.out.println(d.value());
                }
            }

            //另外一种解析方法
            for(Method m : ms){
                Annotation[] as = m.getAnnotations();
                for(Annotation a : as){
                    if(a instanceof MyDescription){
                        MyDescription d = (MyDescription) a;
                        System.out.println(d.value());
                    }
                }
            }
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        }

    }
}

程序输出：

i am a class annotation

i am a method annotation
i am a method annotation

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

继承的时候不仅会继承类的注解，也会继承方法的注解，前提是子类不覆盖父类的方法。

来个栗子：

package com.rainmer.anno;

/**
 * Created by Simon  Sun on 2015/7/22.
 */
@MyDescription("i am parent class")
public class Animal {
    @MyDescription("i am parent method")
    public String getName(){
        return null;
    };
}

package com.rainmer.anno;

/**
 * Created by Simon  Sun on 2015/7/22.
 */
public class Dog extends Animal {

}

解析类ParseAnno只要修改第13行为：Class c = Class.forName("com.rainmer.anno.Dog");即可。

程序输出：

i am parent class
i am parent method
i am parent method

但是如果Dog覆盖了getName方法，那么输出就变成：

i am parent class

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

最后加点调料，idea的两个实用快捷键：

alt+回车：add exception或者快速try/catch；强制类型转换 。
alt+insert：生成代码，如get、set方法，构造函数等，当然，还可以用来快速覆盖接口或父类的方法

源码下载：http://yunpan.cn/ccWaszMAARdJb  访问密码 d806