Package org.apache.tools.ant.util

Class SplitClassLoader

java.lang.Object

java.lang.ClassLoader

org.apache.tools.ant.AntClassLoader

org.apache.tools.ant.util.SplitClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable, EventListener, BuildListener, SubBuildListener

public final class SplitClassLoader
extends AntClassLoader

Specialized classloader for tasks that need finer grained control over which classes are to be loaded via Ant's classloader and which should not even if they are available.

Constructor Summary

Constructors

Constructor	Description
SplitClassLoader(ClassLoader parent, Path path, Project project, String[] splitClasses)

Method Summary

Modifier and Type	Method	Description
protected Class<?>	loadClass(String classname, boolean resolve)	Loads a class with this class loader.

Methods inherited from class org.apache.tools.ant.AntClassLoader

addJavaLibraries, addLoaderPackageRoot, addPathComponent, addPathElement, addPathFile, addSystemPackageRoot, buildFinished, buildStarted, cleanup, close, defineClassFromData, definePackage, definePackage, findClass, findResource, findResources, findResources, forceLoadClass, forceLoadSystemClass, getClasspath, getConfiguredParent, getNamedResources, getResource, getResourceAsStream, getResources, getResourceURL, initializeClass, isInPath, log, messageLogged, newAntClassLoader, resetThreadContextLoader, setClassPath, setIsolated, setParent, setParentFirst, setProject, setThreadContextLoader, subBuildFinished, subBuildStarted, targetFinished, targetStarted, taskFinished, taskStarted, toString

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, wait, wait, wait

Constructor Details

SplitClassLoader

public SplitClassLoader(ClassLoader parent,
 Path path,
 Project project,
 String[] splitClasses)

Parameters:

parent - ClassLoader

path - Path

project - Project

splitClasses - classes contained herein will not be loaded via Ant's classloader

Method Details

loadClass

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

Description copied from class: AntClassLoader

Loads a class with this class loader. This class attempts to load the class in an order determined by whether or not the class matches the system/loader package lists, with the loader package list taking priority. If the classloader is in isolated mode, failure to load the class in this loader will result in a ClassNotFoundException.

Overrides:

loadClass in class AntClassLoader

Parameters:

classname - The name of the class to be loaded. Must not be null.

resolve - true if all classes upon which this class depends are to be loaded.

Returns:

the required Class object

Throws:

ClassNotFoundException - if the requested class does not exist on the system classpath (when not in isolated mode) or this loader's classpath.