ReflectUtil (AJAXJS-Base 1.2.6 API)

java.lang.Object
- com.ajaxjs.util.ReflectUtil

```
public class ReflectUtil
extends Object
```
反射工具包

作者:

sp42 frank@ajaxjs.com

构造器概要

构造器
构造器和说明

ReflectUtil()

构造器
构造器和说明
`ReflectUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static Class<?>[]`	`args2class(Object[] args)` 把参数转换为类对象列表
`static Object`	`executeMethod_Throwable(Object instance, Method method, Object... args)` 调用方法
`static Object`	`executeMethod(Object instance, Method method, Object... args)` 调用方法，该方法不会抛出异常
`static Object`	`executeMethod(Object instnace, String method, Class<?> argType, Object argValue)` 调用方法。
`static Object`	`executeMethod(Object instnace, String method, Object... args)` 调用方法
`static Object`	`executeStaticMethod(Method method, Object... args)` 执行静态方法
`static String`	`firstLetterUpper(String str)` 将第一个字母大写
`static Class<?>`	`getClassByInterface(Type type)` 已知接口类型，获取它的 class
`static Class<?>`	`getClassByName(String clzName)` 根据类名字符串获取类对象
`static <T> Class<T>`	`getClassByName(String clzName, Class<T> clz)` 根据类名字符串获取类对象，可强类型转换类型
`static Map<String,Integer>`	`getConstantsInt(Class<?> clz)`
`static <T> Constructor<T>`	`getConstructor(Class<T> clz, Class<?>... argClz)` 获取类的构造器，可以支持重载的构造器（不同参数的构造器）
`static Class<?>[]`	`getDeclaredInterface(Class<?> clz)` 获取某个类的所有接口
`static Method`	`getDeclaredMethodByInterface(Class<?> clz, String method, Object arg)` 循环 object 向上转型（接口）
`static String`	`getFieldName(String method, String action)` 根据方法名称来截取属性名称，例如把 getter 的 getXxx() 转换为 xxx 的字段名
`static Method`	`getMethod(Object obj, String method, Class<?>... args)` 根据类、方法的字符串和参数列表获取方法对象，支持重载的方法
`static Method`	`getMethod(Object obj, String method, Object... args)` 根据方法名称和参数列表查找方法。
`static Method`	`getMethodByUpCastingSearch(Class<?> clz, String method, Object arg)` 根据方法名称和参数列表查找方法。
`static Method`	`getSuperClassDeclaredMethod(Class<?> clz, String method)` 查找对象父类身上指定的方法（注意该方法不需要校验参数类型是否匹配，故有可能不是目标方法，而造成异常，请谨慎使用）
`static Method`	`getSuperClassDeclaredMethod(Class<?> clz, String method, Class<?> argClz)` 查找对象父类身上指定的方法
`static Throwable`	`getUnderLayerErr(Throwable e)` 获取实际抛出的那个异常对象。
`static String`	`getUnderLayerErrMsg(Throwable e)` 获取实际抛出的那个异常对象，并去掉前面的包名。
`static boolean`	`hasArgsCon(Class<?> clz)` 传入的类是否有带参数的构造器
`static boolean`	`isStaticMethod(Method method)` 是否静态方法
`static <T> T`	`newInstance(Class<T> clz, Object... args)` 根据类创建实例，可传入构造器参数。
`static <T> T`	`newInstance(Constructor<T> constructor, Object... args)` 根据构造器创建实例
`static Object`	`newInstance(String clzName, Object... args)` 根据类全称创建实例
`static void`	`setProperty(Object bean, String name, Object value)` 调用 bean 对象的 setter 方法

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - ReflectUtil
```
public ReflectUtil()
```
- 方法详细资料
  - newInstance
```
public static <T> T newInstance(Class<T> clz,
                                Object... args)
```
    根据类创建实例，可传入构造器参数。
    
    参数:
    
    clz - 类对象
    
    args - 获取指定参数类型的构造函数，这里传入我们想调用的构造函数所需的参数。可以不传。
    
    返回:
    
    对象实例
  - newInstance
```
public static <T> T newInstance(Constructor<T> constructor,
                                Object... args)
```
    根据构造器创建实例
    
    参数:
    
    constructor - 类构造器
    
    args - 获取指定参数类型的构造函数，这里传入我们想调用的构造函数所需的参数。可以不传。
    
    返回:
    
    对象实例
  - hasArgsCon
