com.cottsoft.framework.util

类 ReflectUtil

java.lang.Object

com.cottsoft.framework.util.ReflectUtil

public class ReflectUtil
extends Object

从以下版本开始:

JDK1.7 java.lang.reflect utilities.

版本:

v1.0.0

作者:

Simon.Hoo

字段概要

字段

限定符和类型	字段和说明
static String	METHOD_GET_PREFIX
static String	METHOD_IS_PREFIX
static String	METHOD_SET_PREFIX
static Object[]	NO_ARGUMENTS an empty object array
static Class[]	NO_PARAMETERS an empty class array
static Type[]	NO_TYPES an empty object array

构造器概要

构造器

构造器和说明
ReflectUtil()

方法概要

方法

限定符和类型	方法和说明
static boolean	compareDeclarations(Method first, Method second) Compares method declarations: signature and return types.
static boolean	compareParameters(Class[] first, Class[] second) Compares method or ctor parameters.
static boolean	compareSignatures(Constructor<?> first, Constructor<?> second) Compares constructor signatures: names and parameters.
static boolean	compareSignatures(Field first, Field second)
static boolean	compareSignatures(Method first, Method second) Compares method signatures: names and parameters.
static Method	findDeclaredMethod(Class<?> c, String methodName)
static Method	findMethod(Class<?> c, String methodName) Returns method from an object, matched by name.
static void	forceAccess(AccessibleObject accObject) Suppress access check against a reflection object.
static Field[]	getAccessibleFields(Class<?> clazz)
static Field[]	getAccessibleFields(Class<?> clazz, Class<Object> limit)
static Method[]	getAccessibleMethods(Class<?> clazz) Returns array of all methods that are accessible from given class.
static Method[]	getAccessibleMethods(Class<?> clazz, Class<Object> limit) Returns array of all methods that are accessible from given class, upto limit (usually Object.class).
static String	getBeanPropertyGetterName(Method method) Returns beans property getter name or null if method is not a real getter.
static String	getBeanPropertySetterName(Method method) Returns beans property setter name or null if method is not a real setter.
static Class[]	getClasses(Object... objects) Returns classes from array of specified objects.
static Class<?>	getComponentType(Type type) Returns component type of the given type.
static Class<?>	getComponentType(Type type, int index) Returns the component type of the given type.
static Class<?>	getGenericSupertype(Class<?> type)
static Class<?>	getGenericSupertype(Class<?> type, int index)
static Method	getMethod0(Class<?> c, String name, Class<?>... parameterTypes) Invokes private Class.getMethod0() without throwing NoSuchMethodException.
static Class[]	getSuperclasses(Class<?> type) Returns all superclasses.
static Field[]	getSupportedFields(Class<?> clazz)
static Field[]	getSupportedFields(Class<?> clazz, Class<Object> limit)
static Method[]	getSupportedMethods(Class<?> clazz)
static Method[]	getSupportedMethods(Class<?> clazz, Class<Object> limit) Returns a Method array of the methods to which instances of the specified respond except for those methods defined in the class specified by limit or any of its superclasses.
static Object	invoke(Class<?> c, Object obj, String method, Class[] paramClasses, Object[] params) Invokes accessible method of an object.
static Object	invoke(Class<?> c, Object obj, String method, Object[] params)
static Object	invoke(Object obj, String method, Class[] paramClasses, Object[] params) Invokes accessible method of an object.
static Object	invoke(Object obj, String method, Object[] params) Invokes accessible method of an object without specifying parameter types.
static Object	invokeDeclared(Class<?> c, Object obj, String method, Class[] paramClasses, Object[] params) Invokes any method of a class, even private ones.
static Object	invokeDeclared(Class<?> c, Object obj, String method, Object[] params)
static Object	invokeDeclared(Object obj, String method, Class[] paramClasses, Object[] params) Invokes any method of a class suppressing java access checking.
static Object	invokeDeclared(Object obj, String method, Object[] params)
static boolean	isAssignableFrom(Member member1, Member member2) Returns true if the first member is accessible from second one.
static boolean	isBeanProperty(Method method) Returns true if method is a bean property.
static boolean	isBeanPropertyGetter(Method method) Returns true if method is bean getter.
static boolean	isBeanPropertySetter(Method method) Returns true if method is bean setter.
static boolean	isInstanceOf(Object o, Class<?> target) Dynamic version of instanceof.
static boolean	isInterfaceImpl(Class<?> thisClass, Class<?> targetInterface) Returns true if provided class is interface implementation.
static boolean	isObjectMethod(Method method) Returns true if method defined in Object class.
static boolean	isPublic(Class<?> c) Returns true if class is public.
static boolean	isPublic(Member member) Returns true if class member is public.
static boolean	isPublicPublic(Member member) Returns true if class member is public and if its declaring class is also public.
static boolean	isSubclass(Class<?> thisClass, Class<?> target) Determines if first class match the destination and simulates kind of instanceof.
static boolean	isUserDefinedMethod(Method method) Returns true if method is user defined and not defined in Object class.
static Object	newInstance(Class<?> type) Creates new instances including for common mutable classes that do not have a default constructor.
static Object	readAnnotationValue(Annotation annotation, String name) Reads annotation value.
static Class<?>	toClass(Type type) Returns Class for the given type.

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

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

