org.powermock.core.classloader

Class MockClassLoader

java.lang.Object

java.lang.ClassLoader

org.powermock.core.classloader.MockClassLoader

Direct Known Subclasses:

JavassistMockClassLoader

public abstract class MockClassLoader
extends java.lang.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 and Description
protected ClassMarker	classMarker
protected ClassWrapperFactory	classWrapperFactory
static java.lang.String	MODIFY_ALL_CLASSES Pass this string to the constructor to indicate that all classes should be modified.

Constructor Summary

Constructors

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

Method Summary

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

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findSystemClass, getPackage, getPackages, getParent, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Field Detail

MODIFY_ALL_CLASSES

public static final java.lang.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 Detail

MockClassLoader

protected MockClassLoader(java.lang.String[] classesToMock,
                          java.lang.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 Detail

loadClassByThisClassLoader

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

Throws:

java.lang.ClassFormatError

java.lang.ClassNotFoundException

setMockTransformerChain

public void setMockTransformerChain(MockTransformerChain mockTransformerChain)

getMockTransformerChain

public MockTransformerChain getMockTransformerChain()

loadUnmockedClass

protected java.lang.Class<?> loadUnmockedClass(java.lang.String name,
                                               java.security.ProtectionDomain protectionDomain)
                                        throws java.lang.ClassNotFoundException

Throws:

java.lang.ClassNotFoundException

defineClass

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

transformClass

protected <T> ClassWrapper<T> transformClass(ClassWrapper<T> wrappedType)
                                      throws java.lang.Exception

Throws:

java.lang.Exception

defineAndTransformClass

protected abstract byte[] defineAndTransformClass(java.lang.String name,
                                                  java.security.ProtectionDomain protectionDomain)
                                           throws java.lang.ClassNotFoundException

Throws:

java.lang.ClassNotFoundException

getResource

public java.net.URL getResource(java.lang.String s)

Overrides:

getResource in class java.lang.ClassLoader

getResourceAsStream

public java.io.InputStream getResourceAsStream(java.lang.String s)

Overrides:

getResourceAsStream in class java.lang.ClassLoader

getResources

public java.util.Enumeration<java.net.URL> getResources(java.lang.String name)
                                                 throws java.io.IOException

Overrides:

getResources in class java.lang.ClassLoader

Throws:

java.io.IOException

getConfiguration

public MockClassLoaderConfiguration getConfiguration()

cache

public void cache(java.lang.Class<?> cls)

Register a class to the cache of this classloader

loadClass

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

Overrides:

loadClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

getClassLoadingLock

protected java.lang.Object getClassLoadingLock(java.lang.String className)

Overrides:

getClassLoadingLock in class java.lang.ClassLoader

findResource

protected java.net.URL findResource(java.lang.String name)

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

Overrides:

findResource in class java.lang.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 java.util.Enumeration<java.net.URL> findResources(java.lang.String name)
                                                     throws java.io.IOException

Overrides:

findResources in class java.lang.ClassLoader

Throws:

java.io.IOException