Java中三种简单注解介绍和代码实例
简单Java注解
JDK5提供的简单注解类型只有3个.这三个都是用来预防错误或者进行提醒的,分别是:
1.Override
2.Deprecated
3.Suppresswarnings
需要注意,JDK5(另一个说法,Tiger)实际上并没有许多内置注解;相反,它允许核心Java支持注解特性的能力.JSR-175中严格规定它用来定义元数据功能.需要由程序员编写自定义的注解类型,其他JSR标准也编写了一系列标准注解类型.下面将用实例来深入讲解这三个简单注解.
Override注解
Override注解指明被注解的方法需要覆写超类中的方法.
如果某个方法使用了该注解,却没有覆写超类中的方法(比如大小写写错了,或者参数错了,或者是子类自己定义的方法),编译器就会生成一个错误.
(注意:JRE5中实现接口中的方法时不能使用Override注解,JRE6允许了,很多时候JRE5会报这个错).
示例1演示了覆写注解:
Java注解示例1:
publicclassTest_Override{ @Override publicStringtoString(){ returnsuper.toString()+"测试使用'Override'注解"; } }
如果出现方法名字拼写错误会发生什么?例如,如果你将toString方法改名为"tostring"(全小写),编译时就会得到类似下面这样的出错信息:
Compiling1sourcefiletoD:tempNewFolder(2) TestJavaApplication1buildclasses D:tempNewFolder(2)TestJavaApplication1srctest myannotationTest_Override.java:24:methoddoesnotoverride amethodfromitssuperclass @Override 1error BUILDFAILED(totaltime:0seconds)
当然,Eclipse就会直接报红叉.现在IDE发展的很好用,初学者不应该去折腾JDK的命令行了.
Deprecated注解
这个注解表明如果程序调用一个废弃的(Deprecated,废弃的,过时的)元素时,编译器应该显示警告信息.示例2显示了如何使用Deprecated注解.
Java注解示例2
首先,创建一个类,并像下面这样将某个方法标明为废弃:
publicclassTest_Deprecated{ @Deprecated publicvoiddoSomething(){ System.out.println("测试使用弃用注解:'Deprecated'"); } }
接着,尝试从另一个类调用这个方法:
publicclassTestAnnotations{ publicstaticvoidmain(Stringarg[])throwsException{ newTestAnnotations(); } publicTestAnnotations(){ Test_Deprecatedt2=newTest_Deprecated(); t2.doSomething(); }
本例中的doSomething()方法被声明为废弃的方法.因此,一般情况下不应该调用这个方法.在编译Test_Deprecated.java文件时是不会有警告消息的.但在编译TestAnnotations.java时编译器就会给出类似这样的警告信息(Eclipse会有警告):
Compiling1sourcefiletoD:tempNewFolder (2)TestJavaApplication1buildclasses D:tempNewFolder (2)TestJavaApplication1srctestmyannotation TestAnnotations.java:27: warning:[deprecation]doSomething()in test.myannotation.Test_Deprecatedhasbeendeprecated t2.doSomething(); 1warning
Suppresswarnings注解
这个注解告诉编译器应该屏蔽带注解的元素和所有子元素的警告信息.会压制一个元素集和子元素的所有警告信息.比如,假设你在一个class上使用了Suppresswarnings注解压住一个警告,在它的一个方法上用Suppresswarnings注解来压制另一个警告,则两种警告都会在方法级别被压制住.请参见示例3.
Java注解示例3:
publicclassTestAnnotations{ publicstaticvoidmain(Stringarg[])throwsException{ newTestAnnotations().doSomeTestNow(); } @SuppressWarnings({"deprecation"}) publicvoiddoSomeTestNow(){ Test_Deprecatedt2=newTest_Deprecated(); t2.doSomething(); } }
在本例中,使用@SuppressWarnings压住了示例2中所示的deprecation警告信息.因为该方法的这类警告被压住了,所以你不会再看到"deprecation"警告.
注意:在最内层的元素上使用该注解是比较好的.因此,如果你只想在一个特定的方法上压制一个警告,你应该在方法上标注,而不是在类上使用注解.
元注解(Meta-Annotations,Java注解类型)
元注解,实际上被称为注解的注解,包含四种类型.分别是:
1.Target
2.Retention
3.Documented
4.Inherited
Target注解
Target注解表明注解类型适用于哪种目标元素.它包含下面的枚举类型值:
1.@Target(ElementType.TYPE) ——可以适用于任何类的元素
2.@Target(ElementType.FIELD) ——只适用于字段或属性
3.@Target(ElementType.METHOD) ——只适用于方法的注解
4.@Target(ElementType.PARAMETER) ——只适用于方法的参数
5.@Target(ElementType.CONSTRUCTOR) ——只适用于构造函数
6.@Target(ElementType.LOCAL_VARIABLE) ——只适用于局部变量
7.@Target(ElementType.ANNOTATION_TYPE) ——指明声明类型本身是一个注解类型
示例4演示了Target注解:
Java注解示例4
首先,定义了一个名为Test_Target的注解类型,带上@Target元注解,如下所示:
@Target(ElementType.METHOD) public@interfaceTest_Target{ publicStringdoTestTarget(); }
接下来,创建一个类,它将使用Test_Target注解:
publicclassTestAnnotations{ publicstaticvoidmain(Stringarg[]){ newTestAnnotations().doTestTarget(); } //在方法上使用注解,OK. //中间也可以不换行,换2行之类,Java忽略多余的换行 @Test_Target(doTestTarget="HelloWorld!") publicvoiddoTestTarget(){ System.out.printf("TestingTargetannotation"); } }
@Target(ElementType.METHOD)注解表明该注解类型只能被用来注解方法.如果你编译这段代码,不会显示警告消息.但是,如果将这个注解声明到一个字符串变量上,会发生什么呢?就像下面这样:
publicclassTestAnnotations{ //这是错误的做法,编译不会通过,因为注解的Level不对. //元注解指明了只能注解方法,就不能用来注解属性 @Test_Target(doTestTarget="HelloWorld!") privateStringstr; publicstaticvoidmain(Stringarg[]){ newTestAnnotations().doTestTarget(); } publicvoiddoTestTarget(){ System.out.printf("TestingTargetannotation"); } }
唯一的变化就是注解声明从方法级转向字段级,这是不正确的.因为你已经定义了注解 @Test_Target只适用在方法级,如果你尝试编译这个类,你可能会得到这样的错误信息:
"TestAnnotations.java": D:R_AND_DTestAnnotationsrctestmyannotation TestAnnotations.java:16: annotationtypenotapplicabletothiskindofdeclarationatline 16,column0 @Test_Target(doTestTarget="HelloWorld!") ^ Errorinjavaccompilation