org.jretty.util

类 ReflectionUtils

java.lang.Object

org.jretty.util.ReflectionMethodUtils

org.jretty.util.ReflectionUtils

public class ReflectionUtils
extends ReflectionMethodUtils

Simple utility class for working with the reflection API and handling reflection exceptions.
{Java 反射API增强工具类}

从以下版本开始:

2014-6-01

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	ReflectionUtils.FieldCallback Callback interface invoked on each field in the hierarchy.
static interface	ReflectionUtils.FieldFilter Callback optionally used to filter fields to be operated on by a field callback.

从类继承的嵌套类/接口 org.jretty.util.ReflectionMethodUtils

ReflectionMethodUtils.MethodCallback, ReflectionMethodUtils.MethodFilter

字段概要

字段

限定符和类型	字段和说明
static ReflectionUtils.FieldFilter	COPYABLE_FIELDS Pre-built FieldFilter that matches all non-static, non-final fields.

从类继承的字段 org.jretty.util.ReflectionMethodUtils

NON_BRIDGED_METHODS, USER_DECLARED_METHODS

构造器概要

构造器

构造器和说明
ReflectionUtils()

方法概要

限定符和类型	方法和说明
static void	doWithFields(Class<?> clazz, ReflectionUtils.FieldCallback fc) Invoke the given callback on all fields in the target class, going up the class hierarchy to get all declared fields.
static void	doWithFields(Class<?> clazz, ReflectionUtils.FieldCallback fc, ReflectionUtils.FieldFilter ff) Invoke the given callback on all fields in the target class, going up the class hierarchy to get all declared fields.
static void	fieldCloneByInherit(Object parentSource, Object dest) Given the source object and the destination, which must be the same class or a subclass, copy all fields, including inherited fields.
static void	fieldCloneByName(Map<String,Object> sourceMap, Object target)
static void	fieldCloneByName(Object source, Object target) 两个对象属性的拷贝：将source对象的属性值，赋值给target对象对应的名字和类型相同的属性。
static Field	findField(Class<?> clazz, String name) Attempt to find a field on the supplied Class with the supplied name.
static Field	findField(Class<?> clazz, String name, Class<?> type) Attempt to find a field on the supplied Class with the supplied name and/or type.
static Map<String,Field>	getAllFields(Class<?> clazz) Get all fields.
static Map<String,Field>	getAllNonStaticFields(Class<?> clazz)
static Object	getField(Field field, Object target) Get the field represented by the supplied field object on the specified target object.
static boolean	isPublicStaticFinal(Field field) Determine whether the given field is a "public static final" constant.
static void	makeAccessible(Constructor<?> ctor) Make the given constructor accessible, explicitly setting it accessible if necessary.
static void	makeAccessible(Field field) Make the given field accessible, explicitly setting it accessible if necessary.
static void	makeAccessible(Method method) Make the given method accessible, explicitly setting it accessible if necessary.
static <T> T	newInstance(Class<T> clazz) a slient way to invoke the class.newInstance() method.
static void	setField(Field field, Object target, Object value) Set the field represented by the supplied field object on the specified target object to the specified value.
static Map<String,Object>	toMap(Object source)

从类继承的方法 org.jretty.util.ReflectionMethodUtils

declaresException, doWithMethods, doWithMethods, findMethod, getAllDeclaredMethods, getConstructor, getDeclaredConstructor, getDeclaredMethod, getMethod, getQualifiedMethodName, getStaticMethod, getUniqueDeclaredMethods, invokeConstructor, invokeConstructor, invokeMethod, invokeMethod, invokeMethod, invokeStaticMethod, invokeStaticMethod, isEqualsMethod, isHashCodeMethod, isObjectMethod, isToStringMethod

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

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

字段详细资料

COPYABLE_FIELDS

public static final ReflectionUtils.FieldFilter COPYABLE_FIELDS

Pre-built FieldFilter that matches all non-static, non-final fields.

构造器详细资料

ReflectionUtils

public ReflectionUtils()

方法详细资料

newInstance

public static <T> T newInstance(Class<T> clazz)

a slient way to invoke the class.newInstance() method.

setField

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

Set the field represented by the supplied field object on the specified target object to the specified value. In accordance with Field.set(Object, Object) semantics, the new value is automatically unwrapped if the underlying field has a primitive type.

Thrown exceptions are handled via a call to #handleReflectionException(Exception).

参数:

