blade.kit

类 ReflectKit

java.lang.Object

blade.kit.ReflectKit

public abstract class ReflectKit
extends Object

有关 Reflection 处理的工具类。

这个类中的每个方法都可以“安全”地处理 null ，而不会抛出 NullPointerException。

从以下版本开始:

1.0

作者:

biezhi

构造器概要

构造器

构造器和说明
ReflectKit()

方法概要

限定符和类型	方法和说明
static <T> T	cast(Object value, Class<T> type) 类型转换
static <T,A extends Annotation> List<A>	findAllMethodAnnotation(Class<T> clazz, Class<A> annotationType) 获取clazz下所有Method带指定Annotation的 Annotation集合，这句话说的不太好，还是看英文名清楚 如果 clazz或annotationType为null ，则返还 null
static void	forceAccess(AccessibleObject object)
static Field[]	getAccessibleFields(Class<?> clazz)
static Field[]	getAccessibleFields(Class<?> clazz, Class<?> limit)
static Method[]	getAccessibleMethods(Class<?> clazz)
static Method[]	getAccessibleMethods(Class<?> clazz, Class<?> limit)
static Field[]	getAllFieldsOfClass(Class<?> clazz) 获取类及父类的所有Field，不包括Object的 Field 如果clazz为null，返回null
static Field[]	getAllFieldsOfClass(Class<?> clazz, boolean accessible) 获取类及父类的所有Field，不包括Object的 Field
static Field[]	getAllFieldsOfClass(Object object) 获取对象的所有Field，不包括Object的 Field 如果object为null，返回null
static Field[]	getAllFieldsOfClass(Object object, boolean accessible) 获取对象的所有Field，不包括Object的 Field* 如果object为null，返回null
static Field[]	getAllInstanceFields(Class<?> clazz) 获取类及父类的所有非静态Field，不包括Object的 Field 如果clazz为null，返回null
static Field[]	getAllInstanceFields(Class<?> clazz, boolean accessible) 获取类及父类的所有非静态Field，不包括Object的 Field
static Field[]	getAllInstanceFields(Object object) 获取对象的所有非静态Field，不包括Object的 Field 如果object为null，返回null
static Field[]	getAllInstanceFields(Object object, boolean accessible) 获取对象的所有非静态Field，不包括Object的 Field 如果object为null，返回null
static Method[]	getAllInstanceMethods(Class<?> clazz) 获取类的所有实例Method，不包括java.lang.Object的 Method 如果clazz为null，返回null
static Method[]	getAllInstanceMethods(Class<?> clazz, boolean accessible) 获取类的所有实例Method，不包括java.lang.Object的 Method 如果clazz为null，返回null
static Method[]	getAllMethodsOfClass(Class<?> clazz) 获取类的所有Method，不包括java.lang.Object的 Method 如果clazz为null，返回null
static Method[]	getAllMethodsOfClass(Class<?> clazz, boolean accessible) 获取类的所有Method，不包括java.lang.Object的 Method 如果clazz为null，返回null
static Field[]	getAnnotationFields(Class<?> clazz, Class<? extends Annotation> annotationClass) 获取所有包含指定Annotation的Field数组
static <T,A extends Annotation> List<Method>	getAnnotationMethods(Class<T> clazz, Class<A> annotationType) 获取clazz下所有带指定Annotation的Method集合。
static Class<?>	getComponentType(Class<?> clazz)
static Class<?>	getComponentType(Class<?> clazz, int index)
static Class<?>	getComponentType(Type type) 获取type的泛型 ，如果type有多个泛型，那么将返回最后一个 如果type不是泛型，则返还null
static Class<?>	getComponentType(Type type, Class<?> implClass)
static Class<?>	getComponentTypeRecursion(Class<?> clazz)
static Class<?>	getComponentTypeRecursion(Class<?> clazz, int index)
static Class<?>[]	getComponentTypes(Class<?> clazz)
static Class<?>[]	getComponentTypes(Type type)
static Class<?>[]	getComponentTypes(Type type, Class<?> implClass) 获取type的第index个泛型 ，如果index超长， 那么将返回最后一个 如果是数组类型，则忽略index 如果type不是泛型，则返还null 如下均为组合类型： MyClass[] List<MyClass> Foo<?
static Class<?>[]	getComponentTypesRecursion(Class<?> clazz)
static Field	getField(Class<?> clazz, String fieldName) 根据对象的Field名返回Field
static Field	getField(Class<?> clazz, String fieldName, boolean accessible) 根据对象的Field名返回Field
static Field	getField(Object object, String fieldName) 根据对象的Field名返回Field
static Field	getField(Object object, String fieldName, boolean accessible) 根据对象的Field名返回Field
static Field	getFieldOfClass(Class<?> clazz, String fieldName) 已过时。
static Field	getFieldOfClass(Object object, String fieldName) 已过时。
static Field	getFieldOfClass(Object object, String fieldName, boolean accessible) 已过时。
static Class<?>	getGenericSuperType(Class<?> type)
static Class<?>[]	getGenericSuperTypes(Class<?> type)
static Field[]	getInstanceFields(Class<?> clazz, String[] includes)
static Method	getMethod(Class<?> clazz, String methodName, Class<?>... parameterTypes)
static Method	getMethod(Object object, String methodName, Class<?>... parameterTypes)
static Method	getMethodByName(Object classOrBean, String methodName) 查找方法
static Object	getProperty(Object bean, String name) 用getter获取bean属性
static Class<?>	getRawType(Type type)
static Class<?>	getRawType(Type type, Class<?> implClass)
static <A extends Annotation> boolean	hasAnnotation(Field field, Class<A> annotationType)
static <A extends Annotation> boolean	hasAnnotation(Method method, Class<A> annotationType)
static boolean	hasSuperClass(Class<?> clazz) 判断是否有超类
static Object	invokeMehod(Object bean, Method method, Object... args)
static Object	invokeMehodByName(Object bean, String methodName, Object... args)
static Object	invokeMethod(Method method, Object target, Object... args) 方法调用，如果clazz为null，返回null； 如果method为null，返回null 如果target为null，则为静态方法
static Object	invokeMethod(Object object, String methodName, Object[] args, Class<?>... parameterTypes) 调用一个命名的方法，其参数类型相匹配的对象类型。
static Object	invokeStaticMethod(Class<?> clazz, String methodName, Object[] args, Class<?>... parameterTypes) 调用一个命名的静态方法，其参数类型相匹配的对象类型。
static boolean	is(Object obj, Object... mybe) 对象是否其中一个
static boolean	isAccessible(Member m)
static boolean	isFinal(Field field)
static boolean	isNot(Object obj, Object... mybe)
static boolean	isPublic(Member m)
static Object	newInstance(Class<?> clazz) 创建一个实例对象
static Object	newInstance(String className) 新建对象
static boolean	notWriter(Field field) Field是否不用改写
static <T> T	readField(Field field, Object target) 读取Field的值
static Object	readField(String fieldName, Object target) 读取Field的值
static Object	readStaticField(Class<?> clazz, String fieldName) 读取静态Field的值
static Object	readStaticField(Field field) 读取静态Field的值
static Type	resolveVariable(TypeVariable<?> variable, Class<?> implClass)
static List<String>	scanPackageClass(String rootPackageName) 扫描包下面所有的类
static void	setProperty(Object bean, String name, Object value) 用setter设置bean属性
static void	writeField(Field field, Object target, Object value) 写入Field的值
static void	writeField(Object target, String fieldName, Object value) 写入Field的值
static void	writeStaticField(Class<?> clazz, String fieldName, Object value) 写入Field的值
static void	writeStaticField(Field field, Object value) 写入Field的值

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

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

