ReflectionUtil (vjkit 1.0.8 API)

java.lang.Object
- com.vip.vjtools.vjkit.reflect.ReflectionUtil

```
public class ReflectionUtil
extends Object
```
反射工具类. 所有反射均无视modifier的范围限制，同时将反射的Checked异常转为UnChecked异常。需要平衡性能较差的一次性调用，以及高性能的基于预先获取的Method/Filed对象反复调用两种用法 1. 获取方法与属性 (兼容了原始类型/接口/抽象类的参数, 并默认将方法与属性设为可访问) 2. 方法调用. 3. 构造函数.

Constructor Summary

Constructors
Constructor and Description

ReflectionUtil()

Constructors
Constructor and Description
`ReflectionUtil()`

Method Summary

Methods
Modifier and Type	Method and Description
`static RuntimeException`	`convertReflectionExceptionToUnchecked(Exception e)` 将反射时的checked exception转换为unchecked exception.
`static Method`	`getAccessibleMethodByName(Class clazz, String methodName)` 循环向上转型, 获取对象的DeclaredMethod,并强制设置为可访问.
`static Field`	`getField(Class clazz, String fieldName)` 循环向上转型, 获取对象的DeclaredField, 并强制设置为可访问.
`static <T> T`	`getFieldValue(Object obj, Field field)` 使用已获取的Field, 直接读取对象属性值, 不经过getter函数.
`static <T> T`	`getFieldValue(Object obj, String fieldName)` 直接读取对象属性值, 无视private/protected修饰符, 不经过getter函数.
`static Method`	`getGetterMethod(Class<?> clazz, String propertyName)` 循环遍历，按属性名获取前缀为get或is的函数，并设为可访问
`static Method`	`getMethod(Class<?> clazz, String methodName, Class<?>... parameterTypes)` 循环向上转型, 获取对象的DeclaredMethod, 并强制设置为可访问.
`static <T> T`	`getProperty(Object obj, String propertyName)` 先尝试用Getter函数读取, 如果不存在则直接读取变量.
`static Method`	`getSetterMethod(Class<?> clazz, String propertyName, Class<?> parameterType)` 循环遍历，按属性名获取前缀为set的函数，并设为可访问
`static <T> T`	`invokeConstructor(Class<T> cls, Object... args)` 调用构造函数.
`static <T> T`	`invokeGetter(Object obj, String propertyName)` 调用Getter方法, 无视private/protected修饰符.
`static <T> T`	`invokeMethod(Object obj, Method method, Object... args)` 调用预先获取的Method，用于反复调用的场景
`static <T> T`	`invokeMethod(Object obj, String methodName, Object... args)` 反射调用对象方法, 无视private/protected修饰符.
`static <T> T`	`invokeMethod(Object obj, String methodName, Object[] args, Class<?>[] parameterTypes)` 反射调用对象方法, 无视private/protected修饰符.
`static <T> T`	`invokeMethodByName(Object obj, String methodName, Object[] args)` 反射调用对象方法, 无视private/protected修饰符只匹配函数名，如果有多个同名函数调用第一个.
`static void`	`invokeSetter(Object obj, String propertyName, Object value)` 调用Setter方法, 无视private/protected修饰符, 按传入value的类型匹配函数.
`static void`	`makeAccessible(Field field)` 改变private/protected的成员变量为可访问，尽量不进行改变，避免JDK的SecurityManager抱怨。
`static void`	`makeAccessible(Method method)` 改变private/protected的方法为可访问，尽量不进行改变，避免JDK的SecurityManager抱怨。
`static void`	`setField(Object obj, Field field, Object value)` 使用预先获取的Field, 直接读取对象属性值, 不经过setter函数.
`static void`	`setFieldValue(Object obj, String fieldName, Object value)` 直接设置对象属性值, 无视private/protected修饰符, 不经过setter函数.
`static void`	`setProperty(Object obj, String propertyName, Object value)` 先尝试用Setter函数写入, 如果不存在则直接写入变量, 按传入value的类型匹配函数.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ReflectionUtil
```
public ReflectionUtil()
```
- Method Detail
  - getSetterMethod
```
public static Method getSetterMethod(Class<?> clazz,
                     String propertyName,
                     Class<?> parameterType)
```
    循环遍历，按属性名获取前缀为set的函数，并设为可访问
  - getGetterMethod
```
public static Method getGetterMethod(Class<?> clazz,
                     String propertyName)
```
    循环遍历，按属性名获取前缀为get或is的函数，并设为可访问
  - getMethod
```
public static Method getMethod(Class<?> clazz,
               String methodName,
               Class<?>... parameterTypes)
```
    循环向上转型, 获取对象的DeclaredMethod, 并强制设置为可访问. 如向上转型到Object仍无法找到, 返回null. 匹配函数名+参数类型. 方法需要被多次调用时，先使用本函数先取得Method，然后调用Method.invoke(Object obj, Object... args) 因为getMethod() 不能获取父类的private函数, 因此采用循环向上的getDeclaredMethod();
  - getAccessibleMethodByName
