Commandline (Plexus Common Utilities 3.1.1 API)

java.lang.Object
- org.codehaus.plexus.util.cli.Commandline

All Implemented Interfaces:

Cloneable
```
public class Commandline
extends Object
implements Cloneable
```
Commandline objects help handling command lines specifying processes to execute.

The class can be used to define a command line as nested elements or as a helper to define a command line by an application.
<someelement> <acommandline executable="/executable/to/run"> <argument value="argument 1" /> <argument line="argument_1 argument_2 argument_3" /> <argument value="argument 4" /> </acommandline> </someelement>
The element someelement must provide a method createAcommandline which returns an instance of this class.

Author:

[email protected], Stefan Bodewig

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Commandline.Argument

class Commandline.Marker
Class to keep track of the position of an Argument.

Nested Classes
Modifier and Type	Class and Description
`static class`	`Commandline.Argument`
`class`	`Commandline.Marker` Class to keep track of the position of an Argument.

Field Summary

Fields
Modifier and Type	Field and Description
`protected Vector<Arg>`	`arguments`
`protected Map<String,String>`	`envVars`
`protected String`	`executable` Deprecated. Use `setExecutable(String)` instead.
`protected static String`	`OS_NAME` Deprecated. Use `Os` class instead.
`protected static String`	`WINDOWS` Deprecated. Use `Os` class instead.

Constructor Summary

Constructors
Constructor and Description
`Commandline()` Create a new command line object.
`Commandline(Shell shell)` Create a new command line object.
`Commandline(String toProcess)` Create a new command line object, given a command following POSIX sh quoting rules
`Commandline(String toProcess, Shell shell)` Create a new command line object.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addArg(Arg argument)` Adds an argument object to our list of args.
`void`	`addArg(Arg argument, boolean insertAtStart)` Adds an argument object to our list of args.
`void`	`addArguments(String[] line)`
`void`	`addEnvironment(String name, String value)` Add an environment variable
`void`	`addSystemEnvironment()` Add system environment variables
`void`	`clear()` Clear out the whole command line.
`void`	`clearArgs()` Clear out the arguments but leave the executable in place for another operation.
`Object`	`clone()`
`Arg`	`createArg()` Creates an argument object.
`Arg`	`createArg(boolean insertAtStart)` Creates an argument object and adds it to our list of args.
`Commandline.Argument`	`createArgument()` Deprecated. Use `createArg()` instead
`Commandline.Argument`	`createArgument(boolean insertAtStart)` Deprecated. Use `createArg(boolean)` instead
`Commandline.Marker`	`createMarker()` Return a marker.
`Process`	`execute()` Executes the command.
`String[]`	`getArguments()` Returns all arguments defined by `addLine`, `addValue` or the argument object.
`String[]`	`getCommandline()` Returns the executable and all defined arguments.
`String[]`	`getEnvironmentVariables()` Return the list of environment variables
`String`	`getExecutable()` Return an executable name, quoted for shell use.
`String`	`getLiteralExecutable()`
`long`	`getPid()`
`Shell`	`getShell()` Get the shell to be used in this command line.
`String[]`	`getShellCommandline()` Returns the shell, executable and all defined arguments.
`Properties`	`getSystemEnvVars()`
`File`	`getWorkingDirectory()`
`static String`	`quoteArgument(String argument)` Deprecated. Use `CommandLineUtils.quote(String)` instead.
`void`	`setExecutable(String executable)` Sets the executable to run.
`void`	`setPid(long pid)`
`void`	`setShell(Shell shell)` Allows to set the shell to be used in this command line.
`void`	`setWorkingDirectory(File workingDirectory)` Sets execution directory.
`void`	`setWorkingDirectory(String path)` Sets execution directory.
`int`	`size()`
`String`	`toString()`
`static String`	`toString(String[] line)` Deprecated. Use `CommandLineUtils.toString(String[])` instead.
`static String[]`	`translateCommandline(String toProcess)` Deprecated. Use `CommandLineUtils.translateCommandline(String)` instead.

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - OS_NAME
```
protected static final String OS_NAME
```
    Deprecated. Use Os class instead.
    
    See Also:
    
    Constant Field Values
  - WINDOWS
```
protected static final String WINDOWS
```
    Deprecated. Use Os class instead.
    
    See Also:
    
    Constant Field Values
  - arguments
```
protected Vector<Arg> arguments
```
  - envVars
```
protected Map<String,String> envVars
```
  - executable
```
protected String executable
```
    Deprecated. Use setExecutable(String) instead.
- Constructor Detail
  - Commandline
```
public Commandline(String toProcess,
                   Shell shell)