构造器详细资料

ReflectKit

public ReflectKit()

方法详细资料

newInstance

public static Object newInstance(String className)

新建对象

newInstance

public static Object newInstance(Class<?> clazz)

创建一个实例对象

参数:

clazz - class对象

返回:

setProperty

public static void setProperty(Object bean,
                               String name,
                               Object value)

用setter设置bean属性

getProperty

public static Object getProperty(Object bean,
                                 String name)

用getter获取bean属性

cast

public static <T> T cast(Object value,
                         Class<T> type)

类型转换

getMethodByName

public static Method getMethodByName(Object classOrBean,
                                     String methodName)

查找方法

invokeMehodByName

public static Object invokeMehodByName(Object bean,
                                       String methodName,
                                       Object... args)

参数:

bean - 类实例

methodName - 方法名称

args - 方法参数

返回:

invokeMehod

public static Object invokeMehod(Object bean,
                                 Method method,
                                 Object... args)

参数:

bean - 类实例

methodName - 方法名称

args - 方法参数

返回:

is

public static boolean is(Object obj,
                         Object... mybe)

对象是否其中一个

isNot

public static boolean isNot(Object obj,
                            Object... mybe)

scanPackageClass

public static List<String> scanPackageClass(String rootPackageName)

扫描包下面所有的类

