org.spf4j.base

Class Reflections

java.lang.Object

org.spf4j.base.Reflections

@ParametersAreNonnullByDefault
public final class Reflections
extends Object

Method Summary

Modifier and Type	Method and Description
static boolean	canAssign(Class<?> to, Class<?> from)
static Object	getAnnotationAttribute(Annotation annot, String attributeName)
static Method	getCompatibleMethod(Class<?> c, String methodName, Class<?>... paramTypes) Method lookup utility that looks up a method declaration that is compatible.
static Method	getCompatibleMethodCached(Class<?> c, String methodName, Class<?>... paramTypes)
static MethodHandle	getCompatibleMethodHandle(Class<?> c, String methodName, Class<?>... paramTypes)
static MethodHandle	getCompatibleMethodHandleCached(Class<?> c, String methodName, Class<?>... paramTypes)
static Constructor<?>	getConstructor(Class<?> c, Class<?>... paramTypes) Equivalent to Class.getDeclaredConstructor, only that it does not throw an exception if no constructor, it returns null instead, also makes all constructors accessible..
static Class<?>	getLoadedClass(ClassLoader cl, String className)
static Manifest	getManifest(URL jarUrl) Get the manifest of a jar file.
static Method	getMethod(Class<?> c, String methodName, Class<?>... paramTypes) Equivalent to Class.getDeclaredMethod which returns a null instead of throwing an exception.
static Class<?>[]	getParameterTypes(Constructor<?> m)
static Class<?>[]	getParameterTypes(Method m) Optimized alternative of Method.getParameterTypes that steals the parameterTypeArry from method instead of copying it.
static <T> T	implement(Class<T> clasz, Object target)
static <T> T	implementStatic(Class<T> clasz, Class<?> target) create a proxy instance that will proxy interface methods to static methods on the target class.
static Object	invoke(Method m, Object object, Object[] parameters)
static boolean	isWrappableOrWrapper(Class clasz)
static Class<?>	primitiveToWrapper(Class<?> clasz)
static Type	primitiveToWrapper(Type type)
static Class<?>	wrapperToPrimitive(Class<?> clasz)

Methods inherited from class java.lang.Object

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

Method Detail

getParameterTypes

public static Class<?>[] getParameterTypes(Method m)

Optimized alternative of Method.getParameterTypes that steals the parameterTypeArry from method instead of copying it. Here is the benchmark comparison for a 5 arg method: Benchmark Mode Cnt Score Error Units ReflectionsBenchmark.normalGetTypes thrpt 10 227015245.933 ± 2725143.765 ops/s ReflectionsBenchmark.optimizedGetTypes thrpt 10 1159407471.306 ± 21204385.301 ops/s

Parameters:

m -

Returns:

getParameterTypes

public static Class<?>[] getParameterTypes(Constructor<?> m)

primitiveToWrapper

public static Class<?> primitiveToWrapper(Class<?> clasz)

primitiveToWrapper

@Nonnull
public static Type primitiveToWrapper(Type type)

wrapperToPrimitive

public static Class<?> wrapperToPrimitive(Class<?> clasz)

isWrappableOrWrapper

public static boolean isWrappableOrWrapper(Class clasz)

getAnnotationAttribute

public static Object getAnnotationAttribute(@Nonnull
                                            Annotation annot,
                                            @Nonnull
                                            String attributeName)

getMethod

@Nullable
public static Method getMethod(Class<?> c,
                                         String methodName,
                                         Class<?>... paramTypes)

Equivalent to Class.getDeclaredMethod which returns a null instead of throwing an exception. returned method is also made accessible.

Parameters:

c -

methodName -

paramTypes -

Returns:

getConstructor

@Nullable
public static Constructor<?> getConstructor(Class<?> c,
                                                      Class<?>... paramTypes)

Equivalent to Class.getDeclaredConstructor, only that it does not throw an exception if no constructor, it returns null instead, also makes all constructors accessible..

getCompatibleMethod

@Nullable
public static Method getCompatibleMethod(Class<?> c,
                                                   String methodName,
                                                   Class<?>... paramTypes)

Method lookup utility that looks up a method declaration that is compatible. (taking in consideration boxed primitives and varargs)

Parameters:

c -

methodName -

paramTypes -

Returns:

getCompatibleMethodHandle

@Nullable
public static MethodHandle getCompatibleMethodHandle(Class<?> c,
                                                               String methodName,
                                                               Class<?>... paramTypes)

invoke

public static Object invoke(Method m,
                            Object object,
                            Object[] parameters)
                     throws IllegalAccessException,
                            InvocationTargetException

Throws:

IllegalAccessException

InvocationTargetException

canAssign

public static boolean canAssign(Class<?> to,
                                Class<?> from)

getCompatibleMethodCached

@Nullable
public static Method getCompatibleMethodCached(Class<?> c,
                                                         String methodName,
                                                         Class<?>... paramTypes)

getCompatibleMethodHandleCached

public static MethodHandle getCompatibleMethodHandleCached(Class<?> c,
                                                           String methodName,
                                                           Class<?>... paramTypes)

getManifest

@Nullable
public static Manifest getManifest(@Nonnull
                                             URL jarUrl)
                                      throws IOException

Get the manifest of a jar file.

Parameters:

jarUrl -

Returns:

Throws:

IOException

implementStatic

public static <T> T implementStatic(Class<T> clasz,
                                    Class<?> target)

create a proxy instance that will proxy interface methods to static methods on the target class.

Type Parameters:

T -

Parameters:

clasz -

target -

Returns:

implement

public static <T> T implement(Class<T> clasz,
                              Object target)

getLoadedClass

@Nullable
public static Class<?> getLoadedClass(ClassLoader cl,
                                                String className)