org.robolectric.util

Class ReflectionHelpers

java.lang.Object

org.robolectric.util.ReflectionHelpers

public class ReflectionHelpers
extends java.lang.Object

Collection of helper methods for calling methods and accessing fields reflectively.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ReflectionHelpers.ClassParameter<V> Typed parameter used with reflective method calls.
static class	ReflectionHelpers.StringParameter<V> String parameter used with reflective method calls.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Map<java.lang.String,java.lang.Object>	PRIMITIVE_RETURN_VALUES

Constructor Summary

Constructors

Constructor and Description
ReflectionHelpers()

Method Summary

Modifier and Type	Method and Description
static <R> R	callConstructor(java.lang.Class<? extends R> clazz, ReflectionHelpers.ClassParameter<?>... classParameters) Reflectively call the constructor of an object.
static <R> R	callInstanceMethod(java.lang.Class<?> cl, java.lang.Object instance, java.lang.String methodName, ReflectionHelpers.ClassParameter<?>... classParameters) Reflectively call an instance method on an object on a specific class.
static <R> R	callInstanceMethod(java.lang.Object instance, java.lang.String methodName, ReflectionHelpers.ClassParameter<?>... classParameters) Reflectively call an instance method on an object.
static <R> R	callStaticMethod(java.lang.Class<?> clazz, java.lang.String methodName, ReflectionHelpers.ClassParameter<?>... classParameters) Reflectively call a static method on a class.
static <T> T	createDeepProxy(java.lang.Class<T> clazz) Create a proxy for the given class which returns other deep proxies from all it’s methods.
static <T> T	createDelegatingProxy(java.lang.Class<T> clazz, java.lang.Object delegate)
static <T> T	createNullProxy(java.lang.Class<T> clazz)
static <A extends java.lang.annotation.Annotation> A	defaultsFor(java.lang.Class<A> annotation)
static java.lang.Object	defaultValueForType(java.lang.String returnType)
static <R> R	getField(java.lang.Object object, java.lang.String fieldName) Reflectively get the value of a field.
static <R> R	getStaticField(java.lang.Class<?> clazz, java.lang.String fieldName) Reflectively get the value of a static field.
static <R> R	getStaticField(java.lang.reflect.Field field) Reflectively get the value of a static field.
static java.lang.Class<?>	loadClass(java.lang.ClassLoader classLoader, java.lang.String fullyQualifiedClassName) Load a class.
static <T> T	newInstance(java.lang.Class<T> cl) Create a new instance of a class
static void	setField(java.lang.Class<?> type, java.lang.Object object, java.lang.String fieldName, java.lang.Object fieldNewValue) Reflectively set the value of a field.
static void	setField(java.lang.Object object, java.lang.String fieldName, java.lang.Object fieldNewValue) Reflectively set the value of a field.
static void	setStaticField(java.lang.Class<?> clazz, java.lang.String fieldName, java.lang.Object fieldNewValue) Reflectively set the value of a static field.
static void	setStaticField(java.lang.reflect.Field field, java.lang.Object fieldNewValue) Reflectively set the value of a static field.

Methods inherited from class java.lang.Object

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

Field Detail

PRIMITIVE_RETURN_VALUES

public static final java.util.Map<java.lang.String,java.lang.Object> PRIMITIVE_RETURN_VALUES

Constructor Detail

ReflectionHelpers

public ReflectionHelpers()

Method Detail

createNullProxy

public static <T> T createNullProxy(java.lang.Class<T> clazz)

createDeepProxy

public static <T> T createDeepProxy(java.lang.Class<T> clazz)

Create a proxy for the given class which returns other deep proxies from all it’s methods.

The returned object will be an instance of the given class, but all methods will return either the “default” value for primitives, or another deep proxy for non-primitive types.

This should be used rarely, for cases where we need to create deep proxies in order not to crash. The inner proxies are impossible to configure, so there is no way to create meaningful behavior from a deep proxy. It serves mainly to prevent Null Pointer Exceptions.

Parameters:

clazz - the class to provide a proxy instance of.

Returns:

a new “Deep Proxy” instance of the given class.

createDelegatingProxy

public static <T> T createDelegatingProxy(java.lang.Class<T> clazz,
                                          java.lang.Object delegate)