getAllMethodsOfClass

public static Method[] getAllMethodsOfClass(Class<?> clazz)

获取类的所有Method，不包括java.lang.Object的 Method

如果clazz为null，返回null

参数:

clazz - 要获取的类

返回:

Method数组

getAllMethodsOfClass

public static Method[] getAllMethodsOfClass(Class<?> clazz,
                                            boolean accessible)

获取类的所有Method，不包括java.lang.Object的 Method

如果clazz为null，返回null

参数:

clazz - 要获取的类

accessible - 是否允许访问

返回:

Method数组

getAllInstanceMethods

public static Method[] getAllInstanceMethods(Class<?> clazz)

获取类的所有实例Method，不包括java.lang.Object的 Method

如果clazz为null，返回null

参数:

clazz - 要获取的类

返回:

Method数组

getAllInstanceMethods

public static Method[] getAllInstanceMethods(Class<?> clazz,
                                             boolean accessible)

获取类的所有实例Method，不包括java.lang.Object的 Method

如果clazz为null，返回null

参数:

clazz - 要获取的类

accessible - 是否允许访问

返回:

Method数组

findAllMethodAnnotation

public static <T,A extends Annotation> List<A> findAllMethodAnnotation(Class<T> clazz,
                                                                       Class<A> annotationType)

获取clazz下所有Method带指定Annotation的 Annotation集合，这句话说的不太好，还是看英文名清楚

如果 clazz或annotationType为null ，则返还 null

参数:

clazz - 要获取的类

annotationType - 指定的Annotation

返回:

code>clazz下所有Method带指定Annotation 的 Annotation集合

getAnnotationMethods

public static <T,A extends Annotation> List<Method> getAnnotationMethods(Class<T> clazz,
                                                                         Class<A> annotationType)

获取clazz下所有带指定Annotation的Method集合。

如果 clazz或annotationType为null ，则返还 null

参数:

clazz - 要获取的类

annotationType - 指定的Annotation

返回:

clazz下所有带指定Annotation的 Method集合

invokeMethod

public static Object invokeMethod(Method method,
                                  Object target,
                                  Object... args)

方法调用，如果clazz为null，返回null；

如果method为null，返回null

如果target为null，则为静态方法

参数:

method - 调用的方法

target - 目标对象

args - 方法的参数值

返回:

调用结果

invokeMethod

public static Object invokeMethod(Object object,
                                  String methodName,
                                  Object[] args,
                                  Class<?>... parameterTypes)

调用一个命名的方法，其参数类型相匹配的对象类型。

参数:

object - 调用方法作用的对象

methodName - 方法名

args - 参数值

parameterTypes - 参数类型

返回:

调用的方法的返回值

invokeStaticMethod

public static Object invokeStaticMethod(Class<?> clazz,
                                        String methodName,
                                        Object[] args,
                                        Class<?>... parameterTypes)

调用一个命名的静态方法，其参数类型相匹配的对象类型。

参数:

clazz - 调用方法作用的类

methodName - 方法名

args - 参数值

parameterTypes - 参数类型

返回:

调用的方法的返回值

getMethod

public static Method getMethod(Class<?> clazz,
                               String methodName,
                               Class<?>... parameterTypes)

getMethod

public static Method getMethod(Object object,
                               String methodName,
                               Class<?>... parameterTypes)

getAccessibleMethods

public static Method[] getAccessibleMethods(Class<?> clazz)

getAccessibleMethods

public static Method[] getAccessibleMethods(Class<?> clazz,
                                            Class<?> limit)

hasAnnotation

public static <A extends Annotation> boolean hasAnnotation(Method method,
                                                           Class<A> annotationType)

