*
* <someelement>
* The element
* <acommandline executable="/executable/to/run">
* <argument value="argument 1" />
* <argument line="argument_1 argument_2 argument_3" />
* <argument value="argument 4" />
* </acommandline>
* </someelement>
* someelement must provide a method
* createAcommandline which returns an instance of this class.
*
* @author thomas.haas@softwired-inc.com
*/
public class Commandline {
private Vector definition = new Vector();
private String executable = null;
private Argument argument = null;
/**
* Used for nested xml command line definitions.
*/
public class Argument {
/**
* Sets a single commandline argument.
*
* @param value a single commandline argument.
*/
public void setValue(String value) {
Commandline.this.addValue(value);
}
/**
* Line to split into several commandline arguments.
*
* @param line line to split into several commandline arguments
*/
public void setLine(String line) {
Commandline.this.addLine(translateCommandline(line));
}
}
/**
* Creates an argument object.
* Each commandline object has at most one instance of the argument class.
* @return the argument object.
*/
public Argument createArgument() {
if (argument == null) {
argument = new Argument();
}
return argument;
}
/**
* Sets the executable to run.
*/
public void setExecutable(String executable) {
if (executable == null || executable.length() == 0) return;
this.executable = executable;
}
public String getExecutable() {
return executable;
}
public void addValue(String value) {
if (value == null || value.length() == 0) return;
definition.addElement(value);
}
public void addLine(String[] line) {
for (int i=0; i < line.length; i++) {
createArgument().setValue(line[i]);
}
}
/**
* Returns the executable and all defined arguments.
*/
public String[] getCommandline() {
if (executable == null) return getArguments();
final String[] args = getArguments();
final String[] result = new String[args.length+1];
result[0] = executable;
System.arraycopy(args, 0, result, 1, args.length);
return result;
}
/**
* Returns all arguments defined by addLine,
* addValue or the argument object.
*/
public String[] getArguments() {
final String [] result;
result = new String[definition.size()];
definition.copyInto(result);
return result;
}
public String toString() {
return toString(getCommandline());
}
public static String toString(String [] line) {
// empty path return empty string
if (line.length == 0) return "";
// path containing one or more elements
final StringBuffer result = new StringBuffer(line[0]);
for (int i=1; i < line.length; i++) {
result.append(' ');
result.append(line[i]);
}
return result.toString();
}
public static String[] translateCommandline(String to_process) {
// Runtime uses the same tokenizer.
final StringTokenizer token = new StringTokenizer(to_process);
final Commandline result = new Commandline();
while (token.hasMoreTokens()) {
result.addValue(token.nextToken());
}
return result.getArguments();
}
}