uk.ac.ed.epcc.webapp.exec

Interface ExecService

All Superinterfaces:

AppContextCleanup, AppContextService<ExecService>

All Known Implementing Classes:

DefaultExecService

public interface ExecService
extends AppContextService<ExecService>

A service to run external commands. This is encapsulated as a service to allow substitution in tests and to re-use common code. If a command contains colons then it is assumed to denote a remote command to be run through ssh and be of the form: [username@host:]+command If there is more than one username@host fragment then all but the last denote a series of jump-hosts

Method Summary

Modifier and Type	Method and Description
DeferredProcessProxy	exec_deferred(byte[] input, java.lang.String command) Make a DeferredProcessProxy to be run later.
ProcessProxy	exec(long timeout_milliseconds, java.lang.String command) Run a external command (waiting for it to complete)
ProcessProxy	exec(java.lang.String input, long timeout_milliseconds, java.lang.String command) Run a external command with supplied input (waiting for it to complete)

Methods inherited from interface uk.ac.ed.epcc.webapp.AppContextService

getType

Methods inherited from interface uk.ac.ed.epcc.webapp.AppContextCleanup

cleanup

Method Detail

exec

ProcessProxy exec(long timeout_milliseconds,
                  java.lang.String command)
           throws java.lang.Exception

Run a external command (waiting for it to complete)

Parameters:

timeout_milliseconds -

command -

Returns:

ProcessProxy

Throws:

java.io.IOException

java.lang.InterruptedException

java.lang.Exception

exec

ProcessProxy exec(java.lang.String input,
                  long timeout_milliseconds,
                  java.lang.String command)
           throws java.lang.Exception

Run a external command with supplied input (waiting for it to complete)

Parameters:

input -

timeout_milliseconds -

command -

Returns:

ProcessProxy

Throws:

java.io.IOException

java.lang.InterruptedException

java.lang.Exception

exec_deferred

DeferredProcessProxy exec_deferred(byte[] input,
                                   java.lang.String command)
                            throws java.lang.Exception

Make a DeferredProcessProxy to be run later.

Parameters:

input -

command -

Returns:

Throws:

java.lang.Exception