Assumes the logical 'false' for the reverseLoader.
* - * @param p - * @param ref + * @param p the project + * @param ref the reference * @return The class loader */ public static ClassLoader getClassLoaderForPath( @@ -121,8 +121,9 @@ public class ClasspathUtils { * *Assumes the logical 'false' for the reverseLoader.
* - * @param path - * @param loaderId + * @param p current ant project + * @param path the path + * @param loaderId the loader id string * @return The class loader */ public static ClassLoader getClassLoaderForPath( @@ -138,8 +139,12 @@ public class ClasspathUtils { *Sets value for 'reuseLoader' to true if the magic property * has been set.
* - * @param path - * @param loaderId + * @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 it's parent (which is contra the regular + * classloader behaviour) * @return The class loader */ public static ClassLoader getClassLoaderForPath( @@ -156,12 +161,13 @@ public class ClasspathUtils { * 'ant.reuse.loader' this will try to reuse the perviously * 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 it's parent (which is contra the regular * classloader behaviour) - * @param p Ant Project where the handled components are living in. + * @param reuseLoader if true reuse the loader if it is found * @return ClassLoader that uses the Path as its classpath. */ public static ClassLoader getClassLoaderForPath( @@ -197,8 +203,11 @@ public class ClasspathUtils { * *This method completely ignores the ant.reuse.loader magic * property and should be used with caution.
- * @param path the classpath for this loader - * @param reverseLoader + * @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 it's parent (which is contra the regular + * classloader behaviour) * @return The fresh, different, not used before class loader. */ public static ClassLoader getUniqueClassLoaderForPath( @@ -303,7 +312,7 @@ public class ClasspathUtils { /** * Constructs Delegate - * @param component + * @param component the ProjectComponent this delegate is for. */ Delegate(ProjectComponent component) { this.component = component; @@ -312,9 +321,9 @@ public class ClasspathUtils { /** * This method is a Delegate method handling the @classpath attribute. * - *This attribute can set a path to add to the classpath
+ *This attribute can set a path to add to the classpath.
* - * @param classpath + * @param classpath the path to use for the classpath. */ public void setClasspath(Path classpath) { if (this.classpath == null) { @@ -328,9 +337,9 @@ public class ClasspathUtils { * Delegate method handling the <classpath> tag. * *This nested path-like structure can set a path to add to the - * classpath
+ * classpath. * - * @return the created path + * @return the created path. */ public Path createClasspath() { if (this.classpath == null) { @@ -343,9 +352,9 @@ public class ClasspathUtils { * Delegate method handling the @classname attribute. * *This attribute sets the full qualified class name of the class - * to lad and instantiate
+ * to load and instantiate. * - * @param fcqn + * @param fcqn the name of the class to load. */ public void setClassname(String fcqn) { this.className = fcqn; @@ -355,9 +364,9 @@ public class ClasspathUtils { * Delegate method handling the @classpathref attribute. * *This attribute can add a referenced path-like structure to the - * classpath
+ * classpath. * - * @param r + * @param r the reference to the classpath. */ public void setClasspathref(Reference r) { this.classpathId = r.getRefId(); @@ -371,21 +380,21 @@ public class ClasspathUtils { * classloader should NOT follow the classical parent-first scheme. * * - *By default this is supposed to be false
+ *By default this is supposed to be false.
* *Caution: this behaviour is contradictory to the normal way * classloaders work. Do not let your ProjectComponent use it if - * you are not really sure
+ * you are not really sure. * - * @param reverseLoader + * @param reverseLoader if true reverse the order of looking up a class. */ public void setReverseLoader(boolean reverseLoader) { this.reverseLoader = reverseLoader; } /** - * Sets the loaderRef - * @param r + * Sets the loaderRef. + * @param r the reference to the loader. */ public void setLoaderRef(Reference r) { this.loaderId = r.getRefId(); @@ -393,8 +402,8 @@ public class ClasspathUtils { /** - * Finds or creates the classloader for this - * @return The class loader + * Finds or creates the classloader for this object. + * @return The class loader. */ public ClassLoader getClassLoader() { ClassLoader cl; @@ -416,6 +425,7 @@ public class ClasspathUtils { /** * Computes the loaderId based on the configuration of the component. + * @return a loader identifier. */ public String getClassLoadId() { if (this.loaderId == null && this.classpathId != null) { @@ -438,11 +448,16 @@ public class ClasspathUtils { /** * The classpath. + * @return the classpath. */ public Path getClasspath() { return classpath; } + /** + * Get the reverseLoader setting. + * @return true if looking up in reverse order. + */ public boolean isReverseLoader() { return reverseLoader; }