```
    Create a new command line object. Shell is autodetected from operating system Shell usage is only desirable when generating code for remote execution.
    
    Parameters:
    
    toProcess -
  - Commandline
```
public Commandline(Shell shell)
```
    Create a new command line object. Shell is autodetected from operating system Shell usage is only desirable when generating code for remote execution.
  - Commandline
```
public Commandline(String toProcess)
```
    Create a new command line object, given a command following POSIX sh quoting rules
    
    Parameters:
    
    toProcess -
  - Commandline
```
public Commandline()
```
    Create a new command line object.
- Method Detail
  - getPid
```
public long getPid()
```
  - setPid
```
public void setPid(long pid)
```
  - createArgument
```
public Commandline.Argument createArgument()
```
    Deprecated. Use createArg() instead
    
    Creates an argument object.
    
    Each commandline object has at most one instance of the argument class. This method calls this.createArgument(false).
    
    Returns:
    
    the argument object.
    
    See Also:
    
    createArgument(boolean)
  - createArgument
```
public Commandline.Argument createArgument(boolean insertAtStart)
```
    Deprecated. Use createArg(boolean) instead
    
    Creates an argument object and adds it to our list of args.
    
    Each commandline object has at most one instance of the argument class.
    
    Parameters:
    
    insertAtStart - if true, the argument is inserted at the beginning of the list of args, otherwise it is appended.
  - createArg
```
public Arg createArg()
```
    Creates an argument object.
    
    Each commandline object has at most one instance of the argument class. This method calls this.createArgument(false).
    
    Returns:
    
    the argument object.
    
    See Also:
    
    createArgument(boolean)
  - createArg
```
public Arg createArg(boolean insertAtStart)
```
    Creates an argument object and adds it to our list of args.
    
    Each commandline object has at most one instance of the argument class.
    
    Parameters:
    
    insertAtStart - if true, the argument is inserted at the beginning of the list of args, otherwise it is appended.
  - addArg
```
public void addArg(Arg argument)
```
    Adds an argument object to our list of args.
    
    See Also:
    
    addArg(Arg,boolean)
  - addArg
```
public void addArg(Arg argument,
                   boolean insertAtStart)
```
    Adds an argument object to our list of args.
    
    Parameters:
    
    insertAtStart - if true, the argument is inserted at the beginning of the list of args, otherwise it is appended.
  - setExecutable
```
public void setExecutable(String executable)
```
    Sets the executable to run.
  - getLiteralExecutable
```
public String getLiteralExecutable()
```
    Returns:
    
    Executable to be run, as a literal string (no shell quoting/munging)
  - getExecutable
```
public String getExecutable()
```
    Return an executable name, quoted for shell use. Shell usage is only desirable when generating code for remote execution.
    
    Returns:
    
    Executable to be run, quoted for shell interpretation
  - addArguments
```
public void addArguments(String[] line)
```
  - addEnvironment
```
public void addEnvironment(String name,
                           String value)
```
    Add an environment variable
  - addSystemEnvironment
```
public void addSystemEnvironment()
                          throws Exception
```
    Add system environment variables
    
    Throws:
    
    Exception
  - getEnvironmentVariables
```
public String[] getEnvironmentVariables()
                                 throws CommandLineException
```
    Return the list of environment variables
    
    Throws:
    
    CommandLineException
  - getCommandline
```
public String[] getCommandline()
```
    Returns the executable and all defined arguments.
    For Windows Family, getShellCommandline() is returned
  - getShellCommandline
```
public String[] getShellCommandline()
```
    Returns the shell, executable and all defined arguments. Shell usage is only desirable when generating code for remote execution.
  - getArguments
```
public String[] getArguments()
```
    Returns all arguments defined by addLine, addValue or the argument object.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - size
```
public int size()
```
  - clone
```
public Object clone()
```
    Overrides:
    
    clone in class Object
  - clear
```
public void clear()
```
    Clear out the whole command line.
  - clearArgs
```
public void clearArgs()
```
    Clear out the arguments but leave the executable in place for another operation.
  - createMarker
```
public Commandline.Marker createMarker()
```
    Return a marker.
    
    This marker can be used to locate a position on the commandline - to insert something for example - when all parameters have been set.
  - setWorkingDirectory
```
public void setWorkingDirectory(String path)
```
    Sets execution directory.
  - setWorkingDirectory
```
public void setWorkingDirectory(File workingDirectory)
```
    Sets execution directory.
  - getWorkingDirectory
```
public File getWorkingDirectory()
```
  - execute
```
public Process execute()
                throws CommandLineException
```
    Executes the command.
    
    Throws:
    
    CommandLineException
  - getSystemEnvVars
```
public Properties getSystemEnvVars()
                            throws Exception
```
    Throws:
    
    Exception
  - setShell
```
public void setShell(Shell shell)
```
    Allows to set the shell to be used in this command line. Shell usage is only desirable when generating code for remote execution.
    
    Parameters:
    
    shell -
    
    Since:
    
    1.2
  - getShell
```
public Shell getShell()
```
    Get the shell to be used in this command line. Shell usage is only desirable when generating code for remote execution.
    
    Since:
    
    1.2
  - translateCommandline
```
public static String[] translateCommandline(String toProcess)
                                     throws Exception
```
    Deprecated. Use CommandLineUtils.translateCommandline(String) instead.
    
    Throws:
    
    Exception
  - quoteArgument
```
public static String quoteArgument(String argument)
                            throws CommandLineException
```
    Deprecated. Use CommandLineUtils.quote(String) instead.
    
    Throws:
    
    CommandLineException
  - toString
```
public static String toString(String[] line)
```
    Deprecated. Use CommandLineUtils.toString(String[]) instead.

Class Commandline

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

OS_NAME

WINDOWS

arguments

envVars

executable

Constructor Detail

Commandline

Commandline

Commandline

Commandline

Method Detail

getPid

setPid

createArgument

createArgument

createArg

createArg

addArg

addArg

setExecutable

getLiteralExecutable

getExecutable

addArguments

addEnvironment

addSystemEnvironment

getEnvironmentVariables

getCommandline

getShellCommandline

getArguments

toString

size

clone

clear

clearArgs

createMarker

setWorkingDirectory

setWorkingDirectory

getWorkingDirectory

execute

getSystemEnvVars

setShell

getShell

translateCommandline

quoteArgument

toString