```
public static boolean hasArgsCon(Class<?> clz)
```
    传入的类是否有带参数的构造器
    
    参数:
    
    clz - 类对象
    
    返回:
    
    true 表示为有带参数
  - newInstance
```
public static Object newInstance(String clzName,
                                 Object... args)
```
    根据类全称创建实例
    
    参数:
    
    clzName - 类全称
    
    args - 根据构造函数，创建指定类型的对象,传入的参数个数需要与上面传入的参数类型个数一致
    
    返回:
    
    对象实例，因为传入的类全称是字符串，无法创建泛型 T，所以统一返回 Object
  - getConstructor
```
public static <T> Constructor<T> getConstructor(Class<T> clz,
                                                Class<?>... argClz)
```
    获取类的构造器，可以支持重载的构造器（不同参数的构造器）
    
    参数:
    
    clz - 类对象
    
    argClz - 指定构造函数的参数类型，这里传入我们想调用的构造函数所需的参数类型
    
    返回:
    
    类的构造器
  - getClassByName
```
public static Class<?> getClassByName(String clzName)
```
    根据类名字符串获取类对象
    
    参数:
    
    clzName - 类全称。如果是内部类请注意用法
    
    返回:
    
    类对象
  - getClassByName
```
public static <T> Class<T> getClassByName(String clzName,
                                          Class<T> clz)
```
    根据类名字符串获取类对象，可强类型转换类型
    
    参数:
    
    clzName - 类全称
    
    clz - 要转换的目标类型
    
    返回:
    
    类对象
  - args2class
```
public static Class<?>[] args2class(Object[] args)
```
    把参数转换为类对象列表
    
    参数:
    
    args - 可变参数列表
    
    返回:
    
    类对象列表
  - getClassByInterface
```
public static Class<?> getClassByInterface(Type type)
```
    已知接口类型，获取它的 class
    
    参数:
    
    type - 接口类型
    
    返回:
    
    接口的类对象
  - getDeclaredInterface
```
public static Class<?>[] getDeclaredInterface(Class<?> clz)
```
    获取某个类的所有接口
    
    参数:
    
    clz - 目标类
    
    返回:
    
    类的所有接口
  - getMethod
```
public static Method getMethod(Object obj,
                               String method,
                               Class<?>... args)
```
    根据类、方法的字符串和参数列表获取方法对象，支持重载的方法
    
    参数:
    
    obj - 可以是实例对象，也可以是类对象
    
    method - 方法名称
    
    args - 明确的参数类型列表
    
    返回:
    
    匹配的方法对象，null 表示找不到
  - getMethod
```
public static Method getMethod(Object obj,
                               String method,
                               Object... args)
```
    根据方法名称和参数列表查找方法。注意参数对象类型由于没有向上转型会造成不匹配而找不到方法，这时应使用上一个方法或 getMethodByUpCastingSearch()
    
    参数:
    
    obj - 实例对象
    
    method - 方法名称
    
    args - 对应重载方法的参数列表
    
    返回:
    
    匹配的方法对象，null 表示找不到
  - getMethodByUpCastingSearch
```
public static Method getMethodByUpCastingSearch(Class<?> clz,
                                                String method,
                                                Object arg)
```
    根据方法名称和参数列表查找方法。自动循环参数类型向上转型。仅支持一个参数。
    
    参数:
    
    clz - 实例对象的类对象
    
    method - 方法名称
    
    arg - 参数对象，可能是子类或接口，所以要在这里找到对应的方法，当前只支持单个参数；且不能传 Class，必须为对象
    
    返回:
    
    匹配的方法对象，null 表示找不到
  - getDeclaredMethodByInterface
```
public static Method getDeclaredMethodByInterface(Class<?> clz,
                                                  String method,
                                                  Object arg)
```
    循环 object 向上转型（接口）
    
    参数:
    
    clz - 主类
    
    method - 方法名称
    
    arg - 参数对象，可能是子类或接口，所以要在这里找到对应的方法，当前只支持单个参数
    
    返回:
    
    方法对象
  - getSuperClassDeclaredMethod
```
public static Method getSuperClassDeclaredMethod(Class<?> clz,
                                                 String method,
                                                 Class<?> argClz)
```
    查找对象父类身上指定的方法
    
    参数:
    
    clz - 主类
    
    method - 方法名称
    
    argClz - 参数类引用
    
    返回:
    
    匹配的方法对象，null 表示找不到
  - getSuperClassDeclaredMethod
