mockit

Class Deencapsulation

java.lang.Object

mockit.Deencapsulation

public final class Deencapsulation
extends Object

Provides utility methods that enable access to ("de-encapsulate") otherwise non-accessible fields.

See Also:

getField(Object, String), setField(Object, String, Object)

Method Summary

Modifier and Type	Method and Description
static <T> T	getField(Class<?> classWithStaticField, Class<T> fieldType) Gets the value of a non-accessible static field defined in a given class, assuming there is only one field declared in the given class whose type can receive values of the specified field type.
static <T> T	getField(Class<?> classWithStaticField, String fieldName) Gets the value of a non-accessible static field defined in a given class.
static <T> T	getField(Object objectWithField, Class<T> fieldType) Gets the value of a non-accessible (eg private) field from a given object, assuming there is only one field declared in the class of the given object whose type can receive values of the specified field type.
static <T> T	getField(Object objectWithField, String fieldName) Gets the value of a non-accessible (eg private) field from a given object.
static <T> T	newUninitializedInstance(Class<? extends T> classToInstantiate) Creates a new instance of a given class, without invoking any constructor.
static void	setField(Class<?> classWithStaticField, Object fieldValue) Sets the value of a non-accessible static field on a given class.
static void	setField(Class<?> classWithStaticField, String fieldName, Object fieldValue) Sets the value of a non-accessible static field on a given class.
static void	setField(Object objectWithField, Object fieldValue) Sets the value of a non-accessible field on a given object.
static void	setField(Object objectWithField, String fieldName, Object fieldValue) Sets the value of a non-accessible field on a given object.

Methods inherited from class java.lang.Object

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

Method Detail

getField

public static <T> T getField(Class<?> classWithStaticField,
                             Class<T> fieldType)

Gets the value of a non-accessible static field defined in a given class, assuming there is only one field declared in the given class whose type can receive values of the specified field type.

Type Parameters:

T - interface or class type to which the returned value should be assignable

Parameters:

classWithStaticField - the class from which to get the field value

fieldType - the declared type of the field, or a sub-type of the declared field type

Throws:

IllegalArgumentException - if either the desired field is not found, or more than one is

See Also:

getField(Class, String), getField(Object, Class), setField(Class, Object)

getField

public static <T> T getField(Class<?> classWithStaticField,
                             String fieldName)

Gets the value of a non-accessible static field defined in a given class.

Type Parameters:

T - interface or class type to which the returned value should be assignable

Parameters:

classWithStaticField - the class from which to get the field value

fieldName - the name of the static field to get

Throws:

IllegalArgumentException - if the desired field is not found

See Also:

getField(Class, Class), getField(Object, String), setField(Class, String, Object)

getField

public static <T> T getField(Object objectWithField,
                             Class<T> fieldType)

Gets the value of a non-accessible (eg private) field from a given object, assuming there is only one field declared in the class of the given object whose type can receive values of the specified field type.

Parameters:

objectWithField - the instance from which to get the field value

fieldType - the declared type of the field, or a sub-type of the declared field type

Throws:

IllegalArgumentException - if either the desired field is not found, or more than one is

See Also:

getField(Object, String), getField(Class, String), setField(Object, Object)

getField

public static <T> T getField(Object objectWithField,
                             String fieldName)

Gets the value of a non-accessible (eg private) field from a given object.

Type Parameters:

T - interface or class type to which the returned value should be assignable

Parameters:

objectWithField - the instance from which to get the field value

fieldName - the name of the field to get

Throws:

IllegalArgumentException - if the desired field is not found

See Also:

getField(Object, Class), getField(Class, String), setField(Object, String, Object)

newUninitializedInstance

public static <T> T newUninitializedInstance(Class<? extends T> classToInstantiate)

Creates a new instance of a given class, without invoking any constructor. If the given class is abstract or an interface, then a concrete class is created, with empty implementations for the abstract/interface methods.

Type Parameters:

T - type to which the returned instance should be assignable

Parameters:

classToInstantiate - the class to be instantiated

Returns:

a newly created instance of the specified class, with any instance fields left uninitialized

setField

public static void setField(Class<?> classWithStaticField,
                            Object fieldValue)

Sets the value of a non-accessible static field on a given class. The field is looked up by the type of the given field value instead of by name.

Parameters:

classWithStaticField - the class on which the static field is defined

fieldValue - the value to set the field to

Throws:

IllegalArgumentException - if either the desired field is not found, or more than one is

See Also:

setField(Class, String, Object), setField(Object, Object), getField(Class, Class)

setField

public static void setField(Class<?> classWithStaticField,
                            String fieldName,
                            Object fieldValue)

Sets the value of a non-accessible static field on a given class.

Parameters:

classWithStaticField - the class on which the static field is defined

fieldName - the name of the field to set

fieldValue - the value to set the field to

Throws:

IllegalArgumentException - if the desired field is not found

See Also:

setField(Class, Object), setField(Object, String, Object), getField(Class, String)

setField

public static void setField(Object objectWithField,
                            Object fieldValue)

Sets the value of a non-accessible field on a given object. The field is looked up by the type of the given field value instead of by name.

Throws:

IllegalArgumentException - if either the desired field is not found, or more than one is

See Also:

setField(Object, String, Object), setField(Class, String, Object), getField(Object, String)

setField

public static void setField(Object objectWithField,
                            String fieldName,
                            Object fieldValue)

Sets the value of a non-accessible field on a given object.

Parameters:

objectWithField - the instance on which to set the field value

fieldName - the name of the field to set

fieldValue - the value to set the field to

Throws:

IllegalArgumentException - if the desired field is not found

See Also:

setField(Class, String, Object), setField(Object, Object), getField(Object, String)