Java自定义Annotation的应用(注解@)
2014-08-29 17:17
531 查看
作为一个Javaer 我想对于 Java Annotation(注解或元数据)并已不是什么新鲜的东西了,在现在流行的SSH、JUnit等框架中早也已经广泛使用,然而在我们实际开发中对于自定义 Annotation 的场景和需求也并不见得多,大多数都还是以使用为主。
1. 基本语法
Java代码
package org.denger.annotation.example;
import java.lang.annotation.ElementType;
import java.lang.annotation.Target;
// The @Bind tag.
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Bind {
public String name();
public int time() default 0;
}
以上是一个用于Method级的简单的@Bind注解类,比较有点象接口的结构,事实上,与其它任何Java接口一样,注解也将会编译成class文件。
Java代码
package org.denger.annotation.example;
/**
* Use the @Bind tag.
*/
public class BindCase {
@Bind(name="case", time=1)
public void method(){
// do something..
}
public void method1(){
// do something..
}
@Bind(name="case1", time=20)
public void method2(){
// do something..
}
}
编写注解处理器:
在 JASE 1.5扩展了了反射机制的API,为我们提供了相应的注解处理器的API,另外还可以通过外部工具 apt 来解析带有注解的Java Code.
Java代码
public class BindCaseTracker{
private static Logger logger = Logger.getLogger(BindCaseTracker.class);
public static void printBindCase(Class<?> bindClass){
assert bindClass != null;
for (Method method : bindClass.getDeclaredMethods()){
Bind bind = method.getAnnotation(Bind.class);
if (bind == null) continue; // Not found annotation.
logger.debug(String.format("Found [%s] Bind Case : %s-%d", method
.getName(), bind.name(), bind.time()));
}
}
public static void main(String[] args) {
BindCaseTracker.printBindCase(BindCase.class);
}
} /* Output:
[DEBUG] 11-08 14:15 Found [method] Bind Case : case-1
[DEBUG] 11-08 14:15 Found [method2] Bind Case : case1-20
*///~
2. 元注解
在J2SE中内置了三种常用标准注解(Override, Deprecated, SuppressWarnings)以及四种元注解:
@Target:
表示该注解可以用于什么地方。可用ElementType枚举类型主要有:
TYPE :
类、接口或enum声明
FIELD:
域(属性)声明
METHOD:
方法声明
PARAMETER:
参数声明
CONSTRUCTOR:
构造方法声明
LOCAL_VARIABLE:局部变量声明
ANNOTATION_TYPE:注释类型声明
PACKAGE:
包声明
@Retention:
表示需要在什么级别保存该注解信息。可用RetentionPolicy枚举类型主要有:
SOURCE:
注解将被编译器丢弃。
CLASS
: 注解在class文件中可能。但会被VM丢弃。
RUNTIME:
VM将在运行时也保存注解(如果需要通过反射读取注解,则使用该值)。
@Documented:
将此注解包含在Javadoc中。
@Inherited:
允许子类继承父类中的注解。
3. 使用技巧
a. 如果希望定义的注解用于多种 ElementType 的话可以写成:
Java代码
import static java.lang.annotation.ElementType
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
b. 在声明注解中的方法时可通过 default 来指定默认值。
c. 在声明注解中的方法返回类型可结合泛型使用,如:
Java代码
Class<? extends Payload>[] payload() default {};
d. 可在注解类中定义嵌套注解,如:
Java代码
import static java.lang.annotation.ElementType
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
public @interface NotNull {
String message() default "{javax.validation.constraints.NotNull.message}";
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@interface List {
NotNull[] value();
}
}
Java代码
@NotNull.List(value = { @NotNull })
protected List<?> list;
e. 在JASE中提供了很少的内置注解,不过JBoss提供了一个 validation-api 的类库,提供常用验证注解。有兴趣的朋友可以下载看看,其 maven 依赖为:
Xml代码
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
<version>1.0</version>
</dependency>
1. 基本语法
Java代码
package org.denger.annotation.example;
import java.lang.annotation.ElementType;
import java.lang.annotation.Target;
// The @Bind tag.
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Bind {
public String name();
public int time() default 0;
}
以上是一个用于Method级的简单的@Bind注解类,比较有点象接口的结构,事实上,与其它任何Java接口一样,注解也将会编译成class文件。
Java代码
package org.denger.annotation.example;
/**
* Use the @Bind tag.
*/
public class BindCase {
@Bind(name="case", time=1)
public void method(){
// do something..
}
public void method1(){
// do something..
}
@Bind(name="case1", time=20)
public void method2(){
// do something..
}
}
编写注解处理器:
在 JASE 1.5扩展了了反射机制的API,为我们提供了相应的注解处理器的API,另外还可以通过外部工具 apt 来解析带有注解的Java Code.
Java代码
public class BindCaseTracker{
private static Logger logger = Logger.getLogger(BindCaseTracker.class);
public static void printBindCase(Class<?> bindClass){
assert bindClass != null;
for (Method method : bindClass.getDeclaredMethods()){
Bind bind = method.getAnnotation(Bind.class);
if (bind == null) continue; // Not found annotation.
logger.debug(String.format("Found [%s] Bind Case : %s-%d", method
.getName(), bind.name(), bind.time()));
}
}
public static void main(String[] args) {
BindCaseTracker.printBindCase(BindCase.class);
}
} /* Output:
[DEBUG] 11-08 14:15 Found [method] Bind Case : case-1
[DEBUG] 11-08 14:15 Found [method2] Bind Case : case1-20
*///~
2. 元注解
在J2SE中内置了三种常用标准注解(Override, Deprecated, SuppressWarnings)以及四种元注解:
@Target:
表示该注解可以用于什么地方。可用ElementType枚举类型主要有:
TYPE :
类、接口或enum声明
FIELD:
域(属性)声明
METHOD:
方法声明
PARAMETER:
参数声明
CONSTRUCTOR:
构造方法声明
LOCAL_VARIABLE:局部变量声明
ANNOTATION_TYPE:注释类型声明
PACKAGE:
包声明
@Retention:
表示需要在什么级别保存该注解信息。可用RetentionPolicy枚举类型主要有:
SOURCE:
注解将被编译器丢弃。
CLASS
: 注解在class文件中可能。但会被VM丢弃。
RUNTIME:
VM将在运行时也保存注解(如果需要通过反射读取注解,则使用该值)。
@Documented:
将此注解包含在Javadoc中。
@Inherited:
允许子类继承父类中的注解。
3. 使用技巧
a. 如果希望定义的注解用于多种 ElementType 的话可以写成:
Java代码
import static java.lang.annotation.ElementType
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
b. 在声明注解中的方法时可通过 default 来指定默认值。
c. 在声明注解中的方法返回类型可结合泛型使用,如:
Java代码
Class<? extends Payload>[] payload() default {};
d. 可在注解类中定义嵌套注解,如:
Java代码
import static java.lang.annotation.ElementType
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
public @interface NotNull {
String message() default "{javax.validation.constraints.NotNull.message}";
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@interface List {
NotNull[] value();
}
}
Java代码
@NotNull.List(value = { @NotNull })
protected List<?> list;
e. 在JASE中提供了很少的内置注解,不过JBoss提供了一个 validation-api 的类库,提供常用验证注解。有兴趣的朋友可以下载看看,其 maven 依赖为:
Xml代码
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
<version>1.0</version>
</dependency>
相关文章推荐
- java注解应用实例 - Annotation, 自定义注解, 注解类规则
- java注解应用实例 - Annotation, 自定义注解, 注解类规则
- Java注解应用实例 - Annotation, 自定义注解, 注解类规则
- java注解应用实例 - Annotation, 自定义注解, 注解类规则
- java注解应用实例 - Annotation, 自定义注解, 注解类规则
- java注解应用实例 - Annotation, 自定义注解, 注解类规则
- java注解应用实例 - Annotation, 自定义注解, 注解类规则
- java 注解应用实例 - Annotation, 自定义注解, 注解类规则
- Java Annotation自定义注解详解
- java自定义 注解 annotation、标签库tag、监听listener、junit简单测试代码
- Java注解annotation用法和自定义注解处理器
- Java中的Annotation详解和使用 自定义注解
- 深入理解Java:注解(Annotation)自定义注解入门
- 深入理解Java:注解(Annotation)自定义注解入门
- Java基础笔记 – Annotation注解的介绍和使用 自定义注解
- Java基础---Java---基础加强---内省的简单运用、注解的定义与反射调用、 自定义注解及其应用、泛型及泛型的高级应用、泛型集合的综合
- 深入理解Java:注解(Annotation)自定义注解入门
- Java注解annotation用法和自定义注解处理器
- 自定义 Java Annotation及应用
- Java基础---Java---基础加强---内省的简单运用、注解的定义与反射调用、 自定义注解及其应用、泛型及泛型的高级应用、泛型集合的综合