美文网首页Android/Java学习日记
【Annotation】运行时注解

【Annotation】运行时注解

作者: MarcoHorse | 来源:发表于2017-04-19 17:04 被阅读42次

    注解的语法和定义:

    (1)以@interface关键字定义(接口的类型定义是interface,别混淆了)
    (2)注解包含成员,成员以无参数的方法的形式被声明。其方法名和返回值定义了该成员的名字和类型。
    (3)成员赋值是通过@Annotation(name=value)的形式。
    (4)注解需要标明注解的生命周期,注解的修饰目标等信息,这些信息是通过元注解实现。
    

    注解的类型:

    java的Annotation注解主要分为三类,根据其生命周期划分为:
    RetentionPolicy.SOURCE 注解只保留在源文件,当编译成class文件后,舍弃
    RetentionPolicy.CLASS 编译时注解,当jvm加载class文件后舍弃
    RetentionPolicy.RUNTIME 运行时注解,也是敲代码的时候最经常使用的方式,通过反射来获取数据
    

    如何选择合适的注解类型:

    使用情况:
    RetentionPolicy.SOURCE :注解将被编译器丢弃(该类型的注解信息只会保留在源码里,源码经过编译后,注解信息会被丢弃,不会保留在编译好的class文件里)
    RetentionPolicy.CLASS :注解在class文件中可用,但会被VM丢弃(该类型的注解信息会保留在源码里和class文件里,在执行的时候,不会加载到虚拟机(JVM)中)
    RetentionPolicy.RUNTIME :JVM将在运行期也保留注解信息,因此可以通过反射机制读取注解的信息(源码、class文件和执行的时候都有注解的信息)
    PS:当注解未定义Retention值时,默认值是CLASS
    

    在Java中,系统给定了四种注解,给我们写自定义注解:

    @Documented
    用于描述其它类型的注解应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化。
    @Inherited
    标记注解,允许子类继承父类的注解
    @Retention
    标明注解的生命周期
    @Target
    标明注解的修饰目标
    

    一般来说我们写注解只需要用到Retention和Target,Documented在企业版本会用得比较多,Inherited则看情况使用。下面从源码的角度上来看下这两个注解。
    @Target

    Target

    里面包含了一个ElementType数组,其中ElementType就是注解类修饰的类型,例如方法,参数,类等等,所以我们可以这样声明一个注解:


    运行时注解的使用:
    运行时注解,也是最简单最容易掌握的一种注解。通过反射获取对应的元素,再获取元素上面的注解,最后获取注解上面的值。下面我简单地举个例子:

    <pre>
    public static void getAnnotation(Object o) {
    //获取class对象
    Class<?> tClass = o.getClass();
    FieldMethod[] methods = tClass.getAnnotationsByType(FieldMethod.class);//获取ElementType.TYPE类型的注解

        for (Field f : tClass.getFields()) {
            for (FieldMethod method : f.getAnnotationsByType(FieldMethod.class)) {
                //获取变量的注释值ElementType.FIELD
                System.out.println("method--->" + method.value());
            }
        }
    
        for (FieldMethod method : methods) {
            //获取ElementType.TYPE类型的注解里面的值
            System.out.println("method--->" + method.value());
        }
    
        for (Constructor c : tClass.getConstructors()) {
            for (FieldMethod method : c.getAnnotationsByType(FieldMethod.class)) {
                //获取构造方法的注释值ElementType.Constructor
                System.out.println("method--->" + method.value());
            }
        }
    
        for (Method m : tClass.getMethods()) {
            for (FieldMethod method : m.getAnnotationsByType(FieldMethod.class)) {
                //获取类方法的注释值ElementType.method
                System.out.println("method--->" + method.value());
            }
    
            for (Parameter p : m.getParameters()) {
                for (FieldMethod method : p.getAnnotationsByType(FieldMethod.class)) {
                    //获取方法参数的注释值ElementType.PARAMETER
                    System.out.println("method--->" + method.value());
                }
            }
        }
    }
    

    </pre>

    输出结果

    其实运行时注解没啥好说的,很简单,主要是可以基本使用注解来写自定义注解来解决一些基本问题,提高写代码的质量和效率。

    相关文章

      网友评论

        本文标题:【Annotation】运行时注解

        本文链接:https://www.haomeiwen.com/subject/pgtgnttx.html