Commandline

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

All Implemented Interfaces:

java.lang.Cloneable
```
public class Commandline
extends java.lang.Object
implements java.lang.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:

thomas.haas@softwired-inc.com, Stefan Bodewig

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class Commandline.Argument

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

Nested Classes
Modifier and Type	Class	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	Description
`protected java.util.Vector<Arg>`	`arguments`
`protected java.util.Map<java.lang.String,java.lang.String>`	`envVars`
`protected java.lang.String`	`executable`	Deprecated. Use `setExecutable(String)` instead.
`protected static java.lang.String`	`OS_NAME`	Deprecated. Use `Os` class instead.
`protected static java.lang.String`	`WINDOWS`	Deprecated. Use `Os` class instead.

Constructor Summary

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

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	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(java.lang.String[] line)`
`void`	`addEnvironment(java.lang.String name, java.lang.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.
`java.lang.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.
`java.lang.Process`	`execute()`	Executes the command.
`java.lang.String[]`	`getArguments()`	Returns all arguments defined by `addLine`, `addValue` or the argument object.
`java.lang.String[]`	`getCommandline()`	Returns the executable and all defined arguments. For Windows Family, `getShellCommandline()` is returned
`java.lang.String[]`	`getEnvironmentVariables()`	Return the list of environment variables
`java.lang.String`	`getExecutable()`	Return an executable name, quoted for shell use.
`java.lang.String`	`getLiteralExecutable()`
`long`	`getPid()`
`Shell`	`getShell()`	Get the shell to be used in this command line.
`java.lang.String[]`	`getShellCommandline()`	Returns the shell, executable and all defined arguments.
`java.util.Properties`	`getSystemEnvVars()`
`java.io.File`	`getWorkingDirectory()`
`static java.lang.String`	`quoteArgument(java.lang.String argument)`	Deprecated. Use `CommandLineUtils.quote(String)` instead.
`void`	`setExecutable(java.lang.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(java.io.File workingDirectory)`	Sets execution directory.
`void`	`setWorkingDirectory(java.lang.String path)`	Sets execution directory.
`int`	`size()`
`java.lang.String`	`toString()`
`static java.lang.String`	`toString(java.lang.String[] line)`	Deprecated. Use `CommandLineUtils.toString(String[])` instead.
`static java.lang.String[]`	`translateCommandline(java.lang.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 java.lang.String OS_NAME
```
    Deprecated. Use Os class instead.
    
    See Also:
    
    Constant Field Values
  - WINDOWS
```
protected static final java.lang.String WINDOWS
```
    Deprecated. Use Os class instead.
    
    See Also:
    
    Constant Field Values
  - arguments
```
protected java.util.Vector<Arg> arguments
```
  - envVars
```
protected java.util.Map<java.lang.String,java.lang.String> envVars
```
  - executable
```
protected java.lang.String executable
```
    Deprecated. Use setExecutable(String) instead.
- Constructor Detail
  - Commandline
```
public Commandline(java.lang.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(java.lang.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(java.lang.String executable)
```
    Sets the executable to run.
  - getLiteralExecutable
```
public java.lang.String getLiteralExecutable()
```
    Returns:
    
    Executable to be run, as a literal string (no shell quoting/munging)
  - getExecutable
```
public java.lang.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(java.lang.String[] line)
```
  - addEnvironment
```
public void addEnvironment(java.lang.String name,
                           java.lang.String value)
```
    Add an environment variable
  - addSystemEnvironment
```
public void addSystemEnvironment()
                          throws java.lang.Exception
```
    Add system environment variables
    
    Throws:
    
    java.lang.Exception
  - getEnvironmentVariables
```
public java.lang.String[] getEnvironmentVariables()
                                           throws CommandLineException
```
    Return the list of environment variables
    
    Throws:
    
    CommandLineException
  - getCommandline
```
public java.lang.String[] getCommandline()
```
    Returns the executable and all defined arguments.
    For Windows Family, getShellCommandline() is returned
  - getShellCommandline
```
public java.lang.String[] getShellCommandline()
```
    Returns the shell, executable and all defined arguments. Shell usage is only desirable when generating code for remote execution.
  - getArguments
```
public java.lang.String[] getArguments()
```
    Returns all arguments defined by addLine, addValue or the argument object.
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - size
```
public int size()
```
  - clone
```
public java.lang.Object clone()
```
    Overrides:
    
    clone in class java.lang.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(java.lang.String path)
```
    Sets execution directory.
  - setWorkingDirectory
```
public void setWorkingDirectory(java.io.File workingDirectory)
```
    Sets execution directory.
  - getWorkingDirectory
```
public java.io.File getWorkingDirectory()
```
  - execute
```
public java.lang.Process execute()
                          throws CommandLineException
```
    Executes the command.
    
    Throws:
    
    CommandLineException
  - getSystemEnvVars
```
public java.util.Properties getSystemEnvVars()
                                      throws java.lang.Exception
```
    Throws:
    
    java.lang.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 java.lang.String[] translateCommandline(java.lang.String toProcess)
                                               throws java.lang.Exception
```
    Deprecated. Use CommandLineUtils.translateCommandline(String) instead.
    
    Throws:
    
    java.lang.Exception
  - quoteArgument
```
public static java.lang.String quoteArgument(java.lang.String argument)
                                      throws CommandLineException
```
    Deprecated. Use CommandLineUtils.quote(String) instead.
    
    Throws:
    
    CommandLineException
  - toString
```
public static java.lang.String toString(java.lang.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