* <sometask>
* <somepath>
* <element location="/path/to/file.jar" />
* <element path="/path/to/file2.jar:/path/to/class2;/path/to/class3" />
* <element location="/path/to/file3.jar" />
* <element 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
* path.
*
* 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.
*
* @author Thomas.Haas@softwired-inc.com
*/
public class Path {
private Vector definition = new Vector();
/**
* Adds a element definition to the path.
* @param location the location of the element to add (must not be
* null nor empty.
**/
public void setLocation(String location) {
if (location != null && location.length() > 0) {
definition.addElement(translateFile(location));
}
}
/**
* Parses a path definition and creates single PatheElements.
* @param path the path definition.
*/
public void setPath(String path) {
final Vector elements = translatePath(path);
for (int i=0; i < elements.size(); i++) {
definition.addElement(elements.elementAt(i));
}
}
public Path createElement() {
return this;
}
/**
* Returns all path elements defined by this and netsed path objects.
* @return list of path elements.
*/
public String[] list() {
final String[] result = new String[definition.size()];
definition.copyInto(result);
return result;
}
/**
* Returns a textual representation of the path, which can be used as
* CLASSPATH or PATH environment variable definition.
* @return a textual representation of the path.
*/
public String toString() {
final String[] list = list();
// empty path return empty string
if (list.length == 0) return "";
// path containing one or more elements
final StringBuffer result = new StringBuffer(list[0].toString());
for (int i=1; i < list.length; i++) {
result.append(File.pathSeparatorChar);
result.append(list[i]);
}
return result.toString();
}
public static Vector translatePath(String source) {
final Vector result = new Vector();
if (source == null) return result;
final boolean DETECT_DOS = (File.pathSeparatorChar == ';');
final StringBuffer path = new StringBuffer(source);
int start = 0;
for (int i=0; i < path.length(); i++) {
final char c = path.charAt(i);
// FILE SEPARATOR CONVERSION
if (c == '/' || c == '\\') {
path.setCharAt(i, File.separatorChar);
continue;
}
// DOS PATH DETECTION: SECOND CHARACTER IN ELEMENT IS :
if (DETECT_DOS &&
c == ':' &&
(i - start) == 1) {
continue;
}
// PATH SEPERATOR DETECTION ON ':' AND ';' AND CURRENT PLATFORM
if (c == ':' || c == ';' || c == File.pathSeparatorChar) {
// EMPTY ELEMENT DETECTION
if (start < i) {
result.addElement(path.substring(start, i));
}
start = i+1;
}
}
if (start < (path.length())) {
result.addElement(path.substring(start));
}
return result;
}
public static String translateFile(String source) {
if (source == null) return "";
final StringBuffer result = new StringBuffer(source);
for (int i=0; i < result.length(); i++) {
final char c = result.charAt(i);
if (c == '/' || c == '\\') {
result.setCharAt(i, File.separatorChar);
}
}
return result.toString();
}
}