defaultsFor

public static <A extends java.lang.annotation.Annotation> A defaultsFor(java.lang.Class<A> annotation)

getField

public static <R> R getField(java.lang.Object object,
                             java.lang.String fieldName)

Reflectively get the value of a field.

Type Parameters:

R - The return type.

Parameters:

object - Target object.

fieldName - The field name.

Returns:

Value of the field on the object.

setField

public static void setField(java.lang.Object object,
                            java.lang.String fieldName,
                            java.lang.Object fieldNewValue)

Reflectively set the value of a field.

Parameters:

object - Target object.

fieldName - The field name.

fieldNewValue - New value.

setField

public static void setField(java.lang.Class<?> type,
                            java.lang.Object object,
                            java.lang.String fieldName,
                            java.lang.Object fieldNewValue)

Reflectively set the value of a field.

Parameters:

type - Target type.

object - Target object.

fieldName - The field name.

fieldNewValue - New value.

getStaticField

public static <R> R getStaticField(java.lang.reflect.Field field)

Reflectively get the value of a static field.

Type Parameters:

R - The return type.

Parameters:

field - Field object.

Returns:

Value of the field.

getStaticField

public static <R> R getStaticField(java.lang.Class<?> clazz,
                                   java.lang.String fieldName)

Reflectively get the value of a static field.

Type Parameters:

R - The return type.

Parameters:

clazz - Target class.

fieldName - The field name.

Returns:

Value of the field.

setStaticField

public static void setStaticField(java.lang.reflect.Field field,
                                  java.lang.Object fieldNewValue)

Reflectively set the value of a static field.

Parameters:

field - Field object.

fieldNewValue - The new value.

setStaticField

public static void setStaticField(java.lang.Class<?> clazz,
                                  java.lang.String fieldName,
                                  java.lang.Object fieldNewValue)

Reflectively set the value of a static field.

Parameters:

clazz - Target class.

fieldName - The field name.

fieldNewValue - The new value.

callInstanceMethod

public static <R> R callInstanceMethod(java.lang.Object instance,
                                       java.lang.String methodName,
                                       ReflectionHelpers.ClassParameter<?>... classParameters)

Reflectively call an instance method on an object.

Type Parameters:

R - The return type.

Parameters:

instance - Target object.

methodName - The method name to call.

classParameters - Array of parameter types and values.

Returns:

The return value of the method.

callInstanceMethod

public static <R> R callInstanceMethod(java.lang.Class<?> cl,
                                       java.lang.Object instance,
                                       java.lang.String methodName,
                                       ReflectionHelpers.ClassParameter<?>... classParameters)

Reflectively call an instance method on an object on a specific class.

Type Parameters:

R - The return type.

Parameters:

cl - The class.

instance - Target object.

methodName - The method name to call.

classParameters - Array of parameter types and values.

Returns:

The return value of the method.

callStaticMethod

public static <R> R callStaticMethod(java.lang.Class<?> clazz,
                                     java.lang.String methodName,
                                     ReflectionHelpers.ClassParameter<?>... classParameters)

Reflectively call a static method on a class.

Type Parameters:

R - The return type.

Parameters:

clazz - Target class.

methodName - The method name to call.

classParameters - Array of parameter types and values.

Returns:

The return value of the method.

loadClass

public static java.lang.Class<?> loadClass(java.lang.ClassLoader classLoader,
                                           java.lang.String fullyQualifiedClassName)

Load a class.

Parameters:

classLoader - The class loader.

fullyQualifiedClassName - The fully qualified class name.

Returns:

The class object.

newInstance

public static <T> T newInstance(java.lang.Class<T> cl)

Create a new instance of a class

Type Parameters:

T - The class type.

Parameters:

cl - The class object.

Returns:

New class instance.

callConstructor

public static <R> R callConstructor(java.lang.Class<? extends R> clazz,
                                    ReflectionHelpers.ClassParameter<?>... classParameters)

Reflectively call the constructor of an object.

Type Parameters:

R - The return type.

Parameters:

clazz - Target class.

classParameters - Array of parameter types and values.

Returns:

The return value of the method.

defaultValueForType

public static java.lang.Object defaultValueForType(java.lang.String returnType)