• Java Annotation详解(一): 理解和使用Annotation


    JDK1.5之后,引入了元数据的概念,也就是Annotation(注释),其实它是代码里的特殊标记,这些标记可以再编译、类加载、运行时被读取,并执行相应的处理。

    元数据的作用:

    如果要对于元数据的作用进行分类,目前还没有明确的定义,不过我们可以根据它所起的作用,大致可分为三类:

    1.  编写文档:通过代码里标识的元数据生成文档。
    2.  代码分析:通过代码里标识的元数据对代码进行分析。
    3.  编译检查:通过代码里标识的元数据让编译器能实现基本的编译检查。

    一、 系统内建的Annotation:

        @Override 覆写的Annotation

    注释能实现编译时检查,你可以为你的方法添加该注释,以声明该方法是用于覆盖父类中的方法。如果该方法不是覆盖父类的方法,将会在编译时报错。例如我们为某类重写toString()方法却写成了tostring(),并且我们为该方法添加了@Override注释,则会提示编译错误。
         @Deprecated 不赞成使用的Annotation

    其作用是对不应该在使用的方法添加注释,当编程人员使用这些方法时,将会在编译时显示提示信息,不推荐在使用该方法或该类。
        @SuppressWarnings 压制安全警告的Annotation

    与前两个注释有所不同,你需要添加一个参数才能正确使用,这些参数值都是已经定义好了的,我们选择性的使用就好了,参数如下:
    deprecation   使用了过时的类或方法时的警告
    unchecked  执行了未检查的转换时的警告,例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型
    fallthrough   当 Switch 程序块直接通往下一种情况而没有 Break 时的警告
    path   在类路径、源文件路径等中有不存在的路径时的警告
    serial 当在可序列化的类上缺少 serialVersionUID 定义时的警告
    finally    任何 finally 子句不能正常完成时的警告
    all 关于以上所有情况的警告

    在为@SuppressWarnings设置注释信息的时候,是以key-value的形式出现的,所以以上的@SuppressWarnings也可以直接使用,所以@SuppressWarnings可以使用”value={"unchecked","deprecation"}“的方式来设置。

    @Deprecated
    class Demo<T>{
    	private T var ;
    	public T getVar(){
    		return this.var ;
    	}
    	public void setVar(T var){
    		this.var = var ;
    	}
    };
    public class SuppressWarningsAnnotationDemo03{
    	// @SuppressWarnings(value={"unchecked","deprecation"})
    	public static void main(String args[]){
    		Demo d = new Demo() ;
    		d.setVar("沉缘") ;
    		System.out.println("内容:" + d.getVar()) ;
    	}
    };

    上面,我们将 注释掉,编译后,会出现警告提示:

    ---------- javac ----------
    注: SuppressWarningsAnnotationDemo03.java使用或覆盖了已过时的 API。
    注: 有关详细信息, 请使用 -Xlint:deprecation 重新编译。
    注: SuppressWarningsAnnotationDemo03.java使用了未经检查或不安全的操作。
    注: 有关详细信息, 请使用 -Xlint:unchecked 重新编译。

    打开@SuppressWarnings注释,再次编译,发现,警告已被抑制。


    二、 自定义Annotation

    定义简单的Annotation形式:

    [public] @interface Annotation名称{

            数据类型  变量名称();

    }

    例如:

    public @interface MyDefaultAnnotationNoneParam{
    }

    之后,就可以直接使用@Annotation名称:

    @MyDefaultAnnotationNoneParam
    class Demo
    {
    }

    此时,就表示在Demo类上使用Annotation。

    还可以向Annotation中设置变量,使用变量接受参数。

    public @interface MyDefaultAnnotationSingleParam{
    	public String value();	//接受设置的参数
    }

    在使用的时候,必须清楚的指定变量的名称,变量的内容:

    @MyDefaultAnnotationSingleParam("沉缘")
    class Demo
    {
    }

    或者使用明确的标记,表示内容赋给哪个参数:

    @MyDefaultAnnotationSingleParam(value="沉缘")
    class Demo
    {
    }

    以上的参数,是要赋给value属性的。既然可以设置一个参数,则也就可以同时设置多个参数。

    public @interface MyDefaultAnnotationMoreParam{
    	public String key() ;
    	public String value() ;	// 接收设置的内容
    }

    此Annotation在使用时,需要设置两个参数,一个key,一个value。

    @MyDefaultAnnotationMoreParam(key="Linkage",value="沉缘")
    class Demo{
    };

    当然,我们可以设置数组进去,@SuppressWarnings就使用了数组。

    public @interface MyDefaultAnnotationArrayParam{
    	public String[] value() ;	// 接收设置的内容
    }

    接收内容本身是一个数组类型,要传递数组。

    @MyDefaultAnnotationArrayParam(value={"沉缘","流烬"})
    class Demo{
    };

    以上的定义Annotation都未指定属性的默认值,必须在使用时设置。 其实,也可以直接使用default来定义默认值:

    public @interface MyDefaultAnnotationValue{
    	public String key() default "Linkage" ;	// 指定好了默认值
    	public String value() default "沉缘" ;	// 指定好了默认值
    }

    在实际的操作中,对于一个Annotation而言,有时候会固定其取值范围,只能使用固定的几个值。那么这时候实际上就需要依靠枚举:

    public enum MyName{	// 定义枚举类型
    	WUQING,WUYUAN,WULEI ;
    }
    
    public @interface MyDefaultAnnotationEnum{
    	public MyName name() default MyName.WUQING ;	// 指定默认值
    }


    三、 限定注释使用范围Target

    当我们的自定义注释不断的增多也比较复杂时,就会导致有些开发人员使用错误,主要表现在不该使用该注释的地方使用。为此,Java提供了一个ElementType枚举类型来控制每个注释的使用范围,比如说某些注释只能用于普通方法,而不能用于构造函数等。下面是Java定义的ElementType枚举:

    package java.lang.annotation;
    
    public enum ElementType {
    
      TYPE,         // Class, interface, or enum (but not annotation)
    
      FIELD,        // Field (including enumerated values)
    
      METHOD,       // Method (does not include constructors)
    
      PARAMETER,        // Method parameter
    
      CONSTRUCTOR,      // Constructor
    
      LOCAL_VARIABLE,   // Local variable or catch clause
    
      ANNOTATION_TYPE,  // Annotation Types (meta-annotations)
    
      PACKAGE       // Java package
    
    }
    想要使用ElementType,只需要为注释添加@Target即可:

    @Target( { ElementType.METHOD, ElementType.CONSTRUCTOR })
    
    public @interface TargetTest {
    
    }

    正如上面代码所展示的,我们只允许Greeting注释标注在普通方法和构造函数上,使用在包申明、类名等时,会提示错误信息。

    四、 Retention和RetentionPolicy,注释保持性策略

    public enum RetentionPolicy {
    
    
      SOURCE,// Annotation is discarded by the compiler
    
    
      CLASS,// Annotation is stored in the class file, but ignored by the VM
    
    
      RUNTIME// Annotation is stored in the class file and read by the VM
    
    }


    RetentionPolicy的使用方法的简单代码示例如下:

    @Retention(RetentionPolicy.RUNTIME)

    而,在RetentionPolicy的三个范围中,最需要注意的就是RUNTIME范围,因为在执行的时候起作用。

    import java.lang.annotation.Retention ;
    import java.lang.annotation.RetentionPolicy ;
    @Retention(value=RetentionPolicy.RUNTIME) // 表示此Annotation在运行时有效
    public @interface MyDefaultRententionAnnotation{
    public String name() default "沉缘" ;
    }

    我们看下内建的Annotation的RetentionPolicy:

    @Override定义采用的是@Retention(value=SOURCE),只能在源文件中出现。

    @Deprecated定义采用的是@Retention(value=RUNTIME),可以在执行时出现。

    @SuppressWarnings定义采用的是@Retention(value=SOURCE),只能在源文件中出现。


    五、 文档化功能

    Java提供的Documented元注释跟Javadoc的作用是差不多的,其实它存在的好处是开发人员可以定制Javadoc不支持的文档属性,并在开发中应用。它的使用跟前两个也是一样的,简单代码示例如下:

    import java.lang.annotation.Documented ;
    @Documented
    public @interface MyDocumentedAnntation{
    <span style="white-space:pre">	</span>public String key() default "Linkage" ;
    <span style="white-space:pre">	</span>public String value() default "沉缘" ;
    }

    成功后,在使用此Annotation的时候,可以增加一些信息进去:

    @MyDocumentedAnntation(key="Baidu",value="www.baidu.com")
    public class SimpleBeanDocumented{
    	/**
    	 * 此方法在对象输出时调用,返回对象信息
    	 */
    	@MyDocumentedAnntation(key="Xinlang",value="www.sina.com")
    	public String toString(){
    		return "Hello World!!!" ;
    	}
    };

    之后,在生成jdk文档的时候,使用@Document修饰的方法将被注释下来。

    六、 标注继承

    继承应该是Java提供的最复杂的一个元注释了,它的作用是控制注释是否会影响到子类(一个Annotation是否可以被继承下来),简单代码示例如下:

    package com.test.inheriteddemo ;
    import java.lang.annotation.Retention ;
    import java.lang.annotation.RetentionPolicy ;
    import java.lang.annotation.Documented ;
    import java.lang.annotation.Inherited ;
    @Documented
    @Inherited
    @Retention(value=RetentionPolicy.RUNTIME)
    public @interface MyInheritedAnnotation{
    	public String name() ;
    
    }

    使用该注释,标注一个父类Person:

    package com.test.inheriteddemo ;
    @MyInheritedAnnotation(name="沉缘")
    public class Person{
    };

    按照所解释的,使用Inherited声明的Annotation是可以被子类继承下来的:

    import java.lang.annotation.Annotation ;
    import org.lxh.demo16.inheriteddemo.MyInheritedAnnotation ;
    public class ReflectInheritedDemo{
    	public static void main(String args[]) throws Exception{
    		Class<?> c = null ;
    		c = Class.forName("com.test.inheriteddemo.Student") ;
    		Annotation ann[] = c.getAnnotations() ;	// 取得全部的Annotation
    		for(Annotation a:ann){	// 输出
    			System.out.println(a) ;
    		}
    		// 继续取得此Annotation设置的内容
    		if(c.isAnnotationPresent(MyInheritedAnnotation.class)){
    			MyInheritedAnnotation mda = null ;
    			mda = c.getAnnotation(MyInheritedAnnotation.class) ;
    			String name = mda.name() ;	// 取出name的内容
    			System.out.println("name = " + name) ;
    		}
    	}
    }

  • 相关阅读:
    有线电视网
    上帝造题的七分钟2 / 花神游历各国
    珂朵莉树(学习笔记)
    [SHOI2015]脑洞治疗仪
    语文1(chin1)- 理理思维
    [SCOI2010]序列操作
    CF915E Physical Education Lessons
    CF896C Willem, Chtholly and Seniorious
    Anaconda 创建环境
    非递归遍历N-ary树Java实现
  • 原文地址:https://www.cnblogs.com/hehe520/p/6330006.html
Copyright © 2020-2023  润新知