Java注解详细介绍
Java注解介绍
基于注解(Annotation-based)的Java开发无疑是最新的开发趋势.[译者注:这是05年的文章,在2014年,毫无疑问,多人合作的开发,使用注解变成很好的合作方式,相互之间的影响和耦合可以很低].
基于注解的开发将Java开发人员从繁琐笨重的配置文件中解脱出来.Java5.0中首次引入了注解,注解是这个JDK版本的特性之一,将程序员书写Java示例API文件的工作转交给了编译器.当不再维护分开的源代码和API文档后,代码和文档会更容易维护.生成的代码示例也不太可能包含错误.
Java注解是JDK5中的主要特性之一,使开发变得更简单容易.注解就像一种元信息(meta,可以理解为额外的信息,用来给特殊的程序看的),可以添加到代码中,可以被用到包(package)的声明,类型(type)声明、构造函数(constructors)、方法(methods)、属性域(fields)、参数(parameters)以及变量(variables)上.他们提供一种有效的方式来指示方法是否依赖于其他方法,是否完整,类(class)是否引用其他类,等等.
引用甲骨文公司的官方网站的说明,"它(基于注解的开发)可以让我们在很多时候不必再去写一份单独的API文档说明,只需要启用工具来从源码中的注解生成即可.这形成了一种声明式的编程风格,程序员说,需要做什么,就让工具根据代码来做就好了."
简单来说,注解是一种将meta标记(meta-tag)与程序元素关联的机制,允许编译器(compiler)或JVM从有注解的元素提取程序行为,必要时生成相互依赖的代码.
在本系列文章的第一部分,我将介绍一些基本的Java注解,他们的用处(benefits),以及一些示例用法(usages).
Java注解基础知识
你需要了解两个地方.一是"注解"(annotation,类似于一个new出来的对象)本身,二是"注解的类型"(annotationtype,类似于class定义).注解是一个meta标记,用在你的代码中,其实它是有生命周期和适用范围的.annotationtype是用来定义注解的.当你想要创建自己的注解时，你就会用到它.type才是实际使用的构造类型,注解只是那个类型的一个具体用法.
定义注解类型时需要使用一个"at"(@,国内有人读作圈a)标记,紧跟着是关键字interface,再加上注解的名字(name).另一方面,使用注解的形式,也是先写上"at"符号(@),其次是注解类型.这是最简单的注解形式.另外,你可以在使用注解时,在名字后面加上小括号,里面附上需要传递的参数.后面你会看到他们的示例:
定义注解类型示例:(AnnotationType,注解类型,类似于定义一个类)
public@interfaceMyAnnotation{
StringdoSomething();
}
在普通代码中使用注解(Annotation实例)
@MyAnnotation(doSomething="Whattodo")
publicvoidmymethod(){
....
}
Java注解类型(AnnotationTypes)
有三种类型的注解:
标记(Marker):标记类型的注解没有元素,只有一个名字.
定义:
//这种注解,就像一种标签,没有状态
//有点像没有方法定义的接口Serializable一样
public@interfaceAMarkerAnnotation{
}
使用:
@AMarkerAnnotation
publicvoidmymethod(){
....
}
单个元素的注解:单个元素(Single-Element)或单个值这种类型的注解,只带一个数据.可以在括号内用data=value的方式表示,也可以只传递一个值(简便的写法).
定义:
public@interfaceSingleElementAnnotation
{
StringdoSomething();
}
使用:
@SingleElementAnnotation("可以只传对应类型的值")
publicvoidmymethod(){
....
}
Full-value或多个值的注解:Full-value类型的注解有多个数据成员.因此,必须为每个成员使用完整的data=value语法格式传递参数.
定义:
public@interfaceFullValueAnnotation{
StringdoSomething();
intcount;
Stringdate();
}
使用:
@FullValueAnnotation(doSomething="参数值",count=1,
date="09-09-2005")
publicvoidmymethod(){
....
}
定义Java注解类型的注意事项
在定义注解类型时需要注意:
1.注解声明应该以一个at符号开始(@),后跟一个interface关键字,以及注解的名字.
2.注解里面的方法声明,不接受任何参数(只是看起来像是方法而已,本质是属性域).
3.注解里面的方法声明不能有throws子句.
4.注解里面的方法返回类型只能是下面这几种:
@primitives(6种原始数据类型,int,byte等)
@String(字符串)
@Class(类,如String.class这种)
@enum(枚举)
@arrayoftheabovetypes(数组,数组元素只能是上面的一种类型)
Java注解类型
JDK5中有两种类型的注解:
1.Simpleannotations(简单注解类型):这些是Tiger(Tiger是JDK1.5的代号?)提供的基本类型,只能用来注解普通代码;不能用来创建另一个自定义注解类型.
2.Metaannotations(元注解):专门设计用来注解其他注解类型(annotation-type)声明的.简单地说,他们被称为注解的注解(annotations-of-annotations).