资源描述:
《java注解教程:自定义注解示例,利用反射进行解析-java开发java经验技巧》由会员上传分享,免费在线阅读,更多相关内容在工程资料-天天文库。
1、Java注解教程:自定义注解示例,利用反射进行解析-编程开发技术Java注解教程:自定义注解示例,利用反射进行解析本文illImportNew-JustinWu翻译口Journaldevo欢迎加入翻译小组。转载请见文末要求。Java注解能够捉供代码的相关信息,同时对丁•所注解的代码结构又没冇直接影响。在这篇教程中,我们将学习Java注解,如何编写口定义注解,注解的使用,以及如何使用反射解析注解。注解是Java1.5引入的,目前已被广泛应用于各种Java框架,如Hibernate,Jersey,Springe注解相当于是一种嵌入在程
2、序屮的元数据,可以使用注解解析工具或编译器对其进行解析,也可以指定注解在编译期或运行期有效。在注解诞主之前,程序的元数据存在的形式仅限于走阳注释或javadoc,但注解可以提供更多功能,它不仅包含元数据,还能作用于运行期,注解解析器能够使用注解决定处理流程。举个例子,在Jerseywebservice中,我们在一个方法上添加了PATII注解和URI字符串,在运行期,jersey会对其进行解析,并决定作用于指定UR1模式的方法。在Java中创建自定义注解创建自定义注解与编写接口很相似,除了它的接口关键字前有个@符号。我们可以在注解中
3、定义方法,先來看个例子,之后我们会继续讨论它的特性。packagecom・journeildcv.annotations;importjava.lang.annotation.Documented;importjava.lang,armotation.ElementType;importjava.lang,annotation.Tnherited;importjava・lang,annotation.Rotention;importjava・lang・annotation・RetentionPolicy;importjava.la
4、ng.annotation.Target;©Documented@Targct(ElcmentTypc.METHOD)©Inherited©Retention(RetentionPolicy.RUNTIME)public@interfaceMethodInfo{Stringauthor()default,,Pankaj,z;Stringdate();intrevision()default1;Stringcomments();•注解方法不能有参数。•注解方法的返回类型局限于原始类型,字符串,枚举,注解,或以上类型构成的数组。•注解
5、方法可以包含默认值。•注解可以包含与其绑定的元注解,元注解为注解提供信息,有四种元注解类型:1.©Documented-表示使用该注解的元素应被javadoc或类似工具文档化,它应用于类型声明,类型声明的注解会影响客户端对注解元素的使用。如果-•个类型声明添加了Documented注解,那么它的注解会成为被注解元索的公共APT的一部分。2.©Target-表示支持注解的程序元素的种类,一些可能的值冇TYPE,METHOD,CONSTRUCTOR,FIELD等等。如果Target元注解不存在,那么该注解就可以使用在任何程序元素之上。
6、3.©Inherited-表示一个注解类型会被自动继承,如果用户在类声明的时候查询注解类型,同时类声明屮也没有这个类型的注解,那么注解类型会自动查询该类的父类,这个过程将会不停地重复,直到该类型的注解被找到为止,或是到达类结构的顶层(Object)。4.@Retention-表示注解类型保留吋间的长短,它接收RetentionPolicy参数,可能的值有SOURCE,CLASS,以及RUNTTMEoJava内置注解Java提供3种内置注解。1.©Override-当我们想要覆盖父类的一个方法时,需要使用该注解告知编译器我们正在覆盖
7、-个方法。这样的话,当父类的方法被删除或修改了,编译器会提示错误信息。大家可以学习一下为什么我们总是应该在覆盖方法时使用Java覆盖注解。2.©Deprecated-当我们想要让编译器知道一个方法已经被弃用(deprecate)时,应该使用这个注解。Java推荐在javadoc中提供信息,告知用户为什么这个方法被弃用了,以及替代方法是什么。3.@SuppressWarnings-这个注解仅仅是告知编译器,忽略它们产生了特殊警告,比如:在java泛型中使用原始类型。它的保持性策略(retentionpolicy)是SOURCE,在编
8、译器中将被丢弃。我们来看一个例子,展示了如何使用内置注解,以及上述示例中提及的自定义注解。packagecom.journaldev.annotations;importjava.io.FileNotFoundException;importjav