com.maverick.sshd.platform

Class ExecutableCommand

java.lang.Object

com.maverick.sshd.platform.ExecutableCommand

Direct Known Subclasses:

NativeExecutableCommand, ScpCommand

public abstract class ExecutableCommand
extends Object

This class can be extended to provide a single executable command. Commands are configured in the com.maverick.sshd.ConfigurationContext and they make use of the input/output streams provided to communicate with the client.

Author:

Lee David Painter

Field Summary

Fields

Modifier and Type	Field and Description
protected SessionChannel	session The session channel instance on which this command is being executed
protected OutputStream	stderr Write STDERR data to this OutputStream
protected InputStream	stdin Receive STDIN from this InputStream
protected OutputStream	stdout Write STDOUT data to this OutputStream *
static int	STILL_ACTIVE Value returned from getExitCode() to indicate that the process is still active.

Constructor Summary

Constructors

Constructor and Description
ExecutableCommand()
ExecutableCommand(int incomingBufferSize)

Method Summary

Modifier and Type	Method and Description
abstract boolean	createProcess(String cmd, Map<String,String> environment) Create the process but wait for the onStart() method before performing any IO.
abstract int	getExitCode() Get the exit code for this process.
InputStream	getInputStream() Get the STDIN InputStream for this process.
OutputStream	getOutputStream() Get the STDOUT OutputStream for this process.
SessionChannel	getSession()
OutputStream	getStderrOutputStream() Get the STDERR OutputStream for this process.
protected long	getTimeout()
void	init(SessionChannel session) Initialize the command.
abstract void	kill() Kill the command.
abstract void	onStart() Called once the command has been started.
void	processStdinData(byte[] data) Called by the session to pass incoming data into the process.
void	start() Start the command.

Methods inherited from class java.lang.Object

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

Field Detail

STILL_ACTIVE

public static final int STILL_ACTIVE

Value returned from getExitCode() to indicate that the process is still active.

See Also:

Constant Field Values

session

protected SessionChannel session

The session channel instance on which this command is being executed

stdout

protected OutputStream stdout

Write STDOUT data to this OutputStream *

stderr

protected OutputStream stderr

Write STDERR data to this OutputStream

stdin

protected InputStream stdin

Receive STDIN from this InputStream

Constructor Detail

ExecutableCommand

public ExecutableCommand()

ExecutableCommand

public ExecutableCommand(int incomingBufferSize)

Method Detail

init

public void init(SessionChannel session)

Initialize the command. This can be overridden but always call this super method with the command's session.

Parameters:

session -

getTimeout

protected long getTimeout()

getSession

public SessionChannel getSession()

createProcess

public abstract boolean createProcess(String cmd,
                                      Map<String,String> environment)

Create the process but wait for the onStart() method before performing any IO.

Parameters:

cmd -

environment -

Returns:

boolean

start

public void start()

Start the command.

onStart

public abstract void onStart()

Called once the command has been started. Operations within this method SHOULD NOT block as this will cause the connection to lockup.

kill

public abstract void kill()

Kill the command.

getExitCode

public abstract int getExitCode()

Get the exit code for this process. If the process has not completed return STILL_ACTIVE.

Returns:

int

getOutputStream

public OutputStream getOutputStream()

Get the STDOUT OutputStream for this process.

Returns:

OutputStream

getStderrOutputStream

public OutputStream getStderrOutputStream()

Get the STDERR OutputStream for this process.

Returns:

OutputStream

getInputStream

public InputStream getInputStream()

Get the STDIN InputStream for this process.

Returns:

InputStream

processStdinData

public void processStdinData(byte[] data)
                      throws IOException

Called by the session to pass incoming data into the process. This implementation will place the data into the processes InputStream however you may want to change this behaviour by overriding this method. If you override this method DO NOT block.

Parameters:

data -

Throws:

IOException