com.jn.langx.commandline

接口 CommandLineExecutor

所有已知实现类:

DefaultCommandLineExecutor

public interface CommandLineExecutor

The main abstraction to start an external process.

The interface allows to

• set a current working directory for the subprocess
• provide a set of environment variables passed to the subprocess
• capture the subprocess output of stdout and stderr using an ExecuteStreamHandler
• kill long-running processes using an ExecuteWatchdog
• define a set of expected exit values
• terminate any started processes when the main process is terminating using a ProcessDestroyer

The following example shows the basic usage:

 Executor exec = new DefaultExecutor();
 CommandLine cl = new CommandLine("ls -l");
 int exitvalue = exec.execute(cl);
 

字段概要

字段

限定符和类型	字段和说明
static int	INVALID_EXITVALUE Invalid exit code.

方法概要

限定符和类型	方法和说明
int	execute(boolean async, CommandLine command)
int	execute(boolean async, CommandLine command, ExecuteResultHandler handler)
int	execute(boolean async, CommandLine command, Map<String,String> environment)
int	execute(boolean async, CommandLine command, Map<String,String> environment, File workingDirectory, ExecuteStreamHandler streamHandler, ExecuteResultHandler handler)
int	execute(CommandLine command) Methods for starting synchronous execution.
int	execute(CommandLine command, ExecuteResultHandler handler) Methods for starting asynchronous execution.
int	execute(CommandLine command, Map<String,String> environment) Methods for starting synchronous execution.
int	execute(CommandLine command, Map<String,String> environment, File workingDirectory, ExecuteStreamHandler streamHandler, ExecuteResultHandler handler) Methods for starting asynchronous execution.
InstructionSequenceDestroyer	getProcessDestroyer() Set the handler for cleanup of started processes if the main process is going to terminate.
ExecuteResultHandler	getResultHandler()
ExecuteStreamHandler	getStreamHandler()
ExecuteWatchdog	getWatchdog() Get the watchdog used to kill of processes running, typically, too long time.
File	getWorkingDirectory() Get the working directory of the created process.
boolean	isFailure(int exitValue) Checks whether exitValue signals a failure.
void	setExitValue(int value) Define the exitValue of the process to be considered successful.
void	setExitValues(int[] values) Define a list of exitValue of the process to be considered successful.
void	setProcessDestroyer(InstructionSequenceDestroyer processDestroyer) Get the handler for cleanup of started processes if the main process is going to terminate.
void	setResultHandler(ExecuteResultHandler resultHandler)
void	setStreamHandler(ExecuteStreamHandler streamHandler)
void	setWatchdog(ExecuteWatchdog watchDog) Set the watchdog used to kill of processes running, typically, too long time.
void	setWorkingDirectory(File dir) Set the working directory of the created process.

字段详细资料

INVALID_EXITVALUE

static final int INVALID_EXITVALUE

Invalid exit code.

另请参阅:

常量字段值

方法详细资料

setExitValue

void setExitValue(int value)

Define the exitValue of the process to be considered successful.

参数:

value - the exit code representing successful execution

setExitValues

void setExitValues(int[] values)

Define a list of exitValue of the process to be considered successful. The caller can pass one of the following values

• an array of exit values to be considered successful
• an empty array for auto-detect of successful exit codes relying on isFailure(int)
• null to indicate to skip checking of exit codes

参数:

values - a list of the exit codes

isFailure

boolean isFailure(int exitValue)

Checks whether exitValue signals a failure. If no exit values are set than the default conventions of the OS is used. e.g. most OS regard an exit code of '0' as successful execution and everything else as failure.

参数:

exitValue - the exit value (return code) to be checked

返回:

true if exitValue signals a failure

getWatchdog

ExecuteWatchdog getWatchdog()

Get the watchdog used to kill of processes running, typically, too long time.

返回:

the watchdog

setWatchdog

void setWatchdog(ExecuteWatchdog watchDog)

Set the watchdog used to kill of processes running, typically, too long time.

参数:

watchDog - the watchdog

getProcessDestroyer

InstructionSequenceDestroyer getProcessDestroyer()

Set the handler for cleanup of started processes if the main process is going to terminate.

返回:

the ProcessDestroyer

setProcessDestroyer

void setProcessDestroyer(InstructionSequenceDestroyer processDestroyer)

Get the handler for cleanup of started processes if the main process is going to terminate.

参数:

processDestroyer - the ProcessDestroyer

getWorkingDirectory

File getWorkingDirectory()

Get the working directory of the created process.

返回:

the working directory

setWorkingDirectory

void setWorkingDirectory(File dir)

Set the working directory of the created process. The working directory must exist when you start the process.

参数:

dir - the working directory

execute

int execute(CommandLine command)
     throws ExecuteException,
            IOException

Methods for starting synchronous execution. The child process inherits all environment variables of the parent process.

参数:

command - the command to execute

返回:

process exit value

抛出:

ExecuteException - execution of subprocess failed or the subprocess returned a exit value indicating a failure setExitValue(int).

IOException

execute

int execute(boolean async,
            CommandLine command)
     throws ExecuteException,
            IOException

抛出:

ExecuteException

IOException

execute

int execute(CommandLine command,
            Map<String,String> environment)
     throws ExecuteException,
            IOException

Methods for starting synchronous execution.

参数:

command - the command to execute

environment - The environment for the new process. If null, the environment of the current process is used.

返回:

process exit value

抛出:

ExecuteException - execution of subprocess failed or the subprocess returned a exit value indicating a failure setExitValue(int).

IOException

execute

int execute(boolean async,
            CommandLine command,
            Map<String,String> environment)
     throws ExecuteException,
            IOException

抛出:

ExecuteException

IOException

execute

int execute(CommandLine command,
            ExecuteResultHandler handler)
     throws ExecuteException,
            IOException

Methods for starting asynchronous execution. The child process inherits all environment variables of the parent process. Result provided to callback handler.

参数:

command - the command to execute

handler - capture process termination and exit code

抛出:

ExecuteException - execution of subprocess failed

IOException

execute

int execute(boolean async,
            CommandLine command,
            ExecuteResultHandler handler)
     throws ExecuteException,
            IOException

抛出:

ExecuteException

IOException

execute

int execute(CommandLine command,
            Map<String,String> environment,
            File workingDirectory,
            ExecuteStreamHandler streamHandler,
            ExecuteResultHandler handler)
     throws ExecuteException,
            IOException

Methods for starting asynchronous execution. The child process inherits all environment variables of the parent process. Result provided to callback handler.

参数:

command - the command to execute

environment - The environment for the new process. If null, the environment of the current process is used.

handler - capture process termination and exit code

抛出:

ExecuteException - execution of subprocess failed

IOException

execute

int execute(boolean async,
            CommandLine command,
            Map<String,String> environment,
            File workingDirectory,
            ExecuteStreamHandler streamHandler,
            ExecuteResultHandler handler)
     throws ExecuteException,
            IOException

抛出:

ExecuteException

IOException

getStreamHandler

ExecuteStreamHandler getStreamHandler()

setStreamHandler

void setStreamHandler(ExecuteStreamHandler streamHandler)

getResultHandler

ExecuteResultHandler getResultHandler()

setResultHandler

void setResultHandler(ExecuteResultHandler resultHandler)