JAVA从J2SE5开始提供名为annotation(注释,标注)的功能。Java的annotation,可以附加在package, class, method, field等上面,相当于给它们添加了额外的辅助信息。附加在package, class, method, field等上的Annotation,如果没有外部解析工具等对其加以解析和处理的情况,本身不会对Java的源代码或class等产生任何影响,也不会对它们的执行产生任何影响。
但借助外部工具,比如javac,EJB容器等,可以对附加在package, class, method, field的annotation进行解析,可以根据annotation而做出相应的处理,比如运行时改变对象/方法的行为。
Java标准Annotation
@Deprecated 相当于Javadoc的@deprecated,被@Deprecated标注的对象class, method等被注明为不推荐使用。主要用于javac等编译工具。
@Override 注明对象method重载了父类的方法。javac等编译工具编译时会根据此Annotation判断重载方法是否正确。
@SuppressWarnings 告诉javac等编译器忽略所指定的特定的警告信息。
@Target 被定义的annotation可以附加在那些对象上。
@Retention annotation的作用期间。
Java标准Annotation的使用
@Deprecated:
<script src="http://www.lifevv.com/images/code/js/shCore.js" type="text/javascript"></script><script></script><script src="http://www.lifevv.com/images/code/js/shBrushJava.js" type="text/javascript"></script>
- @Deprecated
- public class TestBean {
- …
- }
@Deprecated
public class TestBean {
…
}
@SuppressWarnings
- @SuppressWarnings("serial")
- public class TestBean implements java.io.Serializable {
- …
- }
-
- @SuppressWarnings(value = {"serial", "unchecked"})
- public String doSth() {
- …
- }
@SuppressWarnings("serial")
public class TestBean implements java.io.Serializable {
…
}
@SuppressWarnings(value = {"serial", "unchecked"})
public String doSth() {
…
}
@Override
- @Override
- public String doSth() {
- …
- }
@Override
public String doSth() {
…
}
Annotation的定义
定义方法:
@interface Annotation名 {定义体}
定义例1:
- public @interface MyAnnotation {}
public @interface MyAnnotation {}
该例定义了一个无任何属性/方法的Annotation。
定义例2:
- public @interface MyAnnotation {
- public String value();
- }
public @interface MyAnnotation {
public String value();
}
该例定义了只有一个方法为value()的Annotation。一般来说,只有一个方法的Annotation,方法名一定定义为value。
定义例3:
- @Retention(RetentionPolicy.RUNTIME)
- @Target(ElementType.METHOD)
- public @interface MyAnnotation {
- public String value();
- public String [] multiValues();
- int number() default 0;
-
- }
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {
public String value();
public String [] multiValues();
int number() default 0;
}
该例定义了一个具有多方法的Annotation。并设置其中一个方法number的默认值为0。multiValues 方法定义为数组类型。Annotation定义可以用MetaAnnotation(元注释)修饰。MetaAnnotation有以下2个:
@Retention
@Target
我们将在以下对@Retention与@Target加以说明。
@Retention
@Retention 可以设置为RetentionPolicy类型的值。
例:
@Retention(RetentionPolicy.RUNTIME)
RetentionPolicy的值
说明
RetentionPolicy.CLASS |
annotation信息将被编译器编译时保存在class文件中,但执行时不会在VM装载。也就是说不能在执行时动态取得annotation信息。未设置@Retention时这将是默认设置值。 |
RetentionPolicy.RUNTIME |
annotation信息将被编译器编译时保存在class文件中,执行时也会被VM装载。 |
RetentionPolicy.SOURCE |
annotation信息将被编译器编译时舍弃掉。 |
@Target
@Target表明Annotation可以附加在哪种JAVA元素之上,可以设置为java.lang.annotation.ElementType数组类型的值。
使用例1:
- @Target(ElementType.METHOD)
@Target(ElementType.METHOD)
使用例2:
- @Target(value={ElementType.CONSTRUCTOR, ElementType.FIELD, ElementType.LOCAL_VARIABLE, ElementType.METHOD})
@Target(value={ElementType.CONSTRUCTOR, ElementType.FIELD, ElementType.LOCAL_VARIABLE, ElementType.METHOD})
ElementType是一个枚举类型,它具有以下定义:
ElementType值
说明
ElementType.ANNOTATION_TYPE |
应用于其他注解的元注解 |
ElementType.CONSTRUCTOR |
构造函数 |
ElementType.FIELD |
字段 |
ElementType.LOCAL_VARIABLE |
方法中的本地变量 |
ElementType.METHOD |
方法 |
ElementType.PACKAGE |
包 |
ElementType.PARAMETER |
方法的参数 |
ElementType.TYPE |
类,接口或者枚举声明 |
分享到:
相关推荐
学习java自定义注解的小例子,处理运行时注解方法,可以结合博客学习,博客地址: http://blog.csdn.net/liuyonglei1314/article/details/59494503
Java注解Annotation用起来很方便,也越来越流行,由于其简单、简练且易于使用等特点,很多开发工具都提供了注解功能,不好的地方就是代码入侵比较严重,所以使用的时候要有一定的选择性。 这篇文章将利用注解,来做...
实战篇:设计自己的Annotation
Java实战篇:设计自己的Annotation.pdf
Annotation在java的世界正铺天盖地展开,有空写这一篇简单的annotations的文章,算是关于Annotation入门的文章吧,希望能各位们能抛砖,共同学习......
本篇文章介绍了,Java Annotation(Java 注解)的实现代码。需要的朋友参考下
一篇关于JDK5.0中Annotation的文章,里面描述了Annotation技术与XML配置文件各自的优缺点及适用范围。
文档由五篇博客组成,说明了如何使用代理技术实现Annotation HttpClient通过,阅读这五篇博客,应该能够大致了解如何实现一个Annotation类型应用的框架。此外,配备了相应的Annotation HttpClient的源码,以供大家...
Annotation在java的世界正铺天盖地展开,有空写这一篇简单的annotations的文章,算是关于Annotation入门的文章吧,希望能各位们能抛砖,共同学习
全书分为23章,包括需要重点掌握的环境搭建、简单Java程序、Java基础程序设计、数组与方法、面向对象程序设计(基础篇和高级篇)、异常的捕获及处理、包及访问控制权限、Java常用类库、JavaIO、Java类集、Java数据库...
资源里一共有我的五篇博客组成,主要描述了如何使用代理技术来实现Annotation HttpClient。博客中描述了主要的流程和思路,对于想了解Annotation如何实现和内部细节的同学会有帮助。此外,提供了Annotation ...
注:下文中的 *** 代表文件名中的组件名称。 # 包含: 中文-英文对照文档:【***-javadoc-API文档-中文(简体)... (2)有时,一套Java组件会有多个jar,所以在下载前,请仔细阅读本篇描述,以确保这就是你需要的文件;
第5章对编码能力提升,包括异常处理、输入输出、集合框架、正则表达式、枚举类型和Annotation。异常处理,对程序中可能出现的异常情况进行处理;...枚举类型和Annotation类型的介绍;ResourceBundle的使用。
下面小编就为大家带来一篇浅谈Java中注解Annotation的定义、使用、解析。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
本书是《轻量级java ee企业应用实战》的姊妹篇,《轻量级java ee企业应用实战》主要介绍以spring+hibernate为基础的java ee应用;本书则主要介绍以ejb 3+jpa为基础的java ee应用。ejb 3、jpa规范都属于sun公司所...
介绍一下线程的几个状态(22)、wait和sleep的区别(23)、Git(24)、关联SQL查询(25)、设计模式(26)、Spring的annotation
注:下文中的 *** 代表文件名中的组件名称。 # 包含: 中文-英文对照文档:【***-javadoc-API文档-中文(简体)... (2)有时,一套Java组件会有多个jar,所以在下载前,请仔细阅读本篇描述,以确保这就是你需要的文件;
注:下文中的 *** 代表文件名中的组件名称。 # 包含: 中文-英文对照文档:【***-javadoc-API文档-中文(简体)... (2)有时,一套Java组件会有多个jar,所以在下载前,请仔细阅读本篇描述,以确保这就是你需要的文件;
注:下文中的 *** 代表文件名中的组件名称。 # 包含: 中文-英文对照文档:【***-javadoc-API文档-中文(简体)... (2)有时,一套Java组件会有多个jar,所以在下载前,请仔细阅读本篇描述,以确保这就是你需要的文件;
最后一篇文章将着重介绍集成和测试的新增性能。这一系列的三篇文章中引用的例子都基于Spring PetClinic应用程序范例。此范例最近被重构以用于展示Spring最新功能,并被包含于Spring 2.5的发布下载包中,可以从Spring...