ReflectionUtils (common-util 1.0.2-RELEASE API)

java.lang.Object
- cn.xuqiudong.common.util.reflect.ReflectionUtils

```
public class ReflectionUtils
extends Object
```
反射工具类. 提供调用getter/setter方法, 访问私有变量, 调用私有方法, 获取泛型类型Class, 被AOP过的真实类等工具函数.

构造器概要

构造器
构造器和说明

ReflectionUtils()

构造器
构造器和说明
`ReflectionUtils()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static Object`	`convert(Object object, Class<?> type)`
`static RuntimeException`	`convertReflectionExceptionToUnchecked(Exception e)` 将反射时的checked exception转换为unchecked exception.
`static Field`	`getAccessibleField(Object obj, String fieldName)` 循环向上转型, 获取对象的DeclaredField, 并强制设置为可访问.
`static Method`	`getAccessibleMethod(Object obj, String methodName, Class<?>... parameterTypes)` 循环向上转型, 获取对象的DeclaredMethod,并强制设置为可访问.
`static Method`	`getAccessibleMethodByName(Object obj, String methodName)` 循环向上转型, 获取对象的DeclaredMethod,并强制设置为可访问.
`static <T> Class<T>`	`getClassGenricType(Class clazz)` 通过反射, 获得Class定义中声明的泛型参数的类型, 注意泛型必须定义在父类处如无法找到, 返回Object.class.
`static Class`	`getClassGenricType(Class clazz, int index)` 通过反射, 获得Class定义中声明的父类的泛型参数的类型.
`static Object`	`getFieldValue(Object obj, String fieldName)` 直接读取对象属性值, 无视private/protected修饰符, 不经过getter函数.
`static Class<?>`	`getUserClass(Object instance)`
`static boolean`	`hasField(Object obj, String fieldName)` 判断某个对象是否拥有某个属性
`static Object`	`invokeGetter(Object obj, String propertyName)` 调用Getter方法.
`static Object`	`invokeMethod(Object obj, String methodName, Class<?>[] parameterTypes, Object[] args)` 直接调用对象方法, 无视private/protected修饰符.
`static Object`	`invokeMethodByName(Object obj, String methodName, Object[] args)` 直接调用对象方法, 无视private/protected修饰符，用于一次性调用的情况，否则应使用getAccessibleMethodByName()函数获得Method后反复调用.
`static void`	`invokeSetter(Object obj, String propertyName, Object value)` 调用Setter方法, 仅匹配方法名。
`static void`	`makeAccessible(Field field)` 改变private/protected的成员变量为public，尽量不调用实际改动的语句，避免JDK的SecurityManager抱怨。
`static void`	`makeAccessible(Method method)` 改变private/protected的方法为public，尽量不调用实际改动的语句，避免JDK的SecurityManager抱怨。
`static void`	`setFieldValue(Object obj, String fieldName, Object value)` 直接设置对象属性值, 无视private/protected修饰符, 不经过setter函数.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - ReflectionUtils
```
public ReflectionUtils()
```
- 方法详细资料
  - invokeGetter
```
public static Object invokeGetter(Object obj,
                                  String propertyName)
```
    调用Getter方法. 支持多级，如：对象名.对象名.方法
  - invokeSetter
```
public static void invokeSetter(Object obj,
                                String propertyName,
                                Object value)
```
    调用Setter方法, 仅匹配方法名。支持多级，如：对象名.对象名.方法
  - getFieldValue
```
public static Object getFieldValue(Object obj,
                                   String fieldName)
```
    直接读取对象属性值, 无视private/protected修饰符, 不经过getter函数.
  - setFieldValue
```
public static void setFieldValue(Object obj,
                                 String fieldName,
                                 Object value)
```
    直接设置对象属性值, 无视private/protected修饰符, 不经过setter函数.
  - convert
```
public static Object convert(Object object,
                             Class<?> type)
```
  - invokeMethod
