Package io.microsphere.reflect

Class ReflectionUtils

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String SUN_REFLECT_REFLECTION_CLASS_NAME
      Sun JDK implementation class: full name of sun.reflect.Reflection

    • Constructor Summary

      Constructors 
      Constructor Description
      ReflectionUtils()  

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static void assertArrayIndex​(java.lang.Object array, int index)
      Assert array index
      static void assertArrayType​(java.lang.Object array)
      Assert the object is array or not
      static void assertFieldMatchType​(java.lang.Object object, java.lang.String fieldName, java.lang.Class<?> expectedType)
      Assert Field type match
      static <T> java.util.Set<java.lang.Class<T>> findHierarchicalTypes​(java.lang.Class<?> sourceClass, java.lang.Class<T> matchType)
      Find the hierarchical types from the source class by specified type.
      static java.util.Set<java.lang.reflect.ParameterizedType> findParameterizedTypes​(java.lang.Class<?> sourceClass)
      Find the Set of ParameterizedType
      static java.lang.Class<?> getCallerClass()
      Get caller class
      static java.lang.Class<?> getCallerClass​(int invocationFrame)
      Get the caller class
      static java.lang.String getCallerClassName()
      Get Caller class
      static <T> T getProperty​(java.lang.Object bean, java.lang.String methodName)
      Get the value from the specified bean and its getter method.
      static boolean isSupportedSunReflectReflection()
      Is supported sun.reflect.Reflection or not
      static java.util.Map<java.lang.String,​java.lang.Object> readFieldsAsMap​(java.lang.Object object)
      Read fields value as Map
      static java.lang.Class[] resolveTypes​(java.lang.Object... values)
      Resolve the types of the specified values
      static <T> java.util.List<T> toList​(java.lang.Object array)
      Convert Array object to List

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • SUN_REFLECT_REFLECTION_CLASS_NAME

        public static final java.lang.String SUN_REFLECT_REFLECTION_CLASS_NAME
        Sun JDK implementation class: full name of sun.reflect.Reflection
        See Also:
        Constant Field Values

    • Constructor Detail

      • ReflectionUtils

        public ReflectionUtils()

    • Method Detail

      • isSupportedSunReflectReflection

        public static boolean isSupportedSunReflectReflection()
        Is supported sun.reflect.Reflection or not
        Returns:
        true if supported

      • getCallerClassName

        @Nonnull
public static java.lang.String getCallerClassName()
        Get Caller class
        Returns:
        Get the Class name that called the method

      • getCallerClass

        @Nonnull
public static java.lang.Class<?> getCallerClass()
                                         throws java.lang.IllegalStateException
        Get caller class

        For instance, 

             package com.acme;
     import ...;
     class Foo {
         public void bar(){

         }
     }
        Returns:
        Get caller class
        Throws:
        java.lang.IllegalStateException - If the caller class cannot be found

      • getCallerClass

        public static java.lang.Class<?> getCallerClass​(int invocationFrame)
        Get the caller class
        Parameters:
        invocationFrame - The frame of method invocation
        Returns:
        null if not found

      • assertArrayIndex

        public static void assertArrayIndex​(java.lang.Object array,
                                    int index)
                             throws java.lang.IllegalArgumentException
        Assert array index
        Parameters:
        array - Array object
        index - index
        Throws:
        java.lang.IllegalArgumentException - see assertArrayType(Object)
        java.lang.ArrayIndexOutOfBoundsException - If index is less than 0 or equals or greater than length of array

      • assertArrayType

        public static void assertArrayType​(java.lang.Object array)
                            throws java.lang.IllegalArgumentException
        Assert the object is array or not
        Parameters:
        array - asserted object
        Throws:
        java.lang.IllegalArgumentException - if the object is not a array

      • assertFieldMatchType

        public static void assertFieldMatchType​(java.lang.Object object,
                                        java.lang.String fieldName,
                                        java.lang.Class<?> expectedType)
                                 throws java.lang.IllegalArgumentException
        Assert Field type match
        Parameters:
        object - Object
        fieldName - field name
        expectedType - expected type
        Throws:
        java.lang.IllegalArgumentException - if type is not matched

      • toList

        @Nonnull
public static <T> java.util.List<T> toList​(java.lang.Object array)
                                    throws java.lang.IllegalArgumentException
        Convert Array object to List
        Parameters:
        array - array object
        Returns:
        List
        Throws:
        java.lang.IllegalArgumentException - if the object argument is not an array

      • readFieldsAsMap

        @Nonnull
public static java.util.Map<java.lang.String,​java.lang.Object> readFieldsAsMap​(java.lang.Object object)
        Read fields value as Map
        Parameters:
        object - object to be read
        Returns:
        fields value as Map

      • findParameterizedTypes

        public static java.util.Set<java.lang.reflect.ParameterizedType> findParameterizedTypes​(java.lang.Class<?> sourceClass)
        Find the Set of ParameterizedType
        Parameters:
        sourceClass - the source class
        Returns:
        non-null read-only Set

      • findHierarchicalTypes

        public static <T> java.util.Set<java.lang.Class<T>> findHierarchicalTypes​(java.lang.Class<?> sourceClass,
                                                                          java.lang.Class<T> matchType)
        Find the hierarchical types from the source class by specified type.
        Type Parameters:
        T - the type to match
        Parameters:
        sourceClass - the source class
        matchType - the type to match
        Returns:
        non-null read-only Set

      • getProperty

        public static <T> T getProperty​(java.lang.Object bean,
                                java.lang.String methodName)
        Get the value from the specified bean and its getter method.
        Type Parameters:
        T - the type of property value
        Parameters:
        bean - the bean instance
        methodName - the name of getter
        Returns:

      • resolveTypes

        public static java.lang.Class[] resolveTypes​(java.lang.Object... values)
        Resolve the types of the specified values
        Parameters:
        values - the values
        Returns:
        If can't be resolved, return empty class array