com.bstek.dorado.data.method

Class MethodAutoMatchingUtils

java.lang.Object

com.bstek.dorado.data.method.MethodAutoMatchingUtils

public abstract class MethodAutoMatchingUtils
extends java.lang.Object

用于辅助类方法自动匹配功能的工具类。

Since:

Jan 3, 2008

Author:

Benny Bao (mailto:benny.bao@bstek.com)

Constructor Summary

Constructors

Constructor and Description
MethodAutoMatchingUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.reflect.Method[]	getMethodsByName(java.lang.Class<?> cl, java.lang.String methodName) 返回给定的类中匹配某一方法名的所有方法。
static java.lang.String[]	getParameterNames(java.lang.reflect.Method method)
static java.lang.reflect.Type	getTypeForMatching(DataType dataType)
static java.lang.reflect.Type	getTypeForMatching(java.lang.Object object)
static int	indexOfTypes(java.lang.reflect.Type[] types, java.lang.reflect.Type type) 查找给定的Class类型在Class类型数组中的下标位置，如果未找到相容的类型则返回-1。 此处所指的相容是指Class类型数组中的某类型与要查找的Class类型相同，或是要查找的Class类型的父类型。
static java.lang.Object	invokeMethod(java.lang.reflect.Method[] methods, java.lang.Object object, java.lang.String[] requiredParameterNames, java.lang.Object[] requiredParameters, java.lang.String[] optionalParameterNames, java.lang.Object[] optionalParameters, java.lang.String[] extraParameterNames, java.lang.Object[] extraParameters) 在给定的一组方法中根据参数名查找一个匹配的方法，并调用该方法。 注意，此方法将忽略方法参数的顺序。
static java.lang.Object	invokeMethod(java.lang.reflect.Method[] methods, java.lang.Object object, java.lang.reflect.Type[] requiredParameterTypes, java.lang.Object[] requiredParameters, java.lang.reflect.Type[] exactParameterTypes, java.lang.Object[] exactParameters, java.lang.reflect.Type[] optionalParameterTypes, java.lang.Object[] optionalParameters, java.lang.reflect.Type returnType) 在给定的一组方法中根据方法名、方法参数类型和返回值类型查找一个匹配的方法，并调用该方法。
static boolean	isSimpleType(java.lang.reflect.Type type)

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodAutoMatchingUtils

public MethodAutoMatchingUtils()

Method Detail

indexOfTypes

public static int indexOfTypes(java.lang.reflect.Type[] types,
               java.lang.reflect.Type type)

查找给定的Class类型在Class类型数组中的下标位置，如果未找到相容的类型则返回-1。
此处所指的相容是指Class类型数组中的某类型与要查找的Class类型相同，或是要查找的Class类型的父类型。

Parameters:

types - Class类型数组。

type - 要查找的Class类型。

Returns:

下标位置。

getMethodsByName

public static java.lang.reflect.Method[] getMethodsByName(java.lang.Class<?> cl,
                                          java.lang.String methodName)

返回给定的类中匹配某一方法名的所有方法。

Parameters:

cl - 被查找的类。

methodName - 方法名。

Returns:

找到的方法。

isSimpleType

public static boolean isSimpleType(java.lang.reflect.Type type)

getParameterNames

public static java.lang.String[] getParameterNames(java.lang.reflect.Method method)
                                            throws java.lang.SecurityException,
                                                   java.lang.NoSuchMethodException

Throws:

java.lang.SecurityException

java.lang.NoSuchMethodException

invokeMethod

public static java.lang.Object invokeMethod(java.lang.reflect.Method[] methods,
                            java.lang.Object object,
                            java.lang.reflect.Type[] requiredParameterTypes,
                            java.lang.Object[] requiredParameters,
                            java.lang.reflect.Type[] exactParameterTypes,
                            java.lang.Object[] exactParameters,
                            java.lang.reflect.Type[] optionalParameterTypes,
                            java.lang.Object[] optionalParameters,
                            java.lang.reflect.Type returnType)
                                     throws MethodAutoMatchingException,
                                            java.lang.Exception

在给定的一组方法中根据方法名、方法参数类型和返回值类型查找一个匹配的方法，并调用该方法。

Parameters:

methods - 方法数组。

object - 方法的宿主对象。

requiredParameterTypes - 必须提供的方法参数类型。

requiredParameters - 必须的方法参数。

exactParameterTypes - 类型必须严格匹配的方法参数类型。

exactParameters - 类型必须严格匹配的方法参数。

optionalParameterTypes - 可选的方法参数类型。

optionalParameters - 可选的方法参数。

returnType - 返回值类型，如果为null则表示忽略对返回值类型的判断。

Returns:

方法执行后的返回值。

Throws:

MethodAutoMatchingException

java.lang.Exception

invokeMethod

public static java.lang.Object invokeMethod(java.lang.reflect.Method[] methods,
                            java.lang.Object object,
                            java.lang.String[] requiredParameterNames,
                            java.lang.Object[] requiredParameters,
                            java.lang.String[] optionalParameterNames,
                            java.lang.Object[] optionalParameters,
                            java.lang.String[] extraParameterNames,
                            java.lang.Object[] extraParameters)
                                     throws MethodAutoMatchingException,
                                            java.lang.Exception

在给定的一组方法中根据参数名查找一个匹配的方法，并调用该方法。
注意，此方法将忽略方法参数的顺序。

Parameters:

methods - 方法数组。

object - 方法的宿主对象。

requiredParameterNames - 必选参数名的数组。

requiredParameters - 必选参数的数组。

optionalParameterNames - 可选参数名的数组。

optionalParameters - 可选参数的数组。

Returns:

方法执行后的返回值。

Throws:

optionalParameterNames

java.lang.Exception

MethodAutoMatchingException

getTypeForMatching

public static java.lang.reflect.Type getTypeForMatching(java.lang.Object object)

getTypeForMatching

public static java.lang.reflect.Type getTypeForMatching(DataType dataType)