Java反射与注解（对学习框架很有帮助）

一、反射

请看我的另一篇博客《Java反射机制》

getDeclaredField(name);//获取所有字段
getConstructor(null); //获取public 构造方法
getDeclaredConstructors(); //获取所有的构造方法
getMethod(name, parameterTypes);//获取public方法
getDeclaredMethod(name, parameterTypes);//获取所有方法
newInstance(); //实例化

二、注解

Java注解提供了关于代码的一些信息，但并不直接作用于它所注解的代码内容。在这个教程当中，我们将学习Java的注解，如何定制注解，注解的使用以及如何通过反射解析注解。

Java1.5引入了注解，当前许多java框架中大量使用注解，如Hibernate、Jersey、Spring。注解作为程序的元数据嵌入到程序当中。注解可以被一些解析工具或者是编译工具进行解析。我们也可以声明注解在编译过程或执行时产生作用。

在使用注解之前，程序源数据只是通过java注释和javadoc，但是注解提供的功能要远远超过这些。注解不仅包含了元数据，它还可以作用于程序运行过程中、注解解释器可以通过注解决定程序的执行顺序。例如，在Jersey webservice 我们为方法添加URI字符串的形式的PATH注解，那么在程序运行过程中jerser解释程序将决定该方法去调用所给的URI。

1. 元注解：

　　元注解的作用就是负责注解其他注解。Java5.0定义了4个标准的meta-annotation类型，它们被用来提供对其它 annotation类型作说明。Java5.0定义的元注解：
　　　　1.@Target,
　　　　2.@Retention,
　　　　3.@Documented,
　　　　4.@Inherited
　　这些类型和它们所支持的类在java.lang.annotation包中可以找到。下面我们看一下每个元注解的作用和相应分参数的使用说明。
　　
（1）@Target：

　　　@Target说明了Annotation所修饰的对象范围：Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。在Annotation类型的声明中使用了target可更加明晰其修饰的目标。

　　作用：用于描述注解的使用范围（即：被描述的注解可以用在什么地方）

　　取值(ElementType)有：

　　　　1.CONSTRUCTOR:用于描述构造器
　　　　2.FIELD:用于描述域
　　　　3.LOCAL_VARIABLE:用于描述局部变量
　　　　4.METHOD:用于描述方法
　　　　5.PACKAGE:用于描述包
　　　　6.PARAMETER:用于描述参数
　　　　7.TYPE:用于描述类、接口(包括注解类型) 或enum声明
（2）@Retention：

　　@Retention定义了该Annotation被保留的时间长短：某些Annotation仅出现在源代码中，而被编译器丢弃；而另一些却被编译在class文件中；编译在class文件中的Annotation可能会被虚拟机忽略，而另一些在class被装载时将被读取（请注意并不影响class的执行，因为Annotation与class在使用上是被分离的）。使用这个meta-Annotation可以对 Annotation的“生命周期”限制。

　　作用：表示需要在什么级别保存该注释信息，用于描述注解的生命周期（即：被描述的注解在什么范围内有效）

　　取值（RetentionPoicy）有：

　　　　1.SOURCE:在源文件中有效（即源文件保留）
　　　　2.CLASS:在class文件中有效（即class保留）
　　　　3.RUNTIME:在运行时有效（即运行时保留）
（3）@Documented:

　　@Documented用于描述其它类型的annotation应该被作为被标注的程序成员的公共API，因此可以被例如javadoc此类的工具文档化。Documented是一个标记注解，没有成员。

（4）@Inherited：

　　@Inherited 元注解是一个标记注解，@Inherited阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。

　　注意：@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation，方法并不从它所重载的方法继承annotation。

　　当@Inherited annotation类型标注的annotation的Retention是RetentionPolicy.RUNTIME，则反射API增强了这种继承性。如果我们使用java.lang.reflect去查询一个@Inherited annotation类型的annotation时，反射代码检查将展开工作：检查class和其父类，直到发现指定的annotation类型被发现，或者到达类继承结构的顶层。
　　
2.自定义注解：

　　使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口，由编译程序自动完成其他细节。在定义注解时，不能继承其他的注解或接口。@interface用来声明一个注解，其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称，返回值类型就是参数的类型（返回值类型只能是基本类型、Class、String、enum）。可以通过default来声明参数的默认值。

　　定义注解格式：
　　public @interface 注解名 {定义体}

　　注解参数的可支持数据类型：

　　　　1.所有基本数据类型（int,float,boolean,byte,double,char,long,short)
　　　　2.String类型
　　　　3.Class类型
　　　　4.enum类型
　　　　5.Annotation类型
　　　　6.以上所有类型的数组