getAllFieldsOfClass

public static Field[] getAllFieldsOfClass(Class<?> clazz)

获取类及父类的所有Field，不包括Object的 Field

如果clazz为null，返回null

参数:

clazz - 要获取的类

返回:

Field数组

getAllInstanceFields

public static Field[] getAllInstanceFields(Class<?> clazz)

获取类及父类的所有非静态Field，不包括Object的 Field

如果clazz为null，返回null

参数:

clazz - 要获取的类

返回:

Field数组

getAllFieldsOfClass

public static Field[] getAllFieldsOfClass(Class<?> clazz,
                                          boolean accessible)

获取类及父类的所有Field，不包括Object的 Field

参数:

clazz - 要获取的类

accessible - 设置访问权限

返回:

Field数组

getAllFieldsOfClass

public static Field[] getAllFieldsOfClass(Object object)

获取对象的所有Field，不包括Object的 Field

如果object为null，返回null

参数:

object - 要获取的对象

返回:

Field数组

getAllFieldsOfClass

public static Field[] getAllFieldsOfClass(Object object,
                                          boolean accessible)

获取对象的所有Field，不包括Object的 Field*

如果object为null，返回null

参数:

object - 要获取的对象

accessible - 设置访问权限

返回:

Field数组

getAllInstanceFields

public static Field[] getAllInstanceFields(Class<?> clazz,
                                           boolean accessible)

获取类及父类的所有非静态Field，不包括Object的 Field

参数:

clazz - 要获取的类

accessible - 设置访问权限

返回:

Field数组

getAllInstanceFields

public static Field[] getAllInstanceFields(Object object)

获取对象的所有非静态Field，不包括Object的 Field

如果object为null，返回null

参数:

object - 要获取的对象

返回:

Field数组

getAllInstanceFields

public static Field[] getAllInstanceFields(Object object,
                                           boolean accessible)

获取对象的所有非静态Field，不包括Object的 Field

如果object为null，返回null

参数:

object - 要获取的对象

accessible - 设置访问权限

返回:

Field数组

getInstanceFields

public static Field[] getInstanceFields(Class<?> clazz,
                                        String[] includes)

getAnnotationFields

public static Field[] getAnnotationFields(Class<?> clazz,
                                          Class<? extends Annotation> annotationClass)

获取所有包含指定Annotation的Field数组

参数:

clazz - 查找类

annotationClass - 注解类名

返回:

Field数组

getField

public static Field getField(Object object,
                             String fieldName)

根据对象的Field名返回Field

参数:

object - 要获取的对象

fieldName - Field名

返回:

Field

getField

public static Field getField(Class<?> clazz,
                             String fieldName)

根据对象的Field名返回Field

参数:

clazz - 要获取的类

fieldName - Field名

返回:

Field

getFieldOfClass

@Deprecated
public static Field getFieldOfClass(Object object,
                                                 String fieldName)

已过时。

此方法存在性能问题 FIXME，replace with getField(Object, String)

根据对象的Field名返回Field

参数:

object - 要获取的对象

fieldName - Field名

返回:

Field

getField

public static Field getField(Object object,
                             String fieldName,
                             boolean accessible)

根据对象的Field名返回Field

参数:

object - 要获取的对象

fieldName - Field名

accessible - 设置访问权限

返回:

Field

getField

public static Field getField(Class<?> clazz,
                             String fieldName,
                             boolean accessible)

根据对象的Field名返回Field

参数:

clazz - 要获取的类

fieldName - Field名

accessible - 设置访问权限

返回:

Field

getFieldOfClass

@Deprecated
public static Field getFieldOfClass(Class<?> clazz,
                                                 String fieldName)

已过时。

此方法存在性能问题 FIXME，replace with getField(Class, String)

根据对象的Field名返回Field

参数:

clazz - 要获取的类

fieldName - Field名

返回:

Field

getFieldOfClass

@Deprecated
public static Field getFieldOfClass(Object object,
                                                 String fieldName,
                                                 boolean accessible)

已过时。

此方法存在性能问题 FIXME，replace with getField(Object, String, boolean)

根据对象的Field名返回Field

参数:

object - 要获取的对象

fieldName - Field名

accessible - 设置访问权限

