File	Doc	Category	Size	Date	Package
ClasspathUtils.java	API Doc	Apache Ant 1.70	17569	Wed Dec 13 06:16:18 GMT 2006	org.apache.tools.ant.util

ClasspathUtils

• java.lang.Object

ClasspathUtils.Delegate cpDelegate;

public void init() {
this.cpDelegate = ClasspathUtils.getDelegate(this);
super.init();
}

public void setClasspathRef(Reference r) {
this.cpDelegate.setClasspathRef(r);
}

public Path createClasspath() {
return this.cpDelegate.createClasspath();
}

public void setClassname(String fqcn) {
this.cpDelegate.setClassname(fqcn);
}

Object o = this.cpDelegate.newInstance();

Fields Summary
public static final String	REUSE_LOADER_REF Name of the magic property that controls classloader reuse in Ant 1.4.

Constructors Summary

Methods Summary
public static java.lang.ClassLoader	getClassLoaderForPath(org.apache.tools.ant.Project p, org.apache.tools.ant.types.Reference ref) Convenience overloaded version of {@link #getClassLoaderForPath(Project, Reference, boolean)}. Assumes the logical 'false' for the reverseLoader. param p the project param ref the reference return The class loader return getClassLoaderForPath(p, ref, false);
public static java.lang.ClassLoader	getClassLoaderForPath(org.apache.tools.ant.Project p, org.apache.tools.ant.types.Reference ref, boolean reverseLoader) Convenience overloaded version of {@link #getClassLoaderForPath(Project, Path, String, boolean)}. Delegates to the other one after extracting the referenced Path from the Project. This checks also that the passed Reference is pointing to a Path all right. param p current Ant project param ref Reference to Path structure param reverseLoader if set to true this new loader will take precedence over its parent (which is contra the regular classloader behaviour) return The class loader String pathId = ref.getRefId(); Object path = p.getReference(pathId); if (!(path instanceof Path)) { throw new BuildException( "The specified classpathref " + pathId + " does not reference a Path."); } String loaderId = MagicNames.REFID_CLASSPATH_LOADER_PREFIX + pathId; return getClassLoaderForPath(p, (Path) path, loaderId, reverseLoader);
public static java.lang.ClassLoader	getClassLoaderForPath(org.apache.tools.ant.Project p, org.apache.tools.ant.types.Path path, java.lang.String loaderId) Convenience overloaded version of {@link #getClassLoaderForPath(Project, Path, String, boolean)}. Assumes the logical 'false' for the reverseLoader. param p current Ant project param path the path param loaderId the loader id string return The class loader return getClassLoaderForPath(p, path, loaderId, false);
public static java.lang.ClassLoader	getClassLoaderForPath(org.apache.tools.ant.Project p, org.apache.tools.ant.types.Path path, java.lang.String loaderId, boolean reverseLoader) Convenience overloaded version of {@link #getClassLoaderForPath(Project, Path, String, boolean, boolean)}. Sets value for 'reuseLoader' to true if the magic property has been set. param p the project param path the path param loaderId the loader id string param reverseLoader if set to true this new loader will take precedence over its parent (which is contra the regular classloader behaviour) return The class loader return getClassLoaderForPath(p, path, loaderId, reverseLoader, isMagicPropertySet(p));
public static java.lang.ClassLoader	getClassLoaderForPath(org.apache.tools.ant.Project p, org.apache.tools.ant.types.Path path, java.lang.String loaderId, boolean reverseLoader, boolean reuseLoader) Gets a classloader that loads classes from the classpath defined in the path argument. Based on the setting of the magic property 'ant.reuse.loader' this will try to reuse the previously created loader with that id, and of course store it there upon creation. param p Ant Project where the handled components are living in. param path Path object to be used as classpath for this classloader param loaderId identification for this Loader, param reverseLoader if set to true this new loader will take precedence over its parent (which is contra the regular classloader behaviour) param reuseLoader if true reuse the loader if it is found return ClassLoader that uses the Path as its classpath. ClassLoader cl = null; // magic property if (loaderId != null && reuseLoader) { Object reusedLoader = p.getReference(loaderId); if (reusedLoader != null && !(reusedLoader instanceof ClassLoader)) { throw new BuildException("The specified loader id " + loaderId + " does not reference a class loader"); } cl = (ClassLoader) reusedLoader; } if (cl == null) { cl = getUniqueClassLoaderForPath(p, path, reverseLoader); if (loaderId != null && reuseLoader) { p.addReference(loaderId, cl); } } return cl;
public static org.apache.tools.ant.util.ClasspathUtils$Delegate	getDelegate(org.apache.tools.ant.ProjectComponent component) Obtains a delegate that helps out with classic classpath configuration. param component your projectComponent that needs the assistence return the helper, delegate. see ClasspathUtils.Delegate return new Delegate(component);
public static java.lang.ClassLoader	getUniqueClassLoaderForPath(org.apache.tools.ant.Project p, org.apache.tools.ant.types.Path path, boolean reverseLoader) Gets a fresh, different, previously unused classloader that uses the passed path as its classpath. This method completely ignores the ant.reuse.loader magic property and should be used with caution. param p Ant Project where the handled components are living in. param path the classpath for this loader param reverseLoader if set to true this new loader will take precedence over its parent (which is contra the regular classloader behaviour) return The fresh, different, previously unused class loader. AntClassLoader acl = p.createClassLoader(path); if (reverseLoader) { acl.setParentFirst(false); acl.addJavaLibraries(); } return acl;
private static boolean	isMagicPropertySet(org.apache.tools.ant.Project p) Checks for the magic property that enables class loader reuse for and in Ant 1.5 and earlier. return p.getProperty(REUSE_LOADER_REF) != null;
public static java.lang.Object	newInstance(java.lang.String className, java.lang.ClassLoader userDefinedLoader) Creates a fresh object instance of the specified classname. This uses the userDefinedLoader to load the specified class, and then makes an instance using the default no-argument constructor. param className the full qualified class name to load. param userDefinedLoader the classloader to use. return The fresh object instance throws BuildException when loading or instantiation failed. return newInstance(className, userDefinedLoader, Object.class);
public static java.lang.Object	newInstance(java.lang.String className, java.lang.ClassLoader userDefinedLoader, java.lang.Class expectedType) Creates a fresh object instance of the specified classname. This uses the userDefinedLoader to load the specified class, and then makes an instance using the default no-argument constructor. param className the full qualified class name to load. param userDefinedLoader the classloader to use. param expectedType the Class that the result should be assignment compatible with. (No ClassCastException will be thrown in case the result of this method is casted to the expectedType) return The fresh object instance throws BuildException when loading or instantiation failed. since Ant 1.7 try { Class clazz = Class.forName(className, true, userDefinedLoader); Object o = clazz.newInstance(); if (!expectedType.isInstance(o)) { throw new BuildException( "Class of unexpected Type: " + className + " expected :" + expectedType); } return o; } catch (ClassNotFoundException e) { throw new BuildException( "Class not found: " + className, e); } catch (InstantiationException e) { throw new BuildException( "Could not instantiate " + className + ". Specified class should have a no " + "argument constructor.", e); } catch (IllegalAccessException e) { throw new BuildException( "Could not instantiate " + className + ". Specified class should have a " + "public constructor.", e); } catch (LinkageError e) { throw new BuildException( "Class " + className + " could not be loaded because of an invalid dependency.", e); }