Package org.powermock.core.classloader

Class MockClassLoader

java.lang.Object

java.lang.ClassLoader

javassist.Loader

org.powermock.core.classloader.DeferSupportingClassLoader

org.powermock.core.classloader.MockClassLoader

public class MockClassLoader
extends DeferSupportingClassLoader

Mock all classes except system classes.

Notice that there are two different types of classes that are not mocked:

1. system classes are deferred to another classloader
2. testing framework classes are loaded, but not modified

Nested Class Summary

Nested classes/interfaces inherited from class javassist.Loader

javassist.Loader.Simple

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	CGLIB_ENHANCER
private static final String	CGLIB_METHOD_WRAPPER
private final javassist.ClassPool	classPool
private final JavaAssistClassMarker	javaAssistClassMarker
private List<MockTransformer>	mockTransformerChain
private final Set<String>	modify
static final String	MODIFY_ALL_CLASSES	Pass this string to the constructor to indicate that all classes should be modified.
private static final String[]	packagesToBeDeferred
private final String[]	packagesToLoadButNotModify
private final String[]	specificClassesToLoadButNotModify

Fields inherited from class org.powermock.core.classloader.DeferSupportingClassLoader

deferPackages, deferTo

Fields inherited from class javassist.Loader

doDelegation

Constructor Summary

Constructors

Constructor	Description
MockClassLoader()
MockClassLoader(String[] classesToMock)	Creates a new instance of the MockClassLoader based on the following parameters:
MockClassLoader(String[] classesToMock, String[] packagesToDefer)	Creates a new instance of the MockClassLoader based on the following parameters:
MockClassLoader(String[] classesToMock, String[] packagesToDefer, UseClassPathAdjuster useClassPathAdjuster)	Creates a new instance of the MockClassLoader based on the following parameters:
MockClassLoader(String[] classesToMock, UseClassPathAdjuster useClassPathAdjuster)	Creates a new instance of the MockClassLoader based on the following parameters:

Method Summary

Modifier and Type	Method	Description
final void	addClassesToModify(String... classes)	Add classes that will be loaded by the mock classloader, i.e.
private static String[]	getPackagesToDefer(String[] additionalDeferPackages)
private Class<?>	loadMockClass(String name)	Load a mocked version of the class.
protected Class<?>	loadModifiedClass(String s)
private Class<?>	loadUnmockedClass(String name, ProtectionDomain protectionDomain)
void	setMockTransformerChain(List<MockTransformer> mockTransformerChain)
protected boolean	shouldLoadUnmodifiedClass(String className)
private boolean	shouldLoadWithMockClassloaderWithoutModifications(String className)
private boolean	shouldModify(String className)
private boolean	shouldModifyAll()
protected boolean	shouldModifyClass(String s)

Methods inherited from class org.powermock.core.classloader.DeferSupportingClassLoader

addIgnorePackage, cache, findResource, findResources, getResource, getResourceAsStream, getResources, loadClass, shouldDefer, shouldIgnore, shouldModify

Methods inherited from class javassist.Loader

addTranslator, delegateLoadingOf, delegateToParent, findClass, loadClassByDelegation, main, run, run, setClassPool, setDomain

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Field Details

MODIFY_ALL_CLASSES

public static final String MODIFY_ALL_CLASSES

Pass this string to the constructor to indicate that all classes should be modified.

See Also:

• Constant Field Values

CGLIB_ENHANCER

private static final String CGLIB_ENHANCER

See Also:

• Constant Field Values

CGLIB_METHOD_WRAPPER

private static final String CGLIB_METHOD_WRAPPER

See Also:

• Constant Field Values

javaAssistClassMarker

private final JavaAssistClassMarker javaAssistClassMarker

mockTransformerChain

private List<MockTransformer> mockTransformerChain

modify

private final Set<String> modify

packagesToLoadButNotModify

private final String[] packagesToLoadButNotModify

specificClassesToLoadButNotModify

private final String[] specificClassesToLoadButNotModify

packagesToBeDeferred

private static final String[] packagesToBeDeferred

classPool

private final javassist.ClassPool classPool

Constructor Details

MockClassLoader

public MockClassLoader(String[] classesToMock,
 String[] packagesToDefer,
 UseClassPathAdjuster useClassPathAdjuster)

Creates a new instance of the MockClassLoader based on the following parameters:

Parameters:

classesToMock - The classes that must be modified to prepare for testability.

packagesToDefer - Classes in these packages will be defered to the system class-loader.

MockClassLoader

MockClassLoader()

MockClassLoader

public MockClassLoader(String[] classesToMock,
 String[] packagesToDefer)

Creates a new instance of the MockClassLoader based on the following parameters:

Parameters:

classesToMock - The classes that must be modified to prepare for testability.

packagesToDefer - Classes in these packages will be defered to the system class-loader.

MockClassLoader

public MockClassLoader(String[] classesToMock,
 UseClassPathAdjuster useClassPathAdjuster)

Creates a new instance of the MockClassLoader based on the following parameters:

Parameters:

classesToMock - The classes that must be modified to prepare for testability.

MockClassLoader

public MockClassLoader(String[] classesToMock)

Creates a new instance of the MockClassLoader based on the following parameters:

Parameters:

classesToMock - The classes that must be modified to prepare for testability.

Method Details

getPackagesToDefer

private static String[] getPackagesToDefer(String[] additionalDeferPackages)

addClassesToModify

public final void addClassesToModify(String... classes)

Add classes that will be loaded by the mock classloader, i.e. these classes will be byte-code manipulated to allow for testing. Any classes contained in the packagesToBeDeferred will be ignored. How ever classes added here have precedence over additionally deferred (ignored) packages (those ignored by the user using @PrepareForTest).

Parameters:

classes - The fully qualified name of the classes that will be appended to the list of classes that will be byte-code modified to enable testability.

loadModifiedClass

protected Class<?> loadModifiedClass(String s)
                              throws ClassFormatError,
ClassNotFoundException

Specified by:

loadModifiedClass in class DeferSupportingClassLoader

Throws:

ClassFormatError

ClassNotFoundException

shouldModify

private boolean shouldModify(String className)

shouldModifyAll

private boolean shouldModifyAll()

loadUnmockedClass

private Class<?> loadUnmockedClass(String name,
 ProtectionDomain protectionDomain)
                            throws ClassFormatError,
ClassNotFoundException

Throws:

ClassFormatError

ClassNotFoundException

loadMockClass

private Class<?> loadMockClass(String name)

Load a mocked version of the class.

setMockTransformerChain

public void setMockTransformerChain(List<MockTransformer> mockTransformerChain)

shouldModifyClass

protected boolean shouldModifyClass(String s)

Specified by:

shouldModifyClass in class DeferSupportingClassLoader

shouldLoadUnmodifiedClass

protected boolean shouldLoadUnmodifiedClass(String className)

Specified by:

shouldLoadUnmodifiedClass in class DeferSupportingClassLoader

shouldLoadWithMockClassloaderWithoutModifications

private boolean shouldLoadWithMockClassloaderWithoutModifications(String className)