org.nuxeo.ecm.platform.commandline.executor.service.executors

Class ShellExecutor

java.lang.Object

org.nuxeo.ecm.platform.commandline.executor.service.executors.ShellExecutor

All Implemented Interfaces:

Executor

public class ShellExecutor
extends Object
implements Executor

Default implementation of the Executor interface. Use simple shell exec.

Field Summary

Fields

Modifier and Type	Field and Description
protected static Pattern	COMMAND_SPLIT Used to split the contributed command, NOT the passed parameter values.
protected static AtomicInteger	PIPE_COUNT

Constructor Summary

Constructors

Constructor and Description
ShellExecutor()

Method Summary

Modifier and Type	Method and Description
ExecResult	exec(CommandLineDescriptor cmdDesc, CmdParameters params) Deprecated.
ExecResult	exec(CommandLineDescriptor cmdDesc, CmdParameters params, EnvironmentDescriptor env) No exception is thrown but the returned ExecResult contains everything about the command execution, including an optional exception.
protected ExecResult	exec1(CommandLineDescriptor cmdDesc, CmdParameters params, EnvironmentDescriptor env)
static String	getCommandAbsolutePath(String command) Returns the absolute path of a command looked up on the PATH or the initial string if not found.
static Thread	pipe(InputStream in, OutputStream out) Returns a started daemon thread piping bytes from the InputStream to the OutputStream.
static List<String>	replaceParams(String word, CmdParameters params) Expands parameter strings in a parameter word.

Methods inherited from class java.lang.Object

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

Field Detail

PIPE_COUNT

protected static final AtomicInteger PIPE_COUNT

COMMAND_SPLIT

protected static final Pattern COMMAND_SPLIT

Used to split the contributed command, NOT the passed parameter values.

Constructor Detail

ShellExecutor

public ShellExecutor()

Method Detail

exec

@Deprecated
public ExecResult exec(CommandLineDescriptor cmdDesc,
                                   CmdParameters params)

Deprecated.

Description copied from interface: Executor

No exception is thrown but the returned ExecResult contains everything about the command execution, including an optional exception.

Specified by:

exec in interface Executor

Parameters:

cmdDesc - Command to run. Cannot be null.

params - Parameters passed to the command. Cannot be null.

Returns:

Result of the execution

exec

public ExecResult exec(CommandLineDescriptor cmdDesc,
                       CmdParameters params,
                       EnvironmentDescriptor env)

Description copied from interface: Executor

No exception is thrown but the returned ExecResult contains everything about the command execution, including an optional exception.

Specified by:

exec in interface Executor

Parameters:

cmdDesc - Command to run. Cannot be null.

params - Parameters passed to the command. Cannot be null.

env - Environment context (variable and working directory)

Returns:

Result of the execution

exec1

protected ExecResult exec1(CommandLineDescriptor cmdDesc,
                           CmdParameters params,
                           EnvironmentDescriptor env)
                    throws IOException

Throws:

IOException

pipe

public static Thread pipe(InputStream in,
                          OutputStream out)

Returns a started daemon thread piping bytes from the InputStream to the OutputStream.

The streams are both closed when the copy is finished.

Since:

7.10

replaceParams

public static List<String> replaceParams(String word,
                                         CmdParameters params)

Expands parameter strings in a parameter word.

This may return several words if the parameter value is marked as a list.

Since:

7.10

getCommandAbsolutePath

public static String getCommandAbsolutePath(String command)

Returns the absolute path of a command looked up on the PATH or the initial string if not found.

Since:

7.10