　　Annotation类型里面的参数该怎么设定:
　　第一,只能用public或默认(default)这两个访问权修饰.例如,String value();这里把方法设为defaul默认类型；　 　
　　第二,参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和 String,Enum,Class,annotations等数据类型,以及这一些类型的数组.例如,String value();这里的参数成员就为String;　　
　　第三,如果只有一个参数成员,最好把参数名称设为”value”,后加小括号.例:下面的例子FruitName注解就只有一个参数成员。

代码示例（反射及部分注解解析）：

package fansheDemo;

import java.lang.annotation.ElementType;

/**
***********************************
*
*@类名    Demo
*@时间    2017年6月9日下午2:34:04
*@作者    沈雪冰
*@描述    
*
***********************************
*/
public class Demo {
     
//  @Test(vlaue = "demo")//ElementType.FIELD 作用在变量的作用域
    private String name;
     Demo(){}


    public Demo(String name){
        this.name=name;
    }
    @Deprecated  //方法过时，能不用就不用
    @Test(vlaue = "demo") //这里ElementType.METHOD 是方法作用于
    public int add(int a,int b){
        return a+b;
    }
    private String getName(){
        return name;
    }
    // @Test(vlaue = "") 在注解当中ElementType.FIELD 不能作用在方法作用于上

    public String getPubNmae(){
        return name;
    }

}

package fansheDemo;

import java.io.File;
import java.io.ObjectInputStream.GetField;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.Method;

import org.omg.PortableInterceptor.ServerRequestInfo;



/**
***********************************
*
*@类名    Main
*@时间    2017年6月9日下午2:35:50
*@作者    沈雪冰
*@描述    
*
***********************************
*/
public class MainDemo {
    public static void main(String[] args) {
        try {
            Class test=Class.forName("fansheDemo.Demo");
            Demo demo=(Demo) test.newInstance();
             //  demo.add(1,1);  //方法过时，会划横线，我们在写程序的时候会经常看到，因为JDK版本在更新，所以方法有的就弃用了
            //getField 获取public 字段
        //  test.getDeclaredField(name);//获取所有字段
        //  test.getConstructor(null); //获取public 构造方法
        //  test.getDeclaredConstructors(); //获取所有的构造方法
       //test.getMethod(name, parameterTypes);//获取public方法
          //test.getDeclaredMethod(name, parameterTypes);//获取所有方法
            int x=demo.add(5,8);
            System.out.println(x);
            Field file=test.getDeclaredField("name");
            System.out.println(file.getName());
            file.setAccessible(true); //暴力获取私有变量权限
            file.set(demo, "shenxuebing");
            System.out.println(demo.getPubNmae());

            /*Constructor constructor=test.getConstructor(); //只能访问public构造方法
            System.out.println(constructor.getName());*/
            Constructor constructor2=test.getDeclaredConstructor(String.class); //都能访问 public private构造方法
            Demo demo2=(Demo) constructor2.newInstance("laowangba");
            System.out.println(demo2.getPubNmae());

            Method method=test.getDeclaredMethod("add",int.class,int.class); //获取方法
            /*Method method=test.getMethod("add",int.class,int.class); //获取方法
            method.setAccessible(true);  //获取访问私有权限 */
            int i =(int) method.invoke(demo, 2,3);//调用demo.add() 方法
            System.out.println(i);
        //  @SuppressWarnings() //去掉黄线警告
            Class returntype=method.getReturnType();//获取方法返回类型
            System.out.println(returntype.getName()); 
            Test test2=method.getAnnotation(Test.class);
            //输出Test方法注解内容
            System.out.println(test2.vlaue());
            System.out.println(test2.desc());


        } catch (Exception e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

}

package fansheDemo;

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

import javax.lang.model.element.Element;

/**
***********************************
*
*@类名    Test
*@时间    2017年6月9日下午3:30:58
*@作者    沈雪冰
*@描述    
*
***********************************
*/
@Target(ElementType.METHOD) //目标一个类的作用域 field 成员变量上，METHOD是作用在方法上
@Retention(RetentionPolicy.RUNTIME) //运行的时候也能拿到注解 class是在编译成字节码文件的时候就不行了 ； 
//source 在java源码生效，runtime 基本都是用这个 运行的时候也能拿到注解
@Inherited //子类继承方法的时候要不要继承注解

public @interface Test {
     
    //描述自定义注解的注解 叫做元注解

    public String vlaue();
    public String desc()   default" 这是一个描述";



}

注解具体功能代码链接：

http://www.cnblogs.com/peida/archive/2013/04/24/3036689.html