Java编程之注解

概念：

    ☆  注解（@interface）是一种元数据，是一种代码级别的说明

    ☆  是JDK5.0及以后版本引入的一个特性

    ☆  与包package、类class、接口interface、枚举enum是在同一层次

    ☆  可以声明在包、类、子段、方法、局部变量、方法参数之前。

注解的作用：

 1. 编写文档：通过代码里标识的元数据生成文档

 2. 代码分析：通过代码里标识的元数据对代码进行分析

 3. 编译检查：通过代码里标识的元数据让编译器能够实现基本的编译检查
 4. 跟踪代码依赖性，实现替代配置文件。比较常见的是spring2.4开始的基于注解配置。作用就是减少配置。现在的 

   框架基本都使用了这种配置来减少配置文件的数量。

注解的语法和定义形式：

a. 用@interface关键字定义

b.注解包含成员，成员是由无参数的方法的形式被声明的，器其方法名和返回值定义了该成员的名字和类型

c.成员赋值通过@Annotation(name="value")的方式

d.注解需要标明注解的生命周期、修饰目标信息，这些都是通过元注解实现

   @Retention(value=RetentionPolicy.RUNTIME)
   @Target(value={ElementType.ANNOTATION_TYPE})
   public @interface Target{
      ElementType[] value();
   }

     如果成员名是value，则可以简写，如果成员类型是数组，但是只赋值一个元素，也可以简写，以上简写为：

   @Target(ElementType.ANNOTATION_TYPE)

注解的分类：

       注解分为两类：

               一类是元注解（修饰注解的注解）

              另一个是普通注解

      如何判断一个注解是不是元注解呢？看它的元注解就行（无论是元注解还是普通注解，都有元注解），

     @Target(ElementType.ANNOTATION_TYPE)这个就是元注解，作用在元注解之上

 注解的声明周期：

            注解需要标明生命周期，这些信息是通过元注解来实现的，而这个元注解是：

     public @interface Retention{
           RetentionPolicy value();
     }

           Retention注解的值是enum类型的RetentionPolicy。包括如下几种情况：

            ●   SOURCE：注解只是保存在源文件中，当Java文件被编译成class文件的时候，注解被遗弃。

            ●   CLASS： 注解被保留到class文件中，当被加载的时候，注解被遗弃。

            ●   RUNTIME：注解不仅保存在class文件中个，jvm加载class文件之后，仍然存在，保留到Class对象中，可以通过反射来获取

 注解修饰的目标：

  就是这个注解可以写在哪里。

  首先是这个元注解的实现：

    public @interface Target{
       ElementType[] value();
    }

  这个注解的值是enum类型ElementType。包括以下几种情况：

•  TYPE:可以在类型上进行注解，比如类、接口、enum上使用的注解

•  FIELD：在声明的常量上

•  METHOD：在方法上使用

•  PARAMETER：指的是在参数上使用的注解

•  LOCAL_VARIABLE：局部变量上使用

•  在注解上使用元注解ANNOTATION_TYPE:

•  PACKAGE:在包上使用注解

注解的底层实现：

   import java.lang.annotation.ElementType;
   import java.lang.annotation.Retention;
   import java.lang.annotation.RetentionPolicy;
   import java.lang.annotation.Target;

   import javax.lang.model.element.Element;

   @Retention(RetentionPolicy.RUNTIME)
   @Target(ElementType.TYPE)
   public @interface Cache {
	String value() default "cache";
   }

  

      1．public interface Cache extends java.lang.annotation.Annotation,注解是继承自

           Annotation，仍然是interface

      2.public abstract java.lang.String value(),说明value方法是abstract类型

  三个基本的注解：

    1. @override   标记这是重写了父类的方法，只存在于源码中的注解

    2. @deprecated  标记这个方法已经是废除的方法

    3. @SupportWarning   压住一切警告信息

注解案例：

package annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;


@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface ClassInfo {
	String name() default "";
}

package 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 MethodInfo {
	String name() default "";
}

package annotation;
@ClassInfo(name="学霸班级")
public class ClassOne {
	@MethodInfo(name="学习非常刻苦")
	public void study(){
		
	}
}

package annotation;

import java.lang.reflect.Method;

import org.junit.Test;

public class AnnotationParse {
	public static void parse(){
		
		Class clazz = ClassOne.class;
		
		if(clazz.isAnnotationPresent(ClassInfo.class)){
			ClassInfo classInfo = (ClassInfo) clazz.getAnnotation(ClassInfo.class);
			System.out.println(classInfo.name());
		}
		
		Method[] methods = clazz.getMethods();
		
		for (Method method : methods) {
			if(method.isAnnotationPresent(MethodInfo.class)){
				MethodInfo methodInfo = method.getAnnotation(MethodInfo.class);
				System.out.println(methodInfo.name());
			}
		}
		
	}
	@Test
	public void testAnnotationParse(){
		parse();
	}
}