org.apache.tools.ant.types
Class Path

java.lang.Object
  |
  +--org.apache.tools.ant.ProjectComponent
        |
        +--org.apache.tools.ant.types.DataType
              |
              +--org.apache.tools.ant.types.Path
All Implemented Interfaces:
java.lang.Cloneable

public class Path
extends DataType
implements java.lang.Cloneable

This object represents a path as used by CLASSPATH or PATH environment variable.

<sometask>
  <somepath>
    <pathelement location="/path/to/file.jar" />
    <pathelement path="/path/to/file2.jar:/path/to/class2;/path/to/class3" />
    <pathelement location="/path/to/file3.jar" />
    <pathelement location="/path/to/file4.jar" />
  </somepath>
</sometask>

The object implemention sometask must provide a method called createSomepath which returns an instance of Path. Nested path definitions are handled by the Path object and must be labeled pathelement.

The path element takes a parameter path which will be parsed and split into single elements. It will usually be used to define a path from an environment variable.


Inner Class Summary
 class Path.PathElement
          Helper class, holds the nested <pathelement> values.
 
Field Summary
static Path systemClasspath
           
 
Fields inherited from class org.apache.tools.ant.types.DataType
checked, description, ref
 
Fields inherited from class org.apache.tools.ant.ProjectComponent
project
 
Constructor Summary
Path(Project project)
           
Path(Project p, java.lang.String path)
          Invoked by IntrospectionHelper for setXXX(Path p) attribute setters.
 
Method Summary
 void addExisting(Path source)
          Adds the components on the given path which exist to this Path.
 void addFileset(FileSet fs)
          Adds a nested <fileset> element.
 void append(Path other)
          Append the contents of the other Path instance to this.
 java.lang.Object clone()
          Return a Path that holds the same elements as this instance.
 Path concatSystemClasspath()
          Concatenates the system class path in the order specified by the ${build.sysclasspath} property - using "last" as default value.
 Path concatSystemClasspath(java.lang.String defValue)
          Concatenates the system class path in the order specified by the ${build.sysclasspath} property - using the supplied value if ${build.sysclasspath} has not been set.
 Path createPath()
          Creates a nested <path> element.
 Path.PathElement createPathElement()
          Creates the nested <pathelement> element.
protected  void dieOnCircularReference(java.util.Stack stk, Project p)
          Overrides the version of DataType to recurse on all DataType child elements that may have been added.
 Project getProject()
          Get the Project to which this component belongs
 java.lang.String[] list()
          Returns all path elements defined by this and nested path objects.
 void setLocation(java.io.File location)
          Adds a element definition to the path.
 void setPath(java.lang.String path)
          Parses a path definition and creates single PathElements.
 void setProject(Project p)
          Sets the project object of this component.
 void setRefid(Reference r)
          Makes this instance in effect a reference to another Path instance.
 int size()
          How many parts does this Path instance consist of.
 java.lang.String toString()
          Returns a textual representation of the path, which can be used as CLASSPATH or PATH environment variable definition.
static java.lang.String translateFile(java.lang.String source)
          Returns its argument with all file separator characters replaced so that they match the local OS conventions.
protected static boolean translateFileSep(java.lang.StringBuffer buffer, int pos)
          Translates all occurrences of / or \ to correct separator of the current platform and returns whether it had to do any replacements.
static java.lang.String[] translatePath(Project project, java.lang.String source)
          Splits a PATH (with : or ; as separators) into its parts.
 
Methods inherited from class org.apache.tools.ant.types.DataType
circularReference, getCheckedRef, getDescription, isReference, noChildrenAllowed, setDescription, tooManyAttributes
 
Methods inherited from class org.apache.tools.ant.ProjectComponent
log, log
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

systemClasspath

public static Path systemClasspath
Constructor Detail

Path

public Path(Project p,
            java.lang.String path)
Invoked by IntrospectionHelper for setXXX(Path p) attribute setters.

Path

public Path(Project project)
Method Detail

setProject

public void setProject(Project p)
Description copied from class: ProjectComponent
Sets the project object of this component. This method is used by project when a component is added to it so that the component has access to the functions of the project. It should not be used for any other purpose.
Overrides:
setProject in class ProjectComponent
Following copied from class: org.apache.tools.ant.ProjectComponent
Parameters:
project - Project in whose scope this component belongs.

getProject

public Project getProject()
Description copied from class: ProjectComponent
Get the Project to which this component belongs
Overrides:
getProject in class ProjectComponent
Following copied from class: org.apache.tools.ant.ProjectComponent
Returns:
the components's project.

setLocation

public void setLocation(java.io.File location)
                 throws BuildException
Adds a element definition to the path.
Parameters:
location - the location of the element to add (must not be null nor empty.

setPath

public void setPath(java.lang.String path)
             throws BuildException
Parses a path definition and creates single PathElements.
Parameters:
path - the path definition.

setRefid

public void setRefid(Reference r)
              throws BuildException
Makes this instance in effect a reference to another Path instance.

You must not set another attribute or nest elements inside this element if you make it a reference.

Overrides:
setRefid in class DataType

createPathElement

public Path.PathElement createPathElement()
                                   throws BuildException
Creates the nested <pathelement> element.

addFileset

public void addFileset(FileSet fs)
                throws BuildException
Adds a nested <fileset> element.

createPath

public Path createPath()
                throws BuildException
Creates a nested <path> element.

append

public void append(Path other)
Append the contents of the other Path instance to this.

addExisting

public void addExisting(Path source)
Adds the components on the given path which exist to this Path. Components that don't exist, aren't added.
Parameters:
source - - source path whose components are examined for existence

list

public java.lang.String[] list()
Returns all path elements defined by this and nested path objects.
Returns:
list of path elements.

toString

public java.lang.String toString()
Returns a textual representation of the path, which can be used as CLASSPATH or PATH environment variable definition.
Overrides:
toString in class java.lang.Object
Returns:
a textual representation of the path.

translatePath

public static java.lang.String[] translatePath(Project project,
                                               java.lang.String source)
Splits a PATH (with : or ; as separators) into its parts.

translateFile

public static java.lang.String translateFile(java.lang.String source)
Returns its argument with all file separator characters replaced so that they match the local OS conventions.

translateFileSep

protected static boolean translateFileSep(java.lang.StringBuffer buffer,
                                          int pos)
Translates all occurrences of / or \ to correct separator of the current platform and returns whether it had to do any replacements.

size

public int size()
How many parts does this Path instance consist of.

clone

public java.lang.Object clone()
Return a Path that holds the same elements as this instance.
Overrides:
clone in class java.lang.Object

dieOnCircularReference

protected void dieOnCircularReference(java.util.Stack stk,
                                      Project p)
                               throws BuildException
Overrides the version of DataType to recurse on all DataType child elements that may have been added.
Overrides:
dieOnCircularReference in class DataType

concatSystemClasspath

public Path concatSystemClasspath()
Concatenates the system class path in the order specified by the ${build.sysclasspath} property - using "last" as default value.

concatSystemClasspath

public Path concatSystemClasspath(java.lang.String defValue)
Concatenates the system class path in the order specified by the ${build.sysclasspath} property - using the supplied value if ${build.sysclasspath} has not been set.


Includes only those classes commonly used by task writers. The Ant 1.4.1 distribution includes complete Javadoc for all classes included in Ant, though in most cases these are not intended as APIs.