上一篇：CGLIB实现代理设计模式 | 带你学《Java语言高级特性》之九十六
【本节目标】
本节介绍了获取Annotation信息的方法，以及Annotation的运行策略，通过案例解释如何实现自定义的Annotation。
从JDK1.5后Java开发提供了Annotation技术支持，这种技术为项目的编写带来了新的模型，而后经过了十多年的发展，Annotation的技术得到了非常广泛的应用，并且在所有的项目开发中都会存在。

获取Annotation信息

在进行类或方法定义时，都可以使用一系列的Annotation进行声明，于是如果要想获得这些Annotation信息，那么可以直接通过反射来完成。在java.lang.reflect里面有一个AccessibleObject类，在本类中提供有获取Annotation类的方法：

获取全部Annotation：
public Annotation[] getAnnotations()
获取指定Annotation：
public <T extends Annotation> T getAnnotation​(Class<T> annotationClass)

范例：定义一个接口，并在接口在使用Annotation

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

public class JavaAPIDemo {
    public static void main(String[] args) throws Exception {
        {   //获取接口上的Annotation信息
            Annotation annotations [] = IMessage.class.getAnnotations();  //获取接口上的全部Annotation
            for (Annotation temp : annotations) {
                System.out.println(temp);
                //@java.lang.FunctionalInterface()
                //@java.lang.Deprecated(forRemoval=false, since="1.0")
            }
        }
        System.out.println("-----------------------");
        {//获取MessageImpl子类上的Annotation信息
            Annotation annotations []= MessageImpl.class.getAnnotations();  //获取类上的全部Annotation
            for (Annotation temp : annotations) {
                System.out.println(temp);
            }
        }
        System.out.println("-----------------------");
        {   //获取MessageImpl.toString()方法上的Annotation信息
            Method method = MessageImpl.class.getDeclaredMethod("send", String.class);
            Annotation annotations [] = method.getAnnotations();  
            for (Annotation temp : annotations) {
                System.out.println(temp);
            }
        }
    }
}
@FunctionalInterface    //程序执行时可以获取
@Deprecated(since = "1.0")     
interface IMessage {     //有2个Annotation
    public void send(String msg);
}
@SuppressWarnings("serial")     //无法在程序执行时获取
class MessageImpl implements IMessage, Serializable {
    @Override      //无法在程序执行时获取
    public void send(String msg) {
        System.out.println("【消息发送】" + msg);
    }
}

不同的Annotation有它的存在范围，下面对比两个Annotation：
@FunctionalInterface（运行时）：

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface FunctionalInterface {}

@SuppressWarnings（源代码）：

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, MODULE})
@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {}

现在发现“@FunctionalInterface”是在运行时生效的Annotation，所以程序执行时可以获取Annotation；而“@SuppressWarnings”是在源代码编写时有效。
在RetentionPolicy枚举类中还有一个class的定义，指的是在类定义时生效。

自定义Annotation

现在已经清楚了Annotation的获取，以及Annotation的运行策略，但是最为关键性的因素是如何实现自定义的Annotation呢？为此在Java中提供了新的语法，使用“@interface”来定义Annotation。
范例：自定义Annotation

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Method;

@Retention(RetentionPolicy.RUNTIME)   //定义Annotation的运行策略
@interface DefaultAnnotation {      //自定义的Annotation
    public String title();      //获取数据
    public String url() default "www.mldn.cn";   //获取数据
class Message {
    @DefaultAnnotation(title = "MLDN")
    public void send(String msg) {
        System.out.println("【消息发送】" + msg);
    }
}
public class JavaAPIDemo {
    public static void main(String[] args) throws Exception {
        Method method = Message.class.getMethod("send",String.class);  //获取指定方法
        DefaultAnnotation  anno = method.getAnnotation(DefaultAnnotation.class);  //获取指定的Annotation
        //System.out.println(anno.title());  //直接调用Annotation中的方法  MLDN
        //System.out.println(anno.url());    //直接调用Annotation中的方法  www.mldn.cn
        //直接调用Annotation中的方法
        String msg = anno.title()+"（"+anno.url()+")";  //消息内容 
        method.invoke(Message.class.getDeclaredConstructor().newInstance(), msg);   //【消息发送】MLDN（www.mldn.cn)
    }
}

使用Annotation之后的最大特点是可以结合反射机制实现程序的处理。

想学习更多的Java的课程吗？从小白到大神，从入门到精通，更多精彩不容错过！免费为您提供更多的学习资源。
本内容视频来源于阿里云大学

下一篇：整合工厂设计模式与Annotation | 带你学《Java语言高级特性》之九十八
更多Java面向对象编程文章查看此处