org.apache.tools.ant.taskdefs
Class PathConvert

java.lang.Object
  extended by org.apache.tools.ant.ProjectComponent
      extended by org.apache.tools.ant.Task
          extended by org.apache.tools.ant.taskdefs.PathConvert
All Implemented Interfaces:
java.lang.Cloneable

public class PathConvert
extends Task

Converts path and classpath information to a specific target OS format. The resulting formatted path is placed into the specified property.

Since:
Ant 1.4

Nested Class Summary
 class PathConvert.MapEntry
          Helper class, holds the nested <map> values.
static class PathConvert.TargetOs
          An enumeration of supported targets: "windows", "unix", "netware", and "os/2".
 
Field Summary
 
Fields inherited from class org.apache.tools.ant.Task
target, taskName, taskType, wrapper
 
Fields inherited from class org.apache.tools.ant.ProjectComponent
description, location, project
 
Constructor Summary
PathConvert()
          Construct a new instance of the PathConvert task.
 
Method Summary
 void add(FileNameMapper fileNameMapper)
          Add a nested filenamemapper.
 void add(ResourceCollection rc)
          Add an arbitrary ResourceCollection.
 void addMapper(Mapper mapper)
          Add a mapper to convert the file names.
 PathConvert.MapEntry createMap()
          Create a nested MAP element.
 Path createPath()
          Create a nested path element.
 void execute()
          Do the execution.
 boolean isReference()
          Learn whether the refid attribute of this element been set.
 void setDirSep(java.lang.String sep)
          Set the default directory separator string; defaults to current JVM File.separator.
 void setPathSep(java.lang.String sep)
          Set the default path separator string; defaults to current JVM File.pathSeparator.
 void setProperty(java.lang.String p)
          Set the name of the property into which the converted path will be placed.
 void setRefid(Reference r)
          Add a reference to a Path, FileSet, DirSet, or FileList defined elsewhere.
 void setSetonempty(boolean setonempty)
          Set whether the specified property will be set if the result is the empty string.
 void setTargetos(PathConvert.TargetOs target)
          Set targetos to a platform to one of "windows", "unix", "netware", or "os/2"; current platform settings are used by default.
 void setTargetos(java.lang.String target)
          Deprecated. since 1.5.x. Use the method taking a TargetOs argument instead.
 
Methods inherited from class org.apache.tools.ant.Task
bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType
 
Methods inherited from class org.apache.tools.ant.ProjectComponent
clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PathConvert

public PathConvert()
Construct a new instance of the PathConvert task.

Method Detail

createPath

public Path createPath()
Create a nested path element.

Returns:
a Path to be used by Ant reflection.

add

public void add(ResourceCollection rc)
Add an arbitrary ResourceCollection.

Parameters:
rc - the ResourceCollection to add.
Since:
Ant 1.7

createMap

public PathConvert.MapEntry createMap()
Create a nested MAP element.

Returns:
a Map to configure.

setTargetos

public void setTargetos(java.lang.String target)
Deprecated. since 1.5.x. Use the method taking a TargetOs argument instead.

Set targetos to a platform to one of "windows", "unix", "netware", or "os/2"; current platform settings are used by default.

Parameters:
target - the target os.
See Also:
setTargetos(PathConvert.TargetOs)

setTargetos

public void setTargetos(PathConvert.TargetOs target)
Set targetos to a platform to one of "windows", "unix", "netware", or "os/2"; current platform settings are used by default.

Parameters:
target - the target os
Since:
Ant 1.5

setSetonempty

public void setSetonempty(boolean setonempty)
Set whether the specified property will be set if the result is the empty string.

Parameters:
setonempty - true or false.
Since:
Ant 1.5

setProperty

public void setProperty(java.lang.String p)
Set the name of the property into which the converted path will be placed.

Parameters:
p - the property name.

setRefid

public void setRefid(Reference r)
Add a reference to a Path, FileSet, DirSet, or FileList defined elsewhere.

Parameters:
r - the reference to a path, fileset, dirset or filelist.

setPathSep

public void setPathSep(java.lang.String sep)
Set the default path separator string; defaults to current JVM File.pathSeparator.

Parameters:
sep - path separator string.

setDirSep

public void setDirSep(java.lang.String sep)
Set the default directory separator string; defaults to current JVM File.separator.

Parameters:
sep - directory separator string.

isReference

public boolean isReference()
Learn whether the refid attribute of this element been set.

Returns:
true if refid is valid.

execute

public void execute()
             throws BuildException
Do the execution.

Overrides:
execute in class Task
Throws:
BuildException - if something is invalid.

addMapper

public void addMapper(Mapper mapper)
Add a mapper to convert the file names.

Parameters:
mapper - a Mapper value.

add

public void add(FileNameMapper fileNameMapper)
Add a nested filenamemapper.

Parameters:
fileNameMapper - the mapper to add.
Since:
Ant 1.6.3