Java注解的简单了解

注解也成为元数据。什么是元数据?就是“关于数据的数据”

注解为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某个时刻非常方便的使用这些数据。

它可以用来完整的描述程序所需的信息,能够让编译器来测试和验证格式,存储有关程序的额外信息。

定义一个注解:

注解的样子和接口很像

 

[java][/java] view plaincopy

  1. package me.benzeph.annotation;
  2. import java.lang.annotation.ElementType;
  3. import java.lang.annotation.Retention;
  4. import java.lang.annotation.RetentionPolicy;
  5. import java.lang.annotation.Target;
  6. @Target(ElementType.METHOD)
  7. @Retention(RetentionPolicy.RUNTIME)
  8. public @interface MyAnnotation {
  9. }

定义注解时,需要一些元注解(关于注解的注解)例如:@Target和@Retention。

 

@Target用来定义你的注解应用于什么地方。例如:方法,域。

 

[java][/java] view plaincopy

  1. @Target(ElementType.METHOD)
  2. @Target(ElementType.CONSTRUCTOR)
  3. @Target(ElementType.PARAMETER)

@Retention用来定义你的注解在哪个级别可用。例如:源代码中,类文件中或者运行时。

 

 

[java][/java] view plaincopy

  1. @Retention(RetentionPolicy.RUNTIME)
  2. @Retention(RetentionPolicy.CLASS)
  3. @Retention(RetentionPolicy.SOURCE)

如果一个注解中没有一个元素。那么它就称为标记注解。例如@Test。

 

在注解中,一般都会包含一些元素以表示某些值。当分析处理注解时,程序或工具可以利用这些值。

 

[java][/java] view plaincopy

  1. package me.benzeph.annotation;
  2. import java.lang.annotation.ElementType;
  3. import java.lang.annotation.Retention;
  4. import java.lang.annotation.RetentionPolicy;
  5. import java.lang.annotation.Target;
  6. @Target(ElementType.METHOD)
  7. @Retention(RetentionPolicy.RUNTIME)
  8. public @interface MyAnnotation {
  9.     public int value();
  10. }

 

[java][/java] view plaincopy

  1. package me.benzeph.annotation;
  2. public class UseAnnotation {
  3.     @MyAnnotation(value = 10)
  4.     public void useMyAnnotation() {
  5.     }
  6. }

如果没有读取注解的工具,那么注解也不会比注释更有用。

 

利用两个反射方法去解析一个含有某个注解的方法。

 

[java][/java] view plaincopy

  1. package me.benzeph.annotation;
  2. import java.lang.annotation.ElementType;
  3. import java.lang.annotation.Retention;
  4. import java.lang.annotation.RetentionPolicy;
  5. import java.lang.annotation.Target;
  6. @Target(ElementType.METHOD)
  7. @Retention(RetentionPolicy.RUNTIME)
  8. public @interface MyAnnotation {
  9.     int value();
  10. }

 

[java][/java] view plaincopy

  1. package me.benzeph.annotation;
  2. public class UseAnnotation {
  3.     @MyAnnotation(value = 10)
  4.     public void useMyAnnotation() {
  5.     }
  6. }

 

[java][/java] view plaincopy

  1. package me.benzeph.annotation;
  2. import java.lang.reflect.Method;
  3. public class MyAnnotationParser {
  4.     public boolean findMethodByValue(int value) {
  5.         for (Method method : UseAnnotation.class.getDeclaredMethods()) {
  6.             MyAnnotation myAnnotation = method.getAnnotation(MyAnnotation.class);
  7.             if ((myAnnotation != null) && (myAnnotation.value() == value)) {
  8.                 return true;
  9.             }
  10.         }
  11.         return false;
  12.     }
  13. }

 

[java][/java] view plaincopy

  1. package me.benzeph.annotation;
  2. import org.junit.Before;
  3. import org.junit.Test;
  4. import static org.junit.Assert.assertFalse;
  5. import static org.junit.Assert.assertTrue;
  6. public class MyAnnotationParserTest {
  7.     private MyAnnotationParser parser;
  8.     @Before
  9.     public void setUp() throws Exception {
  10.         parser = new MyAnnotationParser();
  11.     }
  12.     @Test
  13.     public void shouldReturnTrue() {
  14.         assertTrue(parser.findMethodByValue(10));
  15.     }
  16.     @Test
  17.     public void shouldReturnFalse() {
  18.         assertFalse(parser.findMethodByValue(5));
  19.     }
  20. }

标签