Class MockClassLoader

java.lang.Object

java.lang.ClassLoader

org.powermock.core.classloader.MockClassLoader

Direct Known Subclasses:

JavassistMockClassLoader

public abstract class MockClassLoader
extends ClassLoader

The classloader loads and modified all classes except:

1. system classes. They are deferred to system classloader
2. classes that locate in packages that specified as packages to ignore with using MockClassLoaderConfiguration.addIgnorePackage(String...)

Testing frameworks classes are loaded, but not modified.

The classloader uses list of MockTransformer to modify classes during loading.

Author:

Johan Haleby, Jan Kronquist, Artur Zagretdinov

See Also:

• MockClassLoaderConfiguration
• ClassLoader.getSystemClassLoader()
• IgnorePackagesExtractor

Field Summary

Fields

Modifier and Type	Field	Description
protected ClassMarker	classMarker
protected ClassWrapperFactory	classWrapperFactory
static final String	MODIFY_ALL_CLASSES	Pass this string to the constructor to indicate that all classes should be modified.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MockClassLoader(String[] classesToMock, String[] packagesToDefer)	Creates a new instance of the based on the following parameters:
protected	MockClassLoader(MockClassLoaderConfiguration configuration, ClassWrapperFactory classWrapperFactory)	Creates a new instance of the based on the following parameters:

Method Summary

Modifier and Type	Method	Description
void	cache(Class<?> cls)	Register a class to the cache of this classloader
protected abstract byte[]	defineAndTransformClass(String name, ProtectionDomain protectionDomain)
Class<?>	defineClass(String name, ProtectionDomain protectionDomain, byte[] clazz)
protected URL	findResource(String name)	Finds the resource with the specified name on the search path.
protected Enumeration<URL>	findResources(String name)
protected Object	getClassLoadingLock(String className)
MockClassLoaderConfiguration	getConfiguration()
MockTransformerChain	getMockTransformerChain()
URL	getResource(String s)
InputStream	getResourceAsStream(String s)
Enumeration<URL>	getResources(String name)
protected Class<?>	loadClass(String name, boolean resolve)
protected Class<?>	loadClassByThisClassLoader(String className)
protected Class<?>	loadUnmockedClass(String name, ProtectionDomain protectionDomain)
void	setMockTransformerChain(MockTransformerChain mockTransformerChain)
protected <T> ClassWrapper<T>	transformClass(ClassWrapper<T> wrappedType)

Methods inherited from class ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, 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 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

classMarker

protected ClassMarker classMarker

classWrapperFactory

protected ClassWrapperFactory classWrapperFactory

Constructor Details

MockClassLoader

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

Creates a new instance of the 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

protected MockClassLoader(MockClassLoaderConfiguration configuration,
 ClassWrapperFactory classWrapperFactory)

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

Parameters:

configuration - The configuration of class loader. Configuration contains information about classes which should be loaded by class loader, defer to system and mocked.

classWrapperFactory - an instance of ClassWrapperFactory which is used to wrap internal framework's representation of the class into ClassWrapper

See Also:

• MockClassLoaderConfiguration

Method Details

loadClassByThisClassLoader

protected Class<?> loadClassByThisClassLoader(String className)
                                       throws ClassFormatError,
ClassNotFoundException

Throws:

ClassFormatError

ClassNotFoundException

setMockTransformerChain

public void setMockTransformerChain(MockTransformerChain mockTransformerChain)

getMockTransformerChain

public MockTransformerChain getMockTransformerChain()

loadUnmockedClass

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

Throws:

ClassNotFoundException

defineClass

public Class<?> defineClass(String name,
 ProtectionDomain protectionDomain,
 byte[] clazz)

transformClass

protected <T> ClassWrapper<T> transformClass(ClassWrapper<T> wrappedType)
                                      throws Exception

Throws:

Exception

defineAndTransformClass

protected abstract byte[] defineAndTransformClass(String name,
 ProtectionDomain protectionDomain)
                                           throws ClassNotFoundException

Throws:

ClassNotFoundException

getResource

public URL getResource(String s)

Overrides:

getResource in class ClassLoader

getResourceAsStream

public InputStream getResourceAsStream(String s)

Overrides:

getResourceAsStream in class ClassLoader

getResources

public Enumeration<URL> getResources(String name)
                              throws IOException

Overrides:

getResources in class ClassLoader

Throws:

IOException

getConfiguration

public MockClassLoaderConfiguration getConfiguration()

cache

public void cache(Class<?> cls)

Register a class to the cache of this classloader

loadClass

protected Class<?> loadClass(String name,
 boolean resolve)
                      throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

getClassLoadingLock

protected Object getClassLoadingLock(String className)

Overrides:

getClassLoadingLock in class ClassLoader

findResource

protected URL findResource(String name)

Finds the resource with the specified name on the search path.

Overrides:

findResource in class ClassLoader

Parameters:

name - the name of the resource

Returns:

a URL for the resource, or null if the resource could not be found.

findResources

protected Enumeration<URL> findResources(String name)
                                  throws IOException

Overrides:

findResources in class ClassLoader

Throws:

IOException