org.apache.tools.ant
public class Project extends Object
This class also encapsulates methods which allow files to be referred to using abstract path names which are translated to native system file paths at runtime.
Field Summary | |
---|---|
static String | JAVA_1_0
Version constant for Java 1.0 .
|
static String | JAVA_1_1
Version constant for Java 1.1 .
|
static String | JAVA_1_2
Version constant for Java 1.2 .
|
static String | JAVA_1_3
Version constant for Java 1.3 .
|
static String | JAVA_1_4
Version constant for Java 1.4 .
|
static int | MSG_DEBUG Message priority of "debug". |
static int | MSG_ERR Message priority of "error". |
static int | MSG_INFO Message priority of "information". |
static int | MSG_VERBOSE Message priority of "verbose". |
static int | MSG_WARN Message priority of "warning". |
static String | TOKEN_END Default filter end token. |
static String | TOKEN_START Default filter start token. |
Constructor Summary | |
---|---|
Project()
Create a new Ant project. |
Method Summary | |
---|---|
void | addBuildListener(BuildListener listener)
Add a build listener to the list. |
void | addDataTypeDefinition(String typeName, Class typeClass)
Add a new datatype definition.
|
void | addFilter(String token, String value)
Add a filter to the set of global filters.
|
void | addOrReplaceTarget(Target target)
Add a target to the project, or replaces one with the same
name.
|
void | addOrReplaceTarget(String targetName, Target target)
Add a target to the project, or replaces one with the same
name.
|
void | addReference(String name, Object value)
Add a reference to the project.
|
void | addTarget(Target target)
Add a new target to the project.
|
void | addTarget(String targetName, Target target)
Add a new target to the project.
|
void | addTaskDefinition(String taskName, Class taskClass)
Add a new task definition to the project.
|
void | checkTaskClass(Class taskClass)
Check whether or not a class is suitable for serving as Ant task.
|
void | copyFile(String sourceFile, String destFile)
Convenience method to copy a file from a source to a destination.
|
void | copyFile(String sourceFile, String destFile, boolean filtering)
Convenience method to copy a file from a source to a destination
specifying if token filtering should be used.
|
void | copyFile(String sourceFile, String destFile, boolean filtering, boolean overwrite)
Convenience method to copy a file from a source to a
destination specifying if token filtering should be used and if
source files may overwrite newer destination files.
|
void | copyFile(String sourceFile, String destFile, boolean filtering, boolean overwrite, boolean preserveLastModified)
Convenience method to copy a file from a source to a
destination specifying if token filtering should be used, if
source files may overwrite newer destination files, and if the
last modified time of the resulting file should be set to
that of the source file.
|
void | copyFile(File sourceFile, File destFile)
Convenience method to copy a file from a source to a destination.
|
void | copyFile(File sourceFile, File destFile, boolean filtering)
Convenience method to copy a file from a source to a destination
specifying if token filtering should be used.
|
void | copyFile(File sourceFile, File destFile, boolean filtering, boolean overwrite)
Convenience method to copy a file from a source to a
destination specifying if token filtering should be used and if
source files may overwrite newer destination files.
|
void | copyFile(File sourceFile, File destFile, boolean filtering, boolean overwrite, boolean preserveLastModified)
Convenience method to copy a file from a source to a
destination specifying if token filtering should be used, if
source files may overwrite newer destination files, and if the
last modified time of the resulting file should be set to
that of the source file.
|
void | copyInheritedProperties(Project other)
Copy all user properties that have not been set on the
command line or a GUI tool from this instance to the Project
instance given as the argument.
|
void | copyUserProperties(Project other)
Copy all user properties that have been set on the command
line or a GUI tool from this instance to the Project instance
given as the argument.
|
AntClassLoader | createClassLoader(Path path)
Factory method to create a class loader for loading classes from
a given path.
|
Object | createDataType(String typeName)
Create a new instance of a data type.
|
Task | createTask(String taskType)
Create a new instance of a task, adding it to a list of
created tasks for later invalidation. |
int | defaultInput(byte[] buffer, int offset, int length)
Read data from the default input stream. |
void | demuxFlush(String output, boolean isError)
Demultiplex flush operations so that each task receives the appropriate
messages. |
int | demuxInput(byte[] buffer, int offset, int length)
Demux an input request to the correct task.
|
void | demuxOutput(String output, boolean isWarning)
Demultiplex output so that each task receives the appropriate
messages. |
void | executeSortedTargets(Vector sortedTargets)
Execute a Vector of sorted targets. |
void | executeTarget(String targetName)
Execute the specified target and any targets it depends on.
|
void | executeTargets(Vector names)
Execute the specified sequence of targets, and the targets
they depend on.
|
void | fireBuildFinished(Throwable exception)
Send a "build finished" event to the build listeners
for this project. |
void | fireBuildStarted()
Send a "build started" event
to the build listeners for this project. |
protected void | fireMessageLogged(Project project, String message, int priority)
Send a "message logged" project level event
to the build listeners for this project.
|
protected void | fireMessageLogged(Target target, String message, int priority)
Send a "message logged" target level event
to the build listeners for this project.
|
protected void | fireMessageLogged(Task task, String message, int priority)
Send a "message logged" task level event
to the build listeners for this project.
|
void | fireSubBuildFinished(Throwable exception)
Send a "subbuild finished" event to the build listeners for
this project. |
void | fireSubBuildStarted()
Send a "subbuild started" event to the build listeners for
this project.
|
protected void | fireTargetFinished(Target target, Throwable exception)
Send a "target finished" event to the build listeners
for this project.
|
protected void | fireTargetStarted(Target target)
Send a "target started" event to the build listeners
for this project.
|
protected void | fireTaskFinished(Task task, Throwable exception)
Send a "task finished" event to the build listeners for this
project.
|
protected void | fireTaskStarted(Task task)
Send a "task started" event to the build listeners
for this project.
|
File | getBaseDir()
Return the base directory of the project as a file object.
|
Vector | getBuildListeners()
Return a copy of the list of build listeners for the project.
|
ClassLoader | getCoreLoader()
Return the core classloader to use for this project.
|
Hashtable | getDataTypeDefinitions()
Return the current datatype definition hashtable. |
InputStream | getDefaultInputStream()
Get this project's input stream.
|
String | getDefaultTarget()
Return the name of the default target of the project. |
String | getDescription()
Return the project description, if one has been set.
|
String | getElementName(Object element)
Return a description of the type of the given element, with
special handling for instances of tasks and data types.
|
Executor | getExecutor()
Get this Project's Executor (setting it if necessary). |
Hashtable | getFilters()
Return a hashtable of global filters, mapping tokens to values.
|
FilterSet | getGlobalFilterSet()
Return the set of global filters.
|
InputHandler | getInputHandler()
Retrieve the current input handler.
|
static String | getJavaVersion()
Return the version of Java this class is running under. |
String | getName()
Return the project name, if one has been set.
|
Hashtable | getProperties()
Return a copy of the properties table. |
String | getProperty(String name)
Return the value of a property, if it is set.
|
Object | getReference(String key)
Look up a reference by its key (ID).
|
Hashtable | getReferences()
Return a map of the references in the project (String to Object).
|
Hashtable | getTargets()
Return the hashtable of targets. |
Hashtable | getTaskDefinitions()
Return the current task definition hashtable. |
Task | getThreadTask(Thread thread)
Get the current task associated with a thread, if any.
|
Hashtable | getUserProperties()
Return a copy of the user property hashtable. |
String | getUserProperty(String name)
Return the value of a user property, if it is set.
|
void | init()
Initialise the project.
|
void | initSubProject(Project subProject)
Init a sub project--used by taskdefs.Ant . |
boolean | isKeepGoingMode()
Return the keep-going mode. |
void | log(String message)
Write a message to the log with the default log level
of MSG_INFO . |
void | log(String message, int msgLevel)
Write a project level message to the log with the given log level. |
void | log(Task task, String message, int msgLevel)
Write a task level message to the log with the given log level. |
void | log(Target target, String message, int msgLevel)
Write a target level message to the log with the given log level. |
void | registerThreadTask(Thread thread, Task task)
Register a task as the current task for a thread.
|
void | removeBuildListener(BuildListener listener)
Remove a build listener from the list. |
String | replaceProperties(String value)
Replace ${} style constructions in the given value with the
string value of the corresponding data types.
|
File | resolveFile(String fileName, File rootDir)
Return the canonical form of a filename.
|
File | resolveFile(String fileName)
Return the canonical form of a filename.
|
void | setBasedir(String baseD)
Set the base directory for the project, checking that
the given filename exists and is a directory.
|
void | setBaseDir(File baseDir)
Set the base directory for the project, checking that
the given file exists and is a directory.
|
void | setCoreLoader(ClassLoader coreLoader)
Set the core classloader for the project. |
void | setDefault(String defaultTarget)
Set the default target of the project.
|
void | setDefaultInputStream(InputStream defaultInputStream)
Set the default System input stream. |
void | setDefaultTarget(String defaultTarget)
Set the default target of the project.
|
void | setDescription(String description)
Set the project description.
|
void | setExecutor(Executor e)
Set the Executor instance for this Project. |
void | setFileLastModified(File file, long time)
Call File.setLastModified(long time) on Java above 1.1, and logs
a warning on Java 1.1.
|
void | setInheritedProperty(String name, String value)
Set a user property, which cannot be overwritten by set/unset
property calls. |
void | setInputHandler(InputHandler handler)
Set the input handler.
|
void | setJavaVersionProperty()
Set the ant.java.version property and tests for
unsupported JVM versions. |
void | setKeepGoingMode(boolean keepGoingMode)
Set "keep-going" mode. |
void | setName(String name)
Set the name of the project, also setting the user
property ant.project.name .
|
void | setNewProperty(String name, String value)
Set a property if no value currently exists. |
void | setProjectReference(Object obj)
Set a reference to this Project on the parameterized object.
|
void | setProperty(String name, String value)
Set a property. |
void | setSystemProperties()
Add all system properties which aren't already defined as
user properties to the project properties. |
void | setUserProperty(String name, String value)
Set a user property, which cannot be overwritten by
set/unset property calls. |
static boolean | toBoolean(String s)
Return the boolean equivalent of a string, which is considered
true if either "on" , "true" ,
or "yes" is found, ignoring case.
|
Vector | topoSort(String root, Hashtable targets)
Topologically sort a set of targets. |
Vector | topoSort(String root, Hashtable targets, boolean returnAll)
Topologically sort a set of targets. |
Vector | topoSort(String[] root, Hashtable targets, boolean returnAll)
Topologically sort a set of targets.
|
static String | translatePath(String toProcess)
Translate a path into its native (platform specific) format.
|
Deprecated: Use {@link JavaEnvUtils#JAVA_1_0} instead.
Version constant for Java 1.0 .Deprecated: Use {@link JavaEnvUtils#JAVA_1_1} instead.
Version constant for Java 1.1 .Deprecated: Use {@link JavaEnvUtils#JAVA_1_2} instead.
Version constant for Java 1.2 .Deprecated: Use {@link JavaEnvUtils#JAVA_1_3} instead.
Version constant for Java 1.3 .Deprecated: Use {@link JavaEnvUtils#JAVA_1_4} instead.
Version constant for Java 1.4 .Parameters: listener The listener to add to the list.
Must not be null
.
Parameters: typeName The name of the datatype.
Must not be null
. typeClass The full name of the class implementing the datatype.
Must not be null
.
Deprecated: Use getGlobalFilterSet().addFilter(token,value)
Add a filter to the set of global filters.Parameters: token The token to filter.
Must not be null
. value The replacement value.
Must not be null
.
See Also: getGlobalFilterSet addFilter
Parameters: target The target to be added or replaced in the project.
Must not be null
.
Parameters: targetName The name to use for the target.
Must not be null
. target The target to be added or replaced in the project.
Must not be null
.
Parameters: name The name of the reference. Must not be null
. value The value of the reference. Must not be null
.
Parameters: target The target to be added to the project.
Must not be null
.
Throws: BuildException if the target already exists in the project
See Also: Project
Parameters: targetName The name to use for the target.
Must not be null
. target The target to be added to the project.
Must not be null
.
Throws: BuildException if the target already exists in the project.
See Also: Project
Parameters: taskName The name of the task to add.
Must not be null
. taskClass The full name of the class implementing the task.
Must not be null
.
Throws: BuildException if the class is unsuitable for being an Ant task. An error level message is logged before this exception is thrown.
See Also: checkTaskClass
Parameters: taskClass The class to be checked.
Must not be null
.
Throws: BuildException if the class is unsuitable for being an Ant task. An error level message is logged before this exception is thrown.
Deprecated:
Convenience method to copy a file from a source to a destination. No filtering is performed.Parameters: sourceFile Name of file to copy from.
Must not be null
. destFile Name of file to copy to.
Must not be null
.
Throws: IOException if the copying fails.
Deprecated:
Convenience method to copy a file from a source to a destination specifying if token filtering should be used.Parameters: sourceFile Name of file to copy from.
Must not be null
. destFile Name of file to copy to.
Must not be null
. filtering Whether or not token filtering should be used during
the copy.
Throws: IOException if the copying fails.
Deprecated:
Convenience method to copy a file from a source to a destination specifying if token filtering should be used and if source files may overwrite newer destination files.Parameters: sourceFile Name of file to copy from.
Must not be null
. destFile Name of file to copy to.
Must not be null
. filtering Whether or not token filtering should be used during
the copy. overwrite Whether or not the destination file should be
overwritten if it already exists.
Throws: IOException if the copying fails.
Deprecated:
Convenience method to copy a file from a source to a destination specifying if token filtering should be used, if source files may overwrite newer destination files, and if the last modified time of the resulting file should be set to that of the source file.Parameters: sourceFile Name of file to copy from.
Must not be null
. destFile Name of file to copy to.
Must not be null
. filtering Whether or not token filtering should be used during
the copy. overwrite Whether or not the destination file should be
overwritten if it already exists. preserveLastModified Whether or not the last modified time of
the resulting file should be set to that
of the source file.
Throws: IOException if the copying fails.
Deprecated:
Convenience method to copy a file from a source to a destination. No filtering is performed.Parameters: sourceFile File to copy from.
Must not be null
. destFile File to copy to.
Must not be null
.
Throws: IOException if the copying fails.
Deprecated:
Convenience method to copy a file from a source to a destination specifying if token filtering should be used.Parameters: sourceFile File to copy from.
Must not be null
. destFile File to copy to.
Must not be null
. filtering Whether or not token filtering should be used during
the copy.
Throws: IOException if the copying fails.
Deprecated:
Convenience method to copy a file from a source to a destination specifying if token filtering should be used and if source files may overwrite newer destination files.Parameters: sourceFile File to copy from.
Must not be null
. destFile File to copy to.
Must not be null
. filtering Whether or not token filtering should be used during
the copy. overwrite Whether or not the destination file should be
overwritten if it already exists.
Throws: IOException if the file cannot be copied.
Deprecated:
Convenience method to copy a file from a source to a destination specifying if token filtering should be used, if source files may overwrite newer destination files, and if the last modified time of the resulting file should be set to that of the source file.Parameters: sourceFile File to copy from.
Must not be null
. destFile File to copy to.
Must not be null
. filtering Whether or not token filtering should be used during
the copy. overwrite Whether or not the destination file should be
overwritten if it already exists. preserveLastModified Whether or not the last modified time of
the resulting file should be set to that
of the source file.
Throws: IOException if the file cannot be copied.
To copy all "user" properties, you will also have to call {@link #copyUserProperties copyUserProperties}.
Parameters: other the project to copy the properties to. Must not be null.
Since: Ant 1.5
To copy all "user" properties, you will also have to call {@link #copyInheritedProperties copyInheritedProperties}.
Parameters: other the project to copy the properties to. Must not be null.
Since: Ant 1.5
Parameters: path the path from which classes are to be loaded.
Returns: an appropriate classloader.
Parameters: typeName The name of the data type to create an instance of.
Must not be null
.
Returns: an instance of the specified data type, or null
if
the data type name is not recognised.
Throws: BuildException if the data type name is recognised but instance creation fails.
Parameters: taskType The name of the task to create an instance of.
Must not be null
.
Returns: an instance of the specified task, or null
if
the task name is not recognised.
Throws: BuildException if the task name is recognised but task creation fails.
Parameters: buffer the buffer into which data is to be read. offset the offset into the buffer at which data is stored. length the amount of data to read.
Returns: the number of bytes read.
Throws: IOException if the data cannot be read.
Since: Ant 1.6
Parameters: output Message to handle. Should not be null
. isError Whether the text represents an error (true
)
or information (false
).
Since: Ant 1.5.2
Parameters: buffer the buffer into which data is to be read. offset the offset into the buffer at which data is stored. length the amount of data to read.
Returns: the number of bytes read.
Throws: IOException if the data cannot be read.
Since: Ant 1.6
Parameters: output Message to handle. Should not be null
. isWarning Whether the text represents an warning (true
)
or information (false
).
Vector
of sorted targets.Parameters: sortedTargets the aforementioned Vector
.
Throws: BuildException on error.
Parameters: targetName The name of the target to execute.
Must not be null
.
Throws: BuildException if the build failed.
Parameters: names A vector of target name strings to execute.
Must not be null
.
Throws: BuildException if the build failed.
Parameters: exception an exception indicating a reason for a build
failure. May be null
, indicating
a successful build.
Parameters: project The project generating the event.
Should not be null
. message The message to send. Should not be null
. priority The priority of the message.
Parameters: target The target generating the event.
Must not be null
. message The message to send. Should not be null
. priority The priority of the message.
Parameters: task The task generating the event.
Must not be null
. message The message to send. Should not be null
. priority The priority of the message.
Parameters: exception an exception indicating a reason for a build
failure. May be null
, indicating
a successful build.
Since: Ant 1.6.2
Since: Ant 1.6.2
Parameters: target The target which has finished building.
Must not be null
. exception an exception indicating a reason for a build
failure. May be null
, indicating
a successful build.
Parameters: target The target which is starting to build.
Must not be null
.
Parameters: task The task which has finished executing.
Must not be null
. exception an exception indicating a reason for a build
failure. May be null
, indicating
a successful build.
Parameters: task The target which is starting to execute.
Must not be null
.
Returns: the project base directory, or null
if the
base directory has not been successfully set to a valid value.
Returns: a list of build listeners for the project
null
, indicating that
the parent classloader should be used.
Returns: the core classloader to use for this project.
Returns: a map of from datatype name to implementing class (String to Class).
Returns: the InputStream instance in use by this Project instance to read input.
Returns: name of the default target or
null
if no default has been set.
Returns: the project description, or null
if it hasn't
been set.
This is useful for logging purposes.
Parameters: element The element to describe.
Must not be null
.
Returns: a description of the element type.
Since: 1.95, Ant 1.5
Returns: an Executor instance.
Deprecated: Use getGlobalFilterSet().getFilterHash()
Return a hashtable of global filters, mapping tokens to values.Returns: a hashtable of global filters, mapping tokens to values (String to String).
See Also: getGlobalFilterSet getFilterHash
Returns: the set of global filters.
Returns: the InputHandler instance currently in place for the project instance.
Deprecated: use org.apache.tools.ant.util.JavaEnvUtils instead
Return the version of Java this class is running under.Returns: the version of Java as a String, e.g. "1.1" .
See Also: JavaEnvUtils
Returns: the project name, or null
if it hasn't been set.
Returns: a hashtable containing all properties (including user properties).
Parameters: name The name of the property.
May be null
, in which case
the return value is also null
.
Returns: the property value, or null
for no match
or if a null
name is provided.
Parameters: key The key for the desired reference.
Must not be null
.
Returns: the reference with the specified ID, or null
if
there is no such reference in the project.
Returns: a map of the references in the project (String to Object).
Returns: a map from name to target (String to Target).
Returns: a map of from task name to implementing class (String to Class).
Parameters: thread the thread for which the task is required.
Returns: the task which is currently registered for the given thread or null if no task is registered.
Returns: a hashtable containing just the user properties.
Parameters: name The name of the property.
May be null
, in which case
the return value is also null
.
Returns: the property value, or null
for no match
or if a null
name is provided.
Throws: BuildException if the default task list cannot be loaded.
Parameters: subProject the subproject to initialize.
ant.executor.class
property, they will have no effect.Returns: "keep-going" mode
Since: Ant 1.6
Parameters: message The text to log. Should not be null
.
Parameters: message The text to log. Should not be null
. msgLevel The log priority level to use.
Parameters: task The task to use in the log. Must not be null
. message The text to log. Should not be null
. msgLevel The log priority level to use.
Parameters: target The target to use in the log.
Must not be null
. message The text to log. Should not be null
. msgLevel The log priority level to use.
Parameters: thread the thread on which the task is registered. task the task to be registered.
Since: Ant 1.5
Parameters: listener The listener to remove from the list.
Should not be null
.
Parameters: value The string to be scanned for property references.
May be null
.
Returns: the given string with embedded property names replaced
by values, or null
if the given string is
null
.
Throws: BuildException if the given value has an unclosed
property name, e.g. ${xxx
.
Deprecated:
Return the canonical form of a filename.If the specified file name is relative it is resolved with respect to the given root directory.
Parameters: fileName The name of the file to resolve.
Must not be null
.
rootDir The directory respective to which relative file names
are resolved. May be null
, in which case
the current directory is used.
Returns: the resolved File.
If the specified file name is relative it is resolved with respect to the project's base directory.
Parameters: fileName The name of the file to resolve.
Must not be null
.
Returns: the resolved File.
Parameters: baseD The project base directory.
Must not be null
.
Throws: BuildException if the directory if invalid.
Parameters: baseDir The project base directory.
Must not be null
.
Throws: BuildException if the specified file doesn't exist or isn't a directory.
null
classloader is specified, the parent classloader should be used.
Parameters: coreLoader The classloader to use for the project.
May be null
.
Parameters: defaultTarget The name of the default target for this project.
May be null
, indicating that there is
no default target.
Parameters: defaultInputStream the default input stream to use when input is requested.
Since: Ant 1.6
Deprecated: use setDefault
Set the default target of the project.Parameters: defaultTarget The name of the default target for this project.
May be null
, indicating that there is
no default target.
See Also: setDefault
Parameters: description The description of the project.
May be null
.
Parameters: e the Executor to use.
Deprecated:
Call File.setLastModified(long time) on Java above 1.1, and logs a warning on Java 1.1.Parameters: file The file to set the last modified time on.
Must not be null
.
time the required modification time.
Throws: BuildException if the last modified time cannot be set despite running on a platform with a version above 1.1.
Parameters: name The name of property to set.
Must not be null
. value The new value of the property.
Must not be null
.
See Also: setProperty
Parameters: handler the InputHandler instance to use for gathering input.
ant.java.version
property and tests for
unsupported JVM versions. If the version is supported,
verbose log messages are generated to record the Java version
and operating system name.
Throws: BuildException if this Java version is not supported.
See Also: JavaEnvUtils
ant.executor.class
property, they will have no effect.Parameters: keepGoingMode "keep-going" mode
Since: Ant 1.6
ant.project.name
.
Parameters: name The name of the project.
Must not be null
.
Parameters: name The name of property to set.
Must not be null
. value The new value of the property.
Must not be null
.
Since: 1.5
Parameters: obj the object to invoke setProject(this) on.
Parameters: name The name of property to set.
Must not be null
. value The new value of the property.
Must not be null
.
Parameters: name The name of property to set.
Must not be null
. value The new value of the property.
Must not be null
.
See Also: setProperty
true
if either "on"
, "true"
,
or "yes"
is found, ignoring case.
Parameters: s The string to convert to a boolean value.
Returns: true
if the given string is "on"
,
"true"
or "yes"
, or
false
otherwise.
topoSort(new String[] {root}, targets, true)
.
Parameters: root The name of the root target. The sort is created in such
a way that the sequence of Targets up to the root
target is the minimum possible such sequence.
Must not be null
. targets A Hashtable mapping names to Targets.
Must not be null
.
Returns: a Vector of ALL Target objects in sorted order.
Throws: BuildException if there is a cyclic dependency among the targets, or if a named target does not exist.
topoSort(new String[] {root}, targets, returnAll)
.
Parameters: root The name of the root target. The sort is created in such
a way that the sequence of Targets up to the root
target is the minimum possible such sequence.
Must not be null
. targets A Hashtable mapping names to Targets.
Must not be null
. returnAll boolean
indicating whether to return all
targets, or the execution sequence only.
Returns: a Vector of Target objects in sorted order.
Throws: BuildException if there is a cyclic dependency among the targets, or if a named target does not exist.
Since: Ant 1.6.3
Parameters: root String[]
containing the names of the root targets.
The sort is created in such a way that the ordered sequence of
Targets is the minimum possible such sequence to the specified
root targets.
Must not be null
. targets A map of names to targets (String to Target).
Must not be null
. returnAll boolean
indicating whether to return all
targets, or the execution sequence only.
Returns: a Vector of Target objects in sorted order.
Throws: BuildException if there is a cyclic dependency among the targets, or if a named target does not exist.
Since: Ant 1.6.3
This method uses PathTokenizer to separate the input path into its components. This handles DOS style paths in a relatively sensible way. The file separators are then converted to their platform specific versions.
Parameters: toProcess The path to be translated.
May be null
.
Returns: the native version of the specified path or
an empty string if the path is null
or empty.
See Also: PathTokenizer