```
public static Method getAccessibleMethodByName(Class clazz,
                               String methodName)
```
    循环向上转型, 获取对象的DeclaredMethod,并强制设置为可访问. 如向上转型到Object仍无法找到, 返回null. 只匹配函数名, 如果有多个同名函数返回第一个方法需要被多次调用时，先使用本函数先取得Method，然后调用Method.invoke(Object obj, Object... args) 因为getMethod() 不能获取父类的private函数, 因此采用循环向上的getDeclaredMethods()
  - getField
```
public static Field getField(Class clazz,
             String fieldName)
```
    循环向上转型, 获取对象的DeclaredField, 并强制设置为可访问. 如向上转型到Object仍无法找到, 返回null. 因为getFiled()不能获取父类的private属性, 因此采用循环向上的getDeclaredField();
  - invokeGetter
```
public static <T> T invokeGetter(Object obj,
                 String propertyName)
```
    调用Getter方法, 无视private/protected修饰符. 性能较差, 用于单次调用的场景
  - invokeSetter
```
public static void invokeSetter(Object obj,
                String propertyName,
                Object value)
```
    调用Setter方法, 无视private/protected修饰符, 按传入value的类型匹配函数. 性能较差, 用于单次调用的场景
  - getFieldValue
```
public static <T> T getFieldValue(Object obj,
                  String fieldName)
```
    直接读取对象属性值, 无视private/protected修饰符, 不经过getter函数. 性能较差, 用于单次调用的场景
  - getFieldValue
```
public static <T> T getFieldValue(Object obj,
                  Field field)
```
    使用已获取的Field, 直接读取对象属性值, 不经过getter函数. 用于反复调用的场景.
  - setFieldValue
```
public static void setFieldValue(Object obj,
                 String fieldName,
                 Object value)
```
    直接设置对象属性值, 无视private/protected修饰符, 不经过setter函数. 性能较差, 用于单次调用的场景
  - setField
```
public static void setField(Object obj,
            Field field,
            Object value)
```
    使用预先获取的Field, 直接读取对象属性值, 不经过setter函数. 用于反复调用的场景.
  - getProperty
```
public static <T> T getProperty(Object obj,
                String propertyName)
```
    先尝试用Getter函数读取, 如果不存在则直接读取变量. 性能较差, 用于单次调用的场景
  - setProperty
```
public static void setProperty(Object obj,
               String propertyName,
               Object value)
```
    先尝试用Setter函数写入, 如果不存在则直接写入变量, 按传入value的类型匹配函数. 性能较差, 用于单次调用的场景
  - invokeMethod
```
public static <T> T invokeMethod(Object obj,
                 String methodName,
                 Object... args)
```
    反射调用对象方法, 无视private/protected修饰符. 根据传入参数的实际类型进行匹配, 支持方法参数定义是接口，父类，原子类型等情况性能较差，仅用于单次调用.
  - invokeMethod
```
public static <T> T invokeMethod(Object obj,
                 String methodName,
                 Object[] args,
                 Class<?>[] parameterTypes)
```
    反射调用对象方法, 无视private/protected修饰符. 根据参数类型参数进行匹配, 支持方法参数定义是接口，父类，原子类型等情况性能较低，仅用于单次调用.
  - invokeMethodByName
```
public static <T> T invokeMethodByName(Object obj,
                       String methodName,
                       Object[] args)
```
    反射调用对象方法, 无视private/protected修饰符只匹配函数名，如果有多个同名函数调用第一个. 用于确信只有一个同名函数, 但参数类型不确定的情况. 性能较低，仅用于单次调用.
  - invokeMethod
```
public static <T> T invokeMethod(Object obj,
                 Method method,
                 Object... args)
```
    调用预先获取的Method，用于反复调用的场景
  - invokeConstructor
```
public static <T> T invokeConstructor(Class<T> cls,
                      Object... args)
```
    调用构造函数.
  - makeAccessible
```
public static void makeAccessible(Method method)
```
    改变private/protected的方法为可访问，尽量不进行改变，避免JDK的SecurityManager抱怨。
  - makeAccessible
```
public static void makeAccessible(Field field)
```
    改变private/protected的成员变量为可访问，尽量不进行改变，避免JDK的SecurityManager抱怨。
  - convertReflectionExceptionToUnchecked
```
public static RuntimeException convertReflectionExceptionToUnchecked(Exception e)
```
    将反射时的checked exception转换为unchecked exception.

Class ReflectionUtil

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ReflectionUtil

Method Detail

getSetterMethod

getGetterMethod

getMethod

getAccessibleMethodByName

getField

invokeGetter

invokeSetter

getFieldValue

getFieldValue

setFieldValue

setField

getProperty

setProperty

invokeMethod

invokeMethod

invokeMethodByName

invokeMethod

invokeConstructor

makeAccessible

makeAccessible

convertReflectionExceptionToUnchecked