程序包 com.walker.infrastructure.utils

类 ReflectionUtils

java.lang.Object
com.walker.infrastructure.utils.ReflectionUtils
public abstract class ReflectionUtils extends Object
Simple utility class for working with the reflection API and handling reflection exceptions.

Only intended for internal use.

从以下版本开始:
1.2.2
作者:
Juergen Hoeller, Rob Harrop, Rod Johnson, Costin Leau, Sam Brannen

  • 字段详细资料

    • COPYABLE_FIELDS

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

    • NON_BRIDGED_METHODS

      public static ReflectionUtils.MethodFilter NON_BRIDGED_METHODS
      Pre-built MethodFilter that matches all non-bridge methods.

    • USER_DECLARED_METHODS

      public static ReflectionUtils.MethodFilter USER_DECLARED_METHODS
      Pre-built MethodFilter that matches all non-bridge methods which are not declared on java.lang.Object.

  • 构造器详细资料

    • ReflectionUtils

      public ReflectionUtils()

  • 方法详细资料

    • 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

    • 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

    • findMethod

      public static Method findMethod(Class<?> clazz, String name)
      Attempt to find a Method on the supplied class with the supplied name and no parameters. Searches all superclasses up to Object.

      Returns null if no Method can be found.

      参数:
      clazz - the class to introspect
      name - the name of the method
      返回:
      the Method object, or null if none found

    • findMethod

      public static Method findMethod(Class<?> clazz, String name, Class<?>... paramTypes)
      Attempt to find a Method on the supplied class with the supplied name and parameter types. Searches all superclasses up to Object.

      Returns null if no Method can be found.

      参数:
      clazz - the class to introspect
      name - the name of the method
      paramTypes - the parameter types of the method (may be null to indicate any signature)
      返回:
      the Method object, or null if none found

    • invokeMethod

      public static Object invokeMethod(Method method, Object target)
      Invoke the specified Method against the supplied target object with no arguments. The target object can be null when invoking a static Method.

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

      参数:
      method - the method to invoke
      target - the target object to invoke the method on
      返回:
      the invocation result, if any
      另请参阅:

    • invokeMethod

      public static Object invokeMethod(Method method, Object target, Object... args)
      Invoke the specified Method against the supplied target object with the supplied arguments. The target object can be null when invoking a static Method.

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

      参数:
      method - the method to invoke
      target - the target object to invoke the method on
      args - the invocation arguments (may be null)
      返回:
      the invocation result, if any

    • invokeJdbcMethod

      public static Object invokeJdbcMethod(Method method, Object target) throws SQLException
      Invoke the specified JDBC API Method against the supplied target object with no arguments.
      参数:
      method - the method to invoke
      target - the target object to invoke the method on
      返回:
      the invocation result, if any
      抛出:
      SQLException - the JDBC API SQLException to rethrow (if any)
      另请参阅:

    • invokeJdbcMethod

      public static Object invokeJdbcMethod(Method method, Object target, Object... args) throws SQLException
      Invoke the specified JDBC API Method against the supplied target object with the supplied arguments.
      参数:
      method - the method to invoke
      target - the target object to invoke the method on
      args - the invocation arguments (may be null)
      返回:
      the invocation result, if any
      抛出:
      SQLException - the JDBC API SQLException to rethrow (if any)
      另请参阅:

    • handleReflectionException

      public static void handleReflectionException(Exception ex)
      Handle the given reflection exception. Should only be called if no checked exception is expected to be thrown by the target method.

      Throws the underlying RuntimeException or Error in case of an InvocationTargetException with such a root cause. Throws an IllegalStateException with an appropriate message else.

      参数:
      ex - the reflection exception to handle

    • handleInvocationTargetException

      public static void handleInvocationTargetException(InvocationTargetException ex)
      Handle the given invocation target exception. Should only be called if no checked exception is expected to be thrown by the target method.

      Throws the underlying RuntimeException or Error in case of such a root cause. Throws an IllegalStateException else.

      参数:
      ex - the invocation target exception to handle

    • rethrowRuntimeException

      public static void rethrowRuntimeException(Throwable ex)
      Rethrow the given exception, which is presumably the target exception of an InvocationTargetException. Should only be called if no checked exception is expected to be thrown by the target method.

      Rethrows the underlying exception cast to an RuntimeException or Error if appropriate; otherwise, throws an IllegalStateException.

      参数:
      ex - the exception to rethrow
      抛出:
      RuntimeException - the rethrown exception

    • rethrowException

      public static void rethrowException(Throwable ex) throws Exception
      Rethrow the given exception, which is presumably the target exception of an InvocationTargetException. Should only be called if no checked exception is expected to be thrown by the target method.

      Rethrows the underlying exception cast to an Exception or Error if appropriate; otherwise, throws an IllegalStateException.

      参数:
      ex - the exception to rethrow
      抛出:
      Exception - the rethrown exception (in case of a checked exception)

    • declaresException

      public static boolean declaresException(Method method, Class<?> exceptionType)
      Determine whether the given method explicitly declares the given exception or one of its superclasses, which means that an exception of that type can be propagated as-is within a reflective invocation.
      参数:
      method - the declaring method
      exceptionType - the exception to throw
      返回:
      true if the exception can be thrown as-is; false if it needs to be wrapped

    • isPublicStaticFinal

      public static boolean isPublicStaticFinal(Field field)
      Determine whether the given field is a "public static final" constant.
      参数:
      field - the field to check

    • isEqualsMethod

      public static boolean isEqualsMethod(Method method)
      Determine whether the given method is an "equals" method.
      另请参阅:

    • isHashCodeMethod

      public static boolean isHashCodeMethod(Method method)
      Determine whether the given method is a "hashCode" method.
      另请参阅:

    • isToStringMethod

      public static boolean isToStringMethod(Method method)
      Determine whether the given method is a "toString" method.
      另请参阅:

    • 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
      另请参阅:

    • 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
      另请参阅:

    • 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
      另请参阅:

    • doWithMethods

      public static void doWithMethods(Class<?> clazz, ReflectionUtils.MethodCallback mc) throws IllegalArgumentException
      Perform the given callback operation on all matching methods of the given class and superclasses.

      The same named method occurring on subclass and superclass will appear twice, unless excluded by a ReflectionUtils.MethodFilter.

      参数:
      clazz - class to start looking at
      mc - the callback to invoke for each method
      抛出:
      IllegalArgumentException
      另请参阅:

    • doWithMethods

      public static void doWithMethods(Class<?> clazz, ReflectionUtils.MethodCallback mc, ReflectionUtils.MethodFilter mf) throws IllegalArgumentException
      Perform the given callback operation on all matching methods of the given class and superclasses (or given interface and super-interfaces).

      The same named method occurring on subclass and superclass will appear twice, unless excluded by the specified ReflectionUtils.MethodFilter.

      参数:
      clazz - class to start looking at
      mc - the callback to invoke for each method
      mf - the filter that determines the methods to apply the callback to
      抛出:
      IllegalArgumentException

    • getAllDeclaredMethods

      public static Method[] getAllDeclaredMethods(Class<?> leafClass) throws IllegalArgumentException
      Get all declared methods on the leaf class and all superclasses. Leaf class methods are included first.
      抛出:
      IllegalArgumentException

    • doWithFields

      public static void doWithFields(Class<?> clazz, ReflectionUtils.FieldCallback fc) throws IllegalArgumentException
      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
      抛出:
      IllegalArgumentException

    • doWithFields

      public static void doWithFields(Class<?> clazz, ReflectionUtils.FieldCallback fc, ReflectionUtils.FieldFilter ff) throws IllegalArgumentException
      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
      抛出:
      IllegalArgumentException

    • shallowCopyFieldState

      public static void shallowCopyFieldState(Object src, Object dest) throws IllegalArgumentException
      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