部分信息来自《Thinking In Java》
注解也成为元数据。什么是元数据?就是“关于数据的数据”
注解为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某个时刻非常方便的使用这些数据。
它可以用来完整的描述程序所需的信息,能够让编译器来测试和验证格式,存储有关程序的额外信息。
定义一个注解:
注解的样子和接口很像
package me.benzeph.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
}
定义注解时,需要一些元注解(关于注解的注解)例如:@Target和@Retention。
@Target用来定义你的注解应用于什么地方。例如:方法,域。
@Target(ElementType.METHOD)
@Target(ElementType.CONSTRUCTOR)
@Target(ElementType.PARAMETER)
...
@Retention用来定义你的注解在哪个级别可用。例如:源代码中,类文件中或者运行时。
@Retention(RetentionPolicy.RUNTIME)
@Retention(RetentionPolicy.CLASS)
@Retention(RetentionPolicy.SOURCE)
如果一个注解中没有一个元素。那么它就称为标记注解。例如@Test。
在注解中,一般都会包含一些元素以表示某些值。当分析处理注解时,程序或工具可以利用这些值。
package me.benzeph.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
public int value();
}
package me.benzeph.annotation;
public class UseAnnotation {
@MyAnnotation(value = 10)
public void useMyAnnotation() {
}
}
如果没有读取注解的工具,那么注解也不会比注释更有用。
利用两个反射方法去解析一个含有某个注解的方法。
package me.benzeph.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
int value();
}
package me.benzeph.annotation;
public class UseAnnotation {
@MyAnnotation(value = 10)
public void useMyAnnotation() {
}
}
package me.benzeph.annotation;
import java.lang.reflect.Method;
public class MyAnnotationParser {
public boolean findMethodByValue(int value) {
for (Method method : UseAnnotation.class.getDeclaredMethods()) {
MyAnnotation myAnnotation = method.getAnnotation(MyAnnotation.class);
if ((myAnnotation != null) && (myAnnotation.value() == value)) {
return true;
}
}
return false;
}
}
package me.benzeph.annotation;
import org.junit.Before;
import org.junit.Test;
import static org.junit.Assert.assertFalse;
import static org.junit.Assert.assertTrue;
public class MyAnnotationParserTest {
private MyAnnotationParser parser;
@Before
public void setUp() throws Exception {
parser = new MyAnnotationParser();
}
@Test
public void shouldReturnTrue() {
assertTrue(parser.findMethodByValue(10));
}
@Test
public void shouldReturnFalse() {
assertFalse(parser.findMethodByValue(5));
}
}