自定义注解(@interface)学习

  @interface 

   关键字表示本类为注解类，类结构：

            public @interface 自定义注解名 { 自定义注解体 }

    注解体中支持的元素类型：

　　　　1.所有基本数据类型（int,float,boolean,byte,double,char,long,short)

　　　　2.String类型

　　　　3.Class类型

　　　　4.enum类型

　　　　5.Annotation类型

　　　　6.以上所有类型的数组

简单示例：

public @interface SecurityCheck {

	boolean open() default false;

	SecurityCheckType[] checkTypes();

	boolean justLimitFailure() default false;

	String rule() default "";

}

定义好注解后即使用，使用示例：

@SecurityCheck(open = true, justLimitFailure = true, checkTypes = SecurityCheckType.IP)

jdk提供了几个配置/注解来配合/规范注解类的使用，一般定义于注解类上，下面一起看一下。

1.@Target

    主要用于规定注解使用的位置，参考下表(表格出自 http://blog.csdn.net/snakemoving/article/details/74364351)

取值	注解使用范围
METHOD	可用于方法上
TYPE	可用于类或者接口上
ANNOTATION_TYPE	可用于注解类型上（被@interface修饰的类型）
CONSTRUCTOR	可用于构造方法上
FIELD	可用于域上
LOCAL_VARIABLE	可用于局部变量上
PACKAGE	用于记录java文件的package信息
PARAMETER	可用于参数上

    例子：@Target({ ElementType.METHOD })   表示该注解用于方法上

2.@Retention

    主要功能是定义注解保留时间的长短，可以设置的三个值都出自RetentionPolicy

public enum RetentionPolicy
{
  SOURCE,  CLASS,  RUNTIME;
  
  private RetentionPolicy() {}
}

      SOURCE:在源文件中有效（即源文件保留）
　　CLASS:在class文件中有效（即class保留，默认策略）

　　RUNTIME:在运行时有效（即运行时保留，可以通过此级别获取注解信息）

      例子：@Retention(RetentionPolicy.RUNTIME)   也是一般用法

3.@Documented

    仅仅作为一个标记注解，说明该注解类应该被javadoc工具记录(默认情况下是不记录的)，不在代码运行时产生影响。

4.@Inherited   待整理，没搞懂