Class ReflectUtil

java.lang.Object
com.sure.tool.util.ReflectUtil

public class ReflectUtil extends Object
反射工具类,参考 Hutool 的 ReflectUtil 设计。

English: Reflection helpers for fields, methods and constructors with null-safe lookups.

Since:
0.1.0
Author:
suretool
  • Method Details

    • getField

      public static Field getField(Class<?> clazz, String fieldName)
      获取类或父类中的字段(自动设置可访问)。
      Parameters:
      clazz - 类
      fieldName - 字段名
      Returns:
      字段,不存在返回 null
    • getFieldValue

      public static Object getFieldValue(Object obj, String fieldName)
      获取对象字段值(支持静态字段,对象传 null)。
      Parameters:
      obj - 对象,静态字段传 null
      fieldName - 字段名
      Returns:
      字段值
    • setFieldValue

      public static void setFieldValue(Object obj, String fieldName, Object value)
      设置对象字段值(支持静态字段,对象传 null)。
      Parameters:
      obj - 对象,静态字段传 null
      fieldName - 字段名
      value - 字段值
    • getFields

      public static Field[] getFields(Class<?> clazz)
      获取类及其父类的全部字段。
      Parameters:
      clazz - 类
      Returns:
      字段数组
    • getMethods

      public static Method[] getMethods(Class<?> clazz)
      获取类的全部公共方法(含继承)。
      Parameters:
      clazz - 类
      Returns:
      方法数组
    • getMethod

      public static Method getMethod(Class<?> clazz, String methodName, Class<?>... paramTypes)
      获取指定方法。
      Parameters:
      clazz - 类
      methodName - 方法名
      paramTypes - 参数类型
      Returns:
      方法,不存在返回 null
    • invoke

      public static Object invoke(Object obj, String methodName, Object... args)
      调用对象方法。
      Parameters:
      obj - 对象
      methodName - 方法名
      args - 参数
      Returns:
      方法返回值,无返回值返回 null
    • invokeStatic

      public static Object invokeStatic(Class<?> clazz, String methodName, Object... args)
      调用静态方法。
      Parameters:
      clazz - 类
      methodName - 方法名
      args - 参数
      Returns:
      方法返回值
    • invokeConstructor

      public static <T> T invokeConstructor(Class<T> clazz, Object... params)
      实例化对象。
      Type Parameters:
      T - 类型
      Parameters:
      clazz - 类
      params - 构造参数
      Returns:
      实例
    • getClassByName

      public static Class<?> getClassByName(String className)
      按类名获取 Class,支持基础类型(如 int、boolean)与包装类型映射。
      Parameters:
      className - 类名(如 "com.sure.tool.util.StrUtil"、"int"、"Integer"、"[I")
      Returns:
      Class
      Throws:
      IllegalArgumentException - 类不存在
    • getMethodByName

      public static Method getMethodByName(Class<?> clazz, String methodName)
      按方法名获取方法(含继承链,参数不限)。
      Parameters:
      clazz - 类
      methodName - 方法名
      Returns:
      方法,不存在返回 null
    • getTypeArguments

      public static Map<String,Class<?>> getTypeArguments(Class<?> clazz)
      解析类泛型父类的类型参数(TypeVariable → 实际 Class)。
      Parameters:
      clazz - 类
      Returns:
      泛型参数名到实际类的映射;无泛型父类返回空 Map
    • getFieldMap

      public static Map<String,Field> getFieldMap(Class<?> clazz)
      获取类及其父类的全部字段(含继承),字段名 → 字段。
      Parameters:
      clazz - 类
      Returns:
      字段 Map
    • hasField

      public static boolean hasField(Class<?> clazz, String fieldName)
      判断类(含父类)是否存在指定字段。
      Parameters:
      clazz - 类
      fieldName - 字段名
      Returns:
      是否存在
    • hasField

      public static boolean hasField(Class<?> clazz, String fieldName, boolean ignoreCase)
      判断类(含父类)是否存在指定字段。
      Parameters:
      clazz - 类
      fieldName - 字段名
      ignoreCase - 是否忽略大小写
      Returns:
      是否存在
    • invoke

      public static Object invoke(Object obj, String methodName, Class<?>[] paramTypes, Object... args)
      调用对象方法(显式指定参数类型,用于重载精确匹配)。
      Parameters:
      obj - 对象
      methodName - 方法名
      paramTypes - 参数类型
      args - 参数
      Returns:
      方法返回值
    • setAccessible

      public static Field setAccessible(Field field)
      设置字段可访问并返回原字段。
      Parameters:
      field - 字段
      Returns:
      原字段