cn.webfuse.framework.core.kit.reflect

类 ReflectionKits

java.lang.Object

cn.webfuse.framework.core.kit.reflect.ReflectionKits

public class ReflectionKits
extends Object

反射工具类.

copy from vipshop VJTools(com.vip.vjtools.vjkit.reflect.ReflectionUtil) and made some changes.

构造器概要

构造器

构造器和说明
ReflectionKits()

方法概要

限定符和类型	方法和说明
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的类型匹配函数.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ReflectionKits

public ReflectionKits()

方法详细资料

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.