Java Annotation简介

 

单位要搞个基础知识的培训，分了Java Annotation的主题给我，框架这么爱Annotation，我也颇感兴趣，大概记录一下，大部分内容选自互联网检索结果与自己粗浅地理解。

1.Annotation简介

2.元数据（metadata）和元数据的价值

3.原注解（built-in annotation）介绍

4.lava.lang.annotation包简介

5.优缺点

 

Annotation（注解）简介

1）.wikipedia上对Annotation的概念介绍

       Annotation，是Java语言中的一种特殊的元数据语法，可以被添加到Java代码中。类，方法，变量，参数，包都可以被标注。与Javadoc的标签不同，注解是可以被反射的，因为他们被编译器生成嵌入在 编译后文件，并保留在虚拟机中以便在运行时被索引。

 

2）.Sun网站上写的

     JDK5引入了Metedata(元数据)很容易的就能够调用Annotations.Annotations提供一些本来不属于程序的数据，比如:一段代码的作者或者告诉编译器禁止一些特殊的错误。An annotation 对代码的执行没有什么影响。Annotations使用@annotation的形势应用于代码：类(class),属性(field),方法(method)等等。一个Annotation出现在上面提到的开始位置，而且一般只有一行,也可以包含有任意的参数。

 

不难看出，1.5引入Annotation的目的是提供一个元数据的解决方法，通过反射的方式获取“不直接影响程序的语义”。网络上也人猜测java的作者从xDoclet获取了灵感，还有人说是从C#的Attributes获得的灵感。下面我们来了解下元数据。

 

元数据（metadata）和元数据的价值

wikipedia上对Metadata的概念介绍

元数据是指提供一个数据提供一个或多个本身外的其他数据。诸如：

数据创建的意义

数据的目的

数据创建的时间

数据的创建者

数据在计算机网络中的创建地址

在技术标准中使用

举例来说，一个数字图片应包含的元数据有，图片占多大空间，图片颜色深度，分辨率等等。一个文本文档元数据应包括，文档的存活时间，作者是谁，是什么时候写的，简述之类的。

元数据是数据，因此，元数据可以被数据库存储管理，通常被称作注册表，repository（信息库？）。仅仅通过观察是无法识别元数据的，因为使用者不知道数据什么时候当作元数据使用。

一般来说，元数据的好处分为三类：文档编制、编译器检查和代码分析。元数据提供了一种有用的方法来指明方法是否取决于其他方法，它们是否完整，特定类是否必须引用其他类，等等。

1）文档编制 略

2）编译器检查

3）代码分析

 

原注解（built-in annotation）介绍

1.5内置了三个原注解，

Override 注解

Override 仅用于方法（不用于类、包声明或其他构造），编译后就无意义了。它指明注释的方法将覆盖超类中的方法。如果不覆盖这些方法，根本 无法 编译此类。

Deprecated 注解

Deprecated 对不推荐再使用的方法进行注释。

SuppressWarnings 注解

SuppressWarnings 主要是1.5之后新增的特性，泛型，枚举，注解等特性向下版本兼容，免除警告使用。

 

 

lava.lang.annotation包简介

JavaAPI点这里

先看Target 表示一个注解的作用级别，级别有类型，属性，方法，类，包等，详见ElementType。

 

	@Documented  
	@Retention(RetentionPolicy.RUNTIME)  
	@Target(ElementType.ANNOTATION_TYPE)  
	public @interface Target {  
		ElementType[] value();  
	}

      再看Retention，表示一个注解的生命周期

 

       @Documented

  	 @Retention(RetentionPolicy.RUNTIME)
         @Target(ElementType.ANNOTATION_TYPE)
         public @interface Retention {
           RetentionPolicy value();
         }

   所有的Annotation类型默认实现了Annotation接口,Inherited注解。它们都使用了@Documented,@Documented的目的就是让这一个Annotation类型的信息能够显示在javaAPI说明文档上;没有添加的话，使用javadoc生成API文档的时候就会找不到这一个类型生成的信息.

 

   public enum RetentionPolicy {
     SOURCE,//这个Annotation类型的信息只会保留在程序源码里，源码如果经过了编译之后，Annotation的数据就会消失,并不会保留在编译好的.class文件里面。 
     CLASS,//保留在程序源码里,同时也会保留在编译好的.class文件里面,在执行的时候，并不会把这一些信息加载到虚拟机(JVM)中去.注意一下，当你没有设定一个Annotation类型的Retention值时，系统默认值是CLASS. 
     RUNTIME//是RUNTIME,表示在源码、编译好的.class文件中保留信息，在执行的时候会把这一些信息加载到JVM中去的． 
   }

 

优缺点

个人觉得Annotation的优点在于提供了一种接口，抽象类之外的一种抽象方式，且是一种粒度更细的抽象方式，为一类型的业务进行逻辑处理提供了新的解决方式，效果就近似标签化处理。

我觉得最明显的缺点就是在不借助文档的前提下，你根本不知道Annotation悄悄做了什么，这样就破坏了代码的可读性，怪模怪样是很多人对此的评价。