单位要搞个基础知识的培训,分了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悄悄做了什么,这样就破坏了代码的可读性,怪模怪样是很多人对此的评价。
分享到:
相关推荐
个人收集的相关Java Annotation的资源资料内容。
Java Annotation详解 Java Annotation详解 Java Annotation详解
JDK5.0 - Java Annotation 介绍 (ppt格式)
JAVA Annotation学习示例 的一个简单示例 有源码 也有相关博客说明
java之Annotation及其应用
Java Annotation注解技术
Java 5 annotation 学习笔记Java 5 annotation 学习笔记Java 5 annotation 学习笔记
java annotation 手册.doc,java annotation 手册.doc,java annotation 手册.doc
Java Annotation的讲解和例子~~~
本文针对java初学者或者annotation初次使用者全面地说明了annotation的使用方法、定义方式、分类。初学者可以通过以上的说明制作简单的annotation程序,但是对于一些高级的annotation应用(例如使用自定义annotation...
利用annotation(注解)开放简化java开放步骤
struts 拦截器,扩展,以及java annotation 这个是我学习所用,放在此处,作为中转。
Java annotation 什么是java annotation?annotation 的7种标注类型。nnotation提供了一条与程序元素关联任何信息或者任何元数据(metadata)的途径。从某些方面看,annotation就像修饰符一样被使用,并应用于包、...
如果你想知道java annotation是什么?你可以看看
JavaAnnotation必须掌握的特性Java开发Java经验技巧共6页.pdf.zip
java annotation手册 关于annotation是什么东西,百度一下会有很多关于它的描述,在这里就不用再copy了,我们还是以一个示例开始吧,在开始示例之前,我们先来一个小故事。
java1.5 annotation注释源代码,
javaAnnotation.pdf