Package omero.grid
Interface _ScriptProcessOperationsNC
-
- All Superinterfaces:
_ProcessOperationsNC
- All Known Subinterfaces:
ScriptProcess
- All Known Implementing Classes:
_ScriptProcessDisp,_ScriptProcessTie
public interface _ScriptProcessOperationsNC extends _ProcessOperationsNC
Extension of theProcessinterface which is returned byIScriptwhen anScriptJobis launched. It is critical that instances of (@code ScriptProcess} are closed on completion. See theclose(boolean)method for more information.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidclose(boolean detach)Closes this process and frees server resources attached to it.ScriptJobgetJob()Returns the job which started this process.java.util.Map<java.lang.String,RType>getResults(int waitSecs)Returns the results immediately if present.java.lang.StringsetMessage(java.lang.String message)Sets the message on theScriptJobobject.-
Methods inherited from interface omero.grid._ProcessOperationsNC
_wait, cancel, kill, poll, registerCallback, shutdown, unregisterCallback
-
-
-
-
Method Detail
-
getJob
ScriptJob getJob() throws ServerError
Returns the job which started this process. Several scheduling fields (submitted, scheduledFor, started, finished) may be of interest.- Throws:
ServerError
-
getResults
java.util.Map<java.lang.String,RType> getResults(int waitSecs) throws ServerError
Returns the results immediately if present. If the process is not yet finished, waits "waitSecs" before throwing anApiUsageException. If poll has returned a non-null value, then this method will always return a non-null value.- Throws:
ServerError
-
setMessage
java.lang.String setMessage(java.lang.String message) throws ServerErrorSets the message on theScriptJobobject. This value MAY be overwritten by the server if the script fails.- Throws:
ServerError
-
close
void close(boolean detach) throws ServerErrorCloses this process and frees server resources attached to it. If the detach argument is True, then the background process will continue executing. The user can reconnect to the process via theIScriptservice. If the detach argument is False, then the background process will be shutdown immediately, and all intermediate results (stdout, stderr, ...) will be uploaded.- Throws:
ServerError
-
-