org.apache.maven.shared.utils.cli
Class CommandLineUtils

java.lang.Object
  org.apache.maven.shared.utils.cli.CommandLineUtils

public abstract class CommandLineUtils
extends Object

Version:

$Id: CommandLineUtils.java 1406293 2012-11-06 20:04:00Z krosenvold $

Author:

Trygve Laugstøl

Nested Class Summary

static class

CommandLineUtils.StringStreamConsumer

Constructor Summary

CommandLineUtils()

Method Summary

static int	executeCommandLine(Commandline cl, InputStream systemIn, StreamConsumer systemOut, StreamConsumer systemErr)
static int	executeCommandLine(Commandline cl, InputStream systemIn, StreamConsumer systemOut, StreamConsumer systemErr, int timeoutInSeconds)
static int	executeCommandLine(Commandline cl, StreamConsumer systemOut, StreamConsumer systemErr)
static int	executeCommandLine(Commandline cl, StreamConsumer systemOut, StreamConsumer systemErr, int timeoutInSeconds)
static Properties	getSystemEnvVars() Gets the shell environment variables for this process.
static Properties	getSystemEnvVars(boolean caseSensitive) Return the shell environment variables.
static String	toString(String... line)
static String[]	translateCommandline(String toProcess)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CommandLineUtils

public CommandLineUtils()

Method Detail

executeCommandLine

public static int executeCommandLine(Commandline cl,
                                     StreamConsumer systemOut,
                                     StreamConsumer systemErr)
                              throws CommandLineException

Throws:

CommandLineException

executeCommandLine

public static int executeCommandLine(Commandline cl,
                                     StreamConsumer systemOut,
                                     StreamConsumer systemErr,
                                     int timeoutInSeconds)
                              throws CommandLineException

Throws:

CommandLineException

executeCommandLine

public static int executeCommandLine(Commandline cl,
                                     InputStream systemIn,
                                     StreamConsumer systemOut,
                                     StreamConsumer systemErr)
                              throws CommandLineException

Throws:

CommandLineException

executeCommandLine

public static int executeCommandLine(Commandline cl,
                                     InputStream systemIn,
                                     StreamConsumer systemOut,
                                     StreamConsumer systemErr,
                                     int timeoutInSeconds)
                              throws CommandLineException

Parameters:

cl - The command line to execute

systemIn - The input to read from, must be thread safe

systemOut - A consumer that receives output, must be thread safe

systemErr - A consumer that receives system error stream output, must be thread safe

timeoutInSeconds - Positive integer to specify timeout, zero and negative integers for no timeout.

Returns:

A return value, see Process.exitValue()

Throws:

CommandLineException - or CommandLineTimeOutException if time out occurs

getSystemEnvVars

public static Properties getSystemEnvVars()
                                   throws IOException

Gets the shell environment variables for this process. Note that the returned mapping from variable names to values will always be case-sensitive regardless of the platform, i.e. getSystemEnvVars().get("path") and getSystemEnvVars().get("PATH") will in general return different values. However, on platforms with case-insensitive environment variables like Windows, all variable names will be normalized to upper case.

Returns:

The shell environment variables, can be empty but never null.

Throws:

IOException - If the environment variables could not be queried from the shell.

See Also:

System.getenv() API, new in JDK 5.0, to get the same result since 2.0.2 System#getenv() will be used if available in the current running jvm.

getSystemEnvVars

public static Properties getSystemEnvVars(boolean caseSensitive)
                                   throws IOException

Return the shell environment variables. If caseSensitive == true, then envar keys will all be upper-case.

Parameters:

caseSensitive - Whether environment variable keys should be treated case-sensitively.

Returns:

Properties object of (possibly modified) envar keys mapped to their values.

Throws:

IOException - .

See Also:

System.getenv() API, new in JDK 5.0, to get the same result since 2.0.2 System#getenv() will be used if available in the current running jvm.

translateCommandline

public static String[] translateCommandline(String toProcess)
                                     throws Exception

Throws:

Exception

toString

public static String toString(String... line)