```
public static Method getSuperClassDeclaredMethod(Class<?> clz,
                                                 String method)
```
    查找对象父类身上指定的方法（注意该方法不需要校验参数类型是否匹配，故有可能不是目标方法，而造成异常，请谨慎使用）
    
    参数:
    
    clz - 主类
    
    method - 方法名称
    
    返回:
    
    匹配的方法对象，null 表示找不到
  - executeMethod_Throwable
```
public static Object executeMethod_Throwable(Object instance,
                                             Method method,
                                             Object... args)
                                      throws Throwable
```
    调用方法
    
    参数:
    
    instance - 对象实例，bean
    
    method - 方法对象
    
    args - 参数列表
    
    返回:
    
    执行结果
    
    抛出:
    
    Throwable
  - getUnderLayerErr
```
public static Throwable getUnderLayerErr(Throwable e)
```
    获取实际抛出的那个异常对象。 InvocationTargetException 太过于宽泛，在 trouble shouting的时候，不能给人非常直观的信息 AOP 的缘故，不能直接捕获原来的异常，要不断 e.getCause()....
    
    参数:
    
    e - 异常对象
    
    返回:
    
    实际异常对象
  - getUnderLayerErrMsg
```
public static String getUnderLayerErrMsg(Throwable e)
```
    获取实际抛出的那个异常对象，并去掉前面的包名。
    
    参数:
    
    e - 异常对象
    
    返回:
    
    实际异常对象信息
  - executeMethod
```
public static Object executeMethod(Object instance,
                                   Method method,
                                   Object... args)
```
    调用方法，该方法不会抛出异常
    
    参数:
    
    instance - 对象实例，bean
    
    method - 方法对象
    
    args - 参数列表
    
    返回:
    
    执行结果
  - executeMethod
```
public static Object executeMethod(Object instnace,
                                   String method,
                                   Object... args)
```
    调用方法
    
    参数:
    
    instnace - 对象实例，bean
    
    method - 方法对象名称
    
    args - 参数列表
    
    返回:
    
    执行结果
  - executeMethod
```
public static Object executeMethod(Object instnace,
                                   String method,
                                   Class<?> argType,
                                   Object argValue)
```
    调用方法。注意获取方法对象，原始类型和包装类型不能混用，否则得不到正确的方法，例如 Integer 不能与 int 混用。这里提供一个 argType 的参数，指明参数类型为何。
    
    参数:
    
    instnace - 对象实例
    
    method - 方法名称
    
    argType - 参数类型
    
    argValue - 参数值
    
    返回:
    
    执行结果
  - executeStaticMethod
```
public static Object executeStaticMethod(Method method,
                                         Object... args)
```
    执行静态方法
    
    参数:
    
    method - 方法对象
    
    args - 方法参数列表
    
    返回:
    
    执行结果
  - isStaticMethod
```
public static boolean isStaticMethod(Method method)
```
    是否静态方法
    
    参数:
    
    method - 方法对象
    
    返回:
    
    true 表示为静态方法
  - firstLetterUpper
```
public static String firstLetterUpper(String str)
```
    将第一个字母大写
    
    参数:
    
    str - 字符串
    
    返回:
    
    字符串
  - getFieldName
```
public static String getFieldName(String method,
                                  String action)
```
    根据方法名称来截取属性名称，例如把 getter 的 getXxx() 转换为 xxx 的字段名
    
    参数:
    
    method - 方法名称
    
    action - set|get
    
    返回:
    
    属性名称
  - setProperty
```
public static void setProperty(Object bean,
                               String name,
                               Object value)
```
    调用 bean 对象的 setter 方法
    
    参数:
    
    bean - Bean 对象
    
    name - 属性名称，前缀不要带 set
    
    value - 要设置的属性值
  - getConstantsInt
```
public static Map<String,Integer> getConstantsInt(Class<?> clz)
```
    参数:
    
    clz -
    
    返回:

类 ReflectUtil

构造器概要

方法概要

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

构造器详细资料

ReflectUtil

方法详细资料

newInstance

newInstance

hasArgsCon

newInstance

getConstructor

getClassByName

getClassByName

args2class

getClassByInterface

getDeclaredInterface

getMethod

getMethod

getMethodByUpCastingSearch

getDeclaredMethodByInterface

getSuperClassDeclaredMethod

getSuperClassDeclaredMethod

executeMethod_Throwable

getUnderLayerErr

getUnderLayerErrMsg

executeMethod

executeMethod

executeMethod

executeStaticMethod

isStaticMethod

firstLetterUpper

getFieldName

setProperty

getConstantsInt