返回:

Field

getAccessibleFields

public static Field[] getAccessibleFields(Class<?> clazz)

getAccessibleFields

public static Field[] getAccessibleFields(Class<?> clazz,
                                          Class<?> limit)

readField

public static <T> T readField(Field field,
                              Object target)

读取Field的值

参数:

field - 目标Field

target - 目标对象

返回:

Field值

readField

public static Object readField(String fieldName,
                               Object target)

读取Field的值

参数:

fieldName - 目标Field名

target - 目标对象

返回:

Field值

writeField

public static void writeField(Field field,
                              Object target,
                              Object value)

写入Field的值

参数:

field - 目标Field

target - 目标对象

value - 写入的值

writeField

public static void writeField(Object target,
                              String fieldName,
                              Object value)

写入Field的值

参数:

target - 目标对象

fieldName - 目标Field名

value - 写入的值

readStaticField

public static Object readStaticField(Field field)

读取静态Field的值

参数:

field - 目标Field名

返回:

Field值

readStaticField

public static Object readStaticField(Class<?> clazz,
                                     String fieldName)

读取静态Field的值

参数:

clazz - 目标Class名

返回:

fieldName Field名

抛出:

FieldException

writeStaticField

public static void writeStaticField(Field field,
                                    Object value)

写入Field的值

参数:

field - 目标Field

value - 写入的值

抛出:

FieldException

writeStaticField

public static void writeStaticField(Class<?> clazz,
                                    String fieldName,
                                    Object value)

写入Field的值

参数:

clazz - 目标Class

value - 写入的值

抛出:

FieldException

notWriter

public static boolean notWriter(Field field)

Field是否不用改写

参数:

field - 目标Field

返回:

如果是则返回true，否则返回false

isFinal

public static boolean isFinal(Field field)

hasSuperClass

public static boolean hasSuperClass(Class<?> clazz)

判断是否有超类

参数:

clazz - 目标类

返回:

如果有返回true，否则返回false

hasAnnotation

public static <A extends Annotation> boolean hasAnnotation(Field field,
                                                           Class<A> annotationType)

getComponentType

public static Class<?> getComponentType(Class<?> clazz)

getComponentType

public static Class<?> getComponentType(Class<?> clazz,
                                        int index)

getComponentTypes

public static Class<?>[] getComponentTypes(Class<?> clazz)

getComponentTypesRecursion

public static Class<?>[] getComponentTypesRecursion(Class<?> clazz)

getComponentTypeRecursion

public static Class<?> getComponentTypeRecursion(Class<?> clazz)

getComponentTypeRecursion

public static Class<?> getComponentTypeRecursion(Class<?> clazz,
                                                 int index)

getComponentType

public static Class<?> getComponentType(Type type)

获取type的泛型 ，如果type有多个泛型，那么将返回最后一个

如果type不是泛型，则返还null

参数:

type - 给定类型 @see Type

返回:

获取type的泛型

getComponentType

public static Class<?> getComponentType(Type type,
                                        Class<?> implClass)

getComponentTypes

public static Class<?>[] getComponentTypes(Type type)

getComponentTypes

public static Class<?>[] getComponentTypes(Type type,
                                           Class<?> implClass)

获取type的第index个泛型 ，如果index超长， 那么将返回最后一个

如果是数组类型，则忽略index

如果type不是泛型，则返还null

如下均为组合类型：

• MyClass[]
• List<MyClass>
• Foo<? extends MyClass>
• Bar<? super MyClass>
• <T extends MyClass> T[]

参数:

type - 给定类型 @see Type

index - 泛型的索引位

返回:

获取type的第index个泛型

getGenericSuperTypes

public static Class<?>[] getGenericSuperTypes(Class<?> type)

getGenericSuperType

public static Class<?> getGenericSuperType(Class<?> type)

getRawType

public static Class<?> getRawType(Type type)

getRawType

public static Class<?> getRawType(Type type,
                                  Class<?> implClass)

resolveVariable

public static Type resolveVariable(TypeVariable<?> variable,
                                   Class<?> implClass)

isAccessible

public static boolean isAccessible(Member m)

isPublic

public static boolean isPublic(Member m)

forceAccess

public static void forceAccess(AccessibleObject object)