字段详细资料

NO_PARAMETERS

public static final Class[] NO_PARAMETERS

an empty class array

NO_ARGUMENTS

public static final Object[] NO_ARGUMENTS

an empty object array

NO_TYPES

public static final Type[] NO_TYPES

an empty object array

METHOD_GET_PREFIX

public static final String METHOD_GET_PREFIX

另请参阅:

常量字段值

METHOD_IS_PREFIX

public static final String METHOD_IS_PREFIX

另请参阅:

常量字段值

METHOD_SET_PREFIX

public static final String METHOD_SET_PREFIX

另请参阅:

常量字段值

构造器详细资料

ReflectUtil

public ReflectUtil()

方法详细资料

getMethod0

public static Method getMethod0(Class<?> c,
                String name,
                Class<?>... parameterTypes)

Invokes private Class.getMethod0() without throwing NoSuchMethodException. Returns only public methods or null if method not found. Since no exception is throwing, it works faster.

参数:

c - class to inspect

name - name of method to find

parameterTypes - parameter types

返回:

founded method, or null

findMethod

public static Method findMethod(Class<?> c,
                String methodName)

Returns method from an object, matched by name. This may be considered as a slow operation, since methods are matched one by one. Returns only accessible methods. Only first method is matched.

参数:

c - class to examine

methodName - Full name of the method.

返回:

null if method not found

findDeclaredMethod

public static Method findDeclaredMethod(Class<?> c,
                        String methodName)

getClasses

public static Class[] getClasses(Object... objects)

Returns classes from array of specified objects.

invoke

public static Object invoke(Class<?> c,
            Object obj,
            String method,
            Class[] paramClasses,
            Object[] params)
                     throws IllegalAccessException,
                            NoSuchMethodException,
                            InvocationTargetException

Invokes accessible method of an object.

参数:

c - class that contains method

obj - object to execute

method - method to invoke

paramClasses - classes of parameters

params - parameters

抛出:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

invoke

public static Object invoke(Object obj,
            String method,
            Class[] paramClasses,
            Object[] params)
                     throws IllegalAccessException,
                            NoSuchMethodException,
                            InvocationTargetException

Invokes accessible method of an object.

参数:

obj - object

method - name of the objects method

params - method parameters

paramClasses - method parameter types

抛出:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

invoke

public static Object invoke(Object obj,
            String method,
            Object[] params)
                     throws IllegalAccessException,
                            NoSuchMethodException,
                            InvocationTargetException

Invokes accessible method of an object without specifying parameter types.

参数:

obj - object

method - method of an object

params - method parameters

抛出:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

invoke

public static Object invoke(Class<?> c,
            Object obj,
            String method,
            Object[] params)
                     throws IllegalAccessException,
                            NoSuchMethodException,
                            InvocationTargetException

抛出:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

invokeDeclared

public static Object invokeDeclared(Class<?> c,
                    Object obj,
                    String method,
                    Class[] paramClasses,
                    Object[] params)
                             throws IllegalAccessException,
                                    NoSuchMethodException,
                                    InvocationTargetException

Invokes any method of a class, even private ones.

参数:

c - class to examine

obj - object to inspect

method - method to invoke

paramClasses - parameter types

params - parameters

抛出:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

invokeDeclared

public static Object invokeDeclared(Object obj,
                    String method,
                    Class[] paramClasses,
                    Object[] params)
                             throws IllegalAccessException,
                                    NoSuchMethodException,
                                    InvocationTargetException

Invokes any method of a class suppressing java access checking.

参数:

obj - object to inspect

method - method to invoke

paramClasses - parameter types

params - parameters

抛出:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

invokeDeclared

public static Object invokeDeclared(Object obj,
                    String method,
                    Object[] params)
                             throws IllegalAccessException,
                                    NoSuchMethodException,
                                    InvocationTargetException

抛出:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

invokeDeclared

public static Object invokeDeclared(Class<?> c,
                    Object obj,
                    String method,
                    Object[] params)
                             throws IllegalAccessException,
                                    NoSuchMethodException,
                                    InvocationTargetException