field - the field to set

target - the target object on which to set the field

value - the value to set; may be null

getField

public static Object getField(Field field,
                              Object target)

Get the field represented by the supplied field object on the specified target object. In accordance with Field.get(Object) semantics, the returned value is automatically wrapped if the underlying field has a primitive type.

Thrown exceptions are handled via a call to #handleReflectionException(Exception).

参数:

field - the field to get

target - the target object from which to get the field

返回:

the field's current value

isPublicStaticFinal

public static boolean isPublicStaticFinal(Field field)

Determine whether the given field is a "public static final" constant.

参数:

field - the field to check

makeAccessible

public static void makeAccessible(Field field)

Make the given field accessible, explicitly setting it accessible if necessary. The setAccessible(true) method is only called when actually necessary, to avoid unnecessary conflicts with a JVM SecurityManager (if active).

参数:

field - the field to make accessible

另请参阅:

AccessibleObject.setAccessible(java.lang.reflect.AccessibleObject[], boolean)

makeAccessible

public static void makeAccessible(Method method)

Make the given method accessible, explicitly setting it accessible if necessary. The setAccessible(true) method is only called when actually necessary, to avoid unnecessary conflicts with a JVM SecurityManager (if active).

参数:

method - the method to make accessible

另请参阅:

AccessibleObject.setAccessible(java.lang.reflect.AccessibleObject[], boolean)

makeAccessible

public static void makeAccessible(Constructor<?> ctor)

Make the given constructor accessible, explicitly setting it accessible if necessary. The setAccessible(true) method is only called when actually necessary, to avoid unnecessary conflicts with a JVM SecurityManager (if active).

参数:

ctor - the constructor to make accessible

另请参阅:

AccessibleObject.setAccessible(java.lang.reflect.AccessibleObject[], boolean)

fieldCloneByInherit

public static void fieldCloneByInherit(Object parentSource,
                                       Object dest)

Given the source object and the destination, which must be the same class or a subclass, copy all fields, including inherited fields. Designed to work on objects with public no-arg constructors.

抛出:

IllegalArgumentException - if the arguments are incompatible

fieldCloneByName

public static void fieldCloneByName(Object source,
                                    Object target)

两个对象属性的拷贝：将source对象的属性值，赋值给target对象对应的名字和类型相同的属性。
比如可以实现：父类转子类——将父类的属性值拷贝给子类。（当然，只需要属性名称和类型一致就行了，不需要继承关系）

支持数值类型 把小范围的值 赋值给 大范围的值，比如Float赋值给Double

参数:

source - 原始对象[orginal obj]

target - 目标对象[target obj]

fieldCloneByName

public static void fieldCloneByName(Map<String,Object> sourceMap,
                                    Object target)

toMap

public static Map<String,Object> toMap(Object source)

getAllNonStaticFields

public static Map<String,Field> getAllNonStaticFields(Class<?> clazz)

getAllFields

public static Map<String,Field> getAllFields(Class<?> clazz)

Get all fields. Searches all superclasses up to Object.

参数:

clazz - the class to introspect

返回:

the corresponding Field object's Map <Field name, Field object>

findField

public static Field findField(Class<?> clazz,
                              String name)

Attempt to find a field on the supplied Class with the supplied name. Searches all superclasses up to Object.

参数:

clazz - the class to introspect

name - the name of the field

返回:

the corresponding Field object, or null if not found

findField

public static Field findField(Class<?> clazz,
                              String name,
                              Class<?> type)

Attempt to find a field on the supplied Class with the supplied name and/or type. Searches all superclasses up to Object.

参数:

clazz - the class to introspect

name - the name of the field (may be null if type is specified)

type - the type of the field (may be null if name is specified)

返回:

the corresponding Field object, or null if not found

doWithFields

public static void doWithFields(Class<?> clazz,
                                ReflectionUtils.FieldCallback fc)

Invoke the given callback on all fields in the target class, going up the class hierarchy to get all declared fields.

参数:

clazz - the target class to analyze

fc - the callback to invoke for each field

doWithFields

public static void doWithFields(Class<?> clazz,
                                ReflectionUtils.FieldCallback fc,
                                ReflectionUtils.FieldFilter ff)

Invoke the given callback on all fields in the target class, going up the class hierarchy to get all declared fields.

参数:

clazz - the target class to analyze

fc - the callback to invoke for each field

ff - the filter that determines the fields to apply the callback to