java注解（一）

虽然平时有使用注解，不过没有深入了解，今天无聊，重新从基础深入了解整理下；

java注解是附加在代码中的一些元信息，用于一些工具在编译、运行时进行解析和使用，起到说明、配置的功能。
    注解不会也不能影响代码的实际逻辑，仅仅起到辅助性的作用。包含在 java.lang.annotation 包中。

1、元注解
    元注解是指注解的注解。包括  @Retention @Target @Document @Inherited四种。
    1.1、@Retention: 定义注解的保留策略
    @Retention（RetentionPolicy.SOURCE） //注解仅存在于源码中，在class字节码文件中不包含
    @Retention（RetentionPolicy.CLASS）  //默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得，
    @Retention（RetentionPolicy.RUNTIME）//注解会在class字节码文件中存在，在运行时可以通过反射获取到
    1.2、@Target:定义注解的作用目标
    @Target（ElementType.TYPE）   //接口、类、枚举、注解
    @Target（ElementType.FIELD） //字段、枚举的常量
    @Target（ElementType.METHOD） //方法
    @Target（ElementType.PARAMETER） //方法参数
    @Target（ElementType.CONSTRUCTOR）  //构造函数
    @Target（ElementType.LOCAL_VARIABLE）//局部变量
    @Target（ElementType.ANNOTATION_TYPE）//注解
    @Target（ElementType.PACKAGE） ///包
    elementType 可以有多个，一个注解可以为类的，方法的，字段的等等
    1.3、@Document:说明该注解将被包含在javadoc中
    1.4、@Inherited:说明子类可以继承父类中的该注解

下面是自定义注解的一个例子
    2、注解的自定义

    @Retention（RetentionPolicy.RUNTIME）
    @Target（ElementType.METHOD）
    public @interface HelloWorld {
    	public String name（） default "";
    }

    3、注解的使用，测试类

    public class SayHello {
      @HelloWorld（name = "Intl"）
      public void sayHello（String name） {
    	System.out.println（name + "say hello world!"）；
      }
    }

    4、解析注解
    java的反射机制可以帮助，得到注解，代码如下：

public class AnnTest {
    public void parseMethod(Class<?> clazz) {
    Object obj;
    try {
    	// 通过默认构造方法创建一个新的对象
    	obj = clazz.getConstructor(new Class[] {}).newInstance(new Object[] {});
    	for （Method method : clazz.getDeclaredMethods()) {
    		HelloWorld say = method.getAnnotation（HelloWorld.class）;
    		String name = "";
    		if (say != null){
    			name = say.name();
    			System.out.println(name);
    			method.invoke(obj, name);
    		}
   	 }
   	 } catch(Exception e) {
    		e.printStackTrace();
    	 }
    }
    public static void main(String[] args) {
    	AnnTest t = new AnnTest();
    	t.parseMethod(SayHello.class);
    }
    }