```
public static Object invokeMethod(Object obj,
                                  String methodName,
                                  Class<?>[] parameterTypes,
                                  Object[] args)
```
    直接调用对象方法, 无视private/protected修饰符. 用于一次性调用的情况，否则应使用getAccessibleMethod()函数获得Method后反复调用. 同时匹配方法名+参数类型，
  - invokeMethodByName
```
public static Object invokeMethodByName(Object obj,
                                        String methodName,
                                        Object[] args)
```
    直接调用对象方法, 无视private/protected修饰符，用于一次性调用的情况，否则应使用getAccessibleMethodByName()函数获得Method后反复调用. 只匹配函数名，如果有多个同名函数调用第一个。
  - getAccessibleField
```
public static Field getAccessibleField(Object obj,
                                       String fieldName)
```
    循环向上转型, 获取对象的DeclaredField, 并强制设置为可访问.
    如向上转型到Object仍无法找到, 返回null.
  - getAccessibleMethod
```
public static Method getAccessibleMethod(Object obj,
                                         String methodName,
                                         Class<?>... parameterTypes)
```
    循环向上转型, 获取对象的DeclaredMethod,并强制设置为可访问. 如向上转型到Object仍无法找到, 返回null. 匹配函数名+参数类型。
    用于方法需要被多次调用的情况. 先使用本函数先取得Method,然后调用Method.invoke(Object obj, Object... args)
  - getAccessibleMethodByName
```
public static Method getAccessibleMethodByName(Object obj,
                                               String methodName)
```
    循环向上转型, 获取对象的DeclaredMethod,并强制设置为可访问. 如向上转型到Object仍无法找到, 返回null. 只匹配函数名。
    用于方法需要被多次调用的情况. 先使用本函数先取得Method,然后调用Method.invoke(Object obj, Object... args)
  - makeAccessible
```
public static void makeAccessible(Method method)
```
    改变private/protected的方法为public，尽量不调用实际改动的语句，避免JDK的SecurityManager抱怨。
  - makeAccessible
```
public static void makeAccessible(Field field)
```
    改变private/protected的成员变量为public，尽量不调用实际改动的语句，避免JDK的SecurityManager抱怨。
  - getClassGenricType
```
public static <T> Class<T> getClassGenricType(Class clazz)
```
    通过反射, 获得Class定义中声明的泛型参数的类型, 注意泛型必须定义在父类处如无法找到, 返回Object.class. eg. public UserDao extends HibernateDao
    
    参数:
    
    clazz - The class to introspect
    
    返回:
    
    the first generic declaration, or Object.class if cannot be determined
  - getClassGenricType
```
public static Class getClassGenricType(Class clazz,
                                       int index)
```
    通过反射, 获得Class定义中声明的父类的泛型参数的类型. 如无法找到, 返回Object.class.
    如public UserDao extends HibernateDao
    
    参数:
    
    clazz - clazz The class to introspect
    
    index - the Index of the generic ddeclaration,start from 0.
    
    返回:
    
    the index generic declaration, or Object.class if cannot be determined
  - getUserClass
```
public static Class<?> getUserClass(Object instance)
```
  - convertReflectionExceptionToUnchecked
```
public static RuntimeException convertReflectionExceptionToUnchecked(Exception e)
```
    将反射时的checked exception转换为unchecked exception.
  - hasField
```
public static boolean hasField(Object obj,
                               String fieldName)
```
    判断某个对象是否拥有某个属性
    
    参数:
    
    obj - 对象
    
    fieldName - 属性名
    
    返回:
    
    有属性返回true 无属性返回false

类 ReflectionUtils

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

ReflectionUtils

方法详细资料

invokeGetter

invokeSetter

getFieldValue

setFieldValue

convert

invokeMethod

invokeMethodByName

getAccessibleField

getAccessibleMethod

getAccessibleMethodByName

makeAccessible

makeAccessible

getClassGenricType

getClassGenricType

getUserClass

convertReflectionExceptionToUnchecked

hasField