抛出:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

isSubclass

public static boolean isSubclass(Class<?> thisClass,
                 Class<?> target)

Determines if first class match the destination and simulates kind of instanceof. All subclasses and interface of first class are examined against second class. Method is not symmetric.

isInterfaceImpl

public static boolean isInterfaceImpl(Class<?> thisClass,
                      Class<?> targetInterface)

Returns true if provided class is interface implementation.

isInstanceOf

public static boolean isInstanceOf(Object o,
                   Class<?> target)

Dynamic version of instanceof.

参数:

o - object to match

target - target class

返回:

true if object is an instance of target class

getAccessibleMethods

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

Returns array of all methods that are accessible from given class.

另请参阅:

getAccessibleMethods(Class, Class)

getAccessibleMethods

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

Returns array of all methods that are accessible from given class, upto limit (usually Object.class). Abstract methods are ignored.

getAccessibleFields

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

getAccessibleFields

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

getSupportedMethods

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

getSupportedMethods

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

Returns a Method array of the methods to which instances of the specified respond except for those methods defined in the class specified by limit or any of its superclasses. Note that limit is usually used to eliminate them methods defined by java.lang.Object. If limit is null then all methods are returned.

getSupportedFields

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

getSupportedFields

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

compareDeclarations

public static boolean compareDeclarations(Method first,
                          Method second)

Compares method declarations: signature and return types.

compareSignatures

public static boolean compareSignatures(Method first,
                        Method second)

Compares method signatures: names and parameters.

compareSignatures

public static boolean compareSignatures(Constructor<?> first,
                        Constructor<?> second)

Compares constructor signatures: names and parameters.

compareSignatures

public static boolean compareSignatures(Field first,
                        Field second)

compareParameters

public static boolean compareParameters(Class[] first,
                        Class[] second)

Compares method or ctor parameters.

forceAccess

public static void forceAccess(AccessibleObject accObject)

Suppress access check against a reflection object. SecurityException is silently ignored. Checks first if the object is already accessible.

isPublic

public static boolean isPublic(Member member)

Returns true if class member is public.

isPublicPublic

public static boolean isPublicPublic(Member member)

Returns true if class member is public and if its declaring class is also public.

isPublic

public static boolean isPublic(Class<?> c)

Returns true if class is public.

newInstance

public static Object newInstance(Class<?> type)
                          throws IllegalAccessException,
                                 InstantiationException

Creates new instances including for common mutable classes that do not have a default constructor. more user-friendly. It examines if class is a map, list, String, Character, Boolean or a Number. Immutable instances are cached and not created again. Arrays are also created with no elements. Note that this bunch of if blocks is faster then using a HashMap.

抛出:

IllegalAccessException

InstantiationException

isAssignableFrom

public static boolean isAssignableFrom(Member member1,
                       Member member2)

Returns true if the first member is accessible from second one.

getSuperclasses

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

Returns all superclasses.

isUserDefinedMethod

public static boolean isUserDefinedMethod(Method method)

Returns true if method is user defined and not defined in Object class.

isObjectMethod

public static boolean isObjectMethod(Method method)

Returns true if method defined in Object class.

isBeanProperty

public static boolean isBeanProperty(Method method)

Returns true if method is a bean property.

isBeanPropertyGetter

public static boolean isBeanPropertyGetter(Method method)

Returns true if method is bean getter.

getBeanPropertyGetterName

public static String getBeanPropertyGetterName(Method method)

Returns beans property getter name or null if method is not a real getter.

isBeanPropertySetter

public static boolean isBeanPropertySetter(Method method)

Returns true if method is bean setter.

getBeanPropertySetterName

public static String getBeanPropertySetterName(Method method)

Returns beans property setter name or null if method is not a real setter.

getComponentType

public static Class<?> getComponentType(Type type)

Returns component type of the given type. For ParameterizedType it returns the last type in array.

getComponentType

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

Returns the component type of the given type.
For example the following types all have the component-type MyClass:

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

参数:

type - is the type where to get the component type from.

返回:

the component type of the given type or null if the given type does NOT have a single (component) type.

getGenericSupertype

public static Class<?> getGenericSupertype(Class<?> type,
                           int index)

getGenericSupertype

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

toClass

public static Class<?> toClass(Type type)

Returns Class for the given type.
Examples:

type	getSimpleType(type)
String	String
List<String>	List
<T extends MyClass> T[]	MyClass[]

参数:

type - is the type to convert.

返回:

the closest class representing the given type.

readAnnotationValue

public static Object readAnnotationValue(Annotation annotation,
                         String name)

Reads annotation value. Returns null on error.