关于@interface 自定义注解

自定义注解的话主要就3件事
1.定义注解
  

Java code ?

1 2 3 4

@Retention (RetentionPolicy.RUNTIME)     @Target (ElementType.METHOD)     public  @interface  Test { }

2.加注解到方法上，也可能是类上，变量上
  

Java code ?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

public  class  Foo {       @Test  public  static  void  m1() { }       public  static  void  m2() { }            @Test  public  static  void  m3() {          throw  new  RuntimeException( "Boom" );       }         public  static  void  m4() { }         @Test  public  static  void  m5() { }    　   public  static  void  m6() { }         @Test  public  static  void  m7() {          throw  new  RuntimeException( "Crash" );       }         public  static  void  m8() { }     }

3.使用注解
  这就涉及到反射的东西，lz去查java反射机制的东西吧
  

Java code ?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

import  java.lang.reflect.*;  　　 public  class  RunTests {  　　   public  static  void  main(String[] args)  throws  Exception {      　　  int  passed =  0 , failed =  0 ;           for  (Method m : Class.forName(args[ 0 ]).getMethods()) {             if  (m.isAnnotationPresent(Test. class )) {  //if(方法有@Test注解)              try  {                 m.invoke( null );                 passed++;               }  catch  (Throwable ex) {  //方法里抛出异常                System.out.printf( "Test %s failed: %s %n" , m, ex.getCause());  　　          failed++;               }             }  　　   }  　　   System.out.printf( "Passed: %d, Failed %d%n" , passed, failed);  　　 }  　　}

1 Target
指定所定义的annotation可以用在哪些程序单元上
如果Target没有指定，则表示该annotation可以使用在任意程序单元上
代码
    @Target({ElementType.ANNOTATION_TYPE,
             ElementType.CONSTRUCTOR,
             ElementType.FIELD,
            ElementType.LOCAL_VARIABLE,
             ElementType.METHOD,
             ElementType.PACKAGE,
             ElementType.PARAMETER,
             ElementType.TYPE})
    public @interface TODO {}


2  Retention
指出Java编译期如何对待annotation
annotation可以被编译期丢掉，或者保留在编译过的class文件中
在annotation被保留时，它也指定是否会在JVM加载class时读取该annotation
代码
   @Retention(RetentionPolicy.SOURCE)  // Annotation会被编译期丢弃
   public @interface TODO1 {}
   @Retention(RetentionPolicy.CLASS)   // Annotation保留在class文件中，但会被JVM忽略
   public @interface TODO2 {}
   @Retention(RetentionPolicy.RUNTIME) // Annotation保留在class文件中且会被JVM读取
   public @interface TODO3 {}


3  Documented
指出被定义的annotation被视为所熟悉的程序单元的公开API之一
被@Documented标注的annotation会在javadoc中显示，这在annotation对它标注的元素被客户端使用时有影响时起作用
d, Inherited
该meta-annotation应用于目标为class的annotation类型上，被此annotattion标注的class会自动继承父类的annotation

4  Annotation的反射
我们发现java.lang.Class有许多与Annotation的反射相关的方法，如getAnnotations、isAnnotationpresent
我们可以利用Annotation反射来做许多事情，比如自定义Annotation来做Model对象验证
代码
    @Retention(RetentionPolicy.RUNTIME)
   @Target({ ElementType.FIELD, ElementType.METHOD })
   public @interface RejectEmpty {
        /** hint title used in error message */
        String value() default "";
    }
    
    @Retention(RetentionPolicy.RUNTIME)
    @Target( { ElementType.FIELD, ElementType.METHOD })
   public @interface AcceptInt {
       int min() default Integer.MIN_VALUE;
       int max() default Integer.MAX_VALUE;
       String hint() default "";
   }
使用@RejectEmpty和@AcceptInt标注我们的Model的field，然后利用反射来做Model验证