omero.grid

Interface _ProcessOperations

All Known Subinterfaces:

_ScriptProcessOperations, Process, ScriptProcess

All Known Implementing Classes:

_ProcessDisp, _ProcessTie, _ScriptProcessDisp, _ScriptProcessTie, ScriptProcessI

public interface _ProcessOperations

Thin wrapper around a system-level process. Most closely resembles Python's subprocess.Popen class.

Method Summary

Modifier and Type	Method and Description
int	_wait(Ice.Current __current) Blocks until poll() would return a non-null return code.
boolean	cancel(Ice.Current __current) Signal to the Process that it should terminate.
boolean	kill(Ice.Current __current) Terminate the Process immediately.
RInt	poll(Ice.Current __current) Returns the return code of the process, or null if unfinished.
void	registerCallback(ProcessCallbackPrx cb, Ice.Current __current) Add a callback for end-of-life events
void	shutdown(Ice.Current __current) First attempts cancel() several times and finally resorts to kill to force the process to shutdown cleanly.
void	unregisterCallback(ProcessCallbackPrx cb, Ice.Current __current) Remove a callback for end-of-life events

Method Detail

poll

RInt poll(Ice.Current __current)
   throws ServerError

Returns the return code of the process, or null if unfinished.

Parameters:

__current - The Current object for the invocation.

Throws:

ServerError

_wait

int _wait(Ice.Current __current)
   throws ServerError

Blocks until poll() would return a non-null return code.

Parameters:

__current - The Current object for the invocation.

Throws:

ServerError

cancel

boolean cancel(Ice.Current __current)
        throws ServerError

Signal to the Process that it should terminate. This may be done "softly" for a given time period.

Parameters:

__current - The Current object for the invocation.

Throws:

ServerError

kill

boolean kill(Ice.Current __current)

Terminate the Process immediately.

Parameters:

__current - The Current object for the invocation.

shutdown

void shutdown(Ice.Current __current)

First attempts cancel() several times and finally resorts to kill to force the process to shutdown cleanly. This method doesn't return any value or throw an exception so that it can be called oneway.

Parameters:

__current - The Current object for the invocation.

registerCallback

void registerCallback(ProcessCallbackPrx cb,
                      Ice.Current __current)
               throws ServerError

Add a callback for end-of-life events

Parameters:

__current - The Current object for the invocation.

Throws:

ServerError

unregisterCallback

void unregisterCallback(ProcessCallbackPrx cb,
                        Ice.Current __current)
                 throws ServerError

Remove a callback for end-of-life events

Parameters:

__current - The Current object for the invocation.

Throws:

ServerError