Package omero.api

Class _IScriptTie

    • Constructor Detail

      • _IScriptTie

        public _IScriptTie()

    • Method Detail

      • ice_delegate

        public java.lang.Object ice_delegate()
        Specified by:
        ice_delegate in interface Ice.TieBase

      • ice_delegate

        public void ice_delegate​(java.lang.Object delegate)
        Specified by:
        ice_delegate in interface Ice.TieBase

      • equals

        public boolean equals​(java.lang.Object rhs)
        Overrides:
        equals in class java.lang.Object

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object

      • canRunScript_async

        public void canRunScript_async​(AMD_IScript_canRunScript __cb,
                               long scriptID,
                               Ice.Current __current)
                        throws ServerError
        Description copied from interface: _IScriptOperations
        Returns true if there is a processor which will run the given script.

        Either the script is an official script and this method will return true (though an individual invocation may fail with an ResourceError for some reason) or this is a user script, and a usermode processor must be active which takes the scripts user or group.

        Specified by:
        canRunScript_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • deleteScript_async

        public void deleteScript_async​(AMD_IScript_deleteScript __cb,
                               long scriptID,
                               Ice.Current __current)
                        throws ServerError
        Description copied from interface: _IScriptOperations
        Delete the script on the server with id. The file will also be removed from disk.
        Specified by:
        deleteScript_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        scriptID - Id of the script to delete.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getParams_async

        public void getParams_async​(AMD_IScript_getParams __cb,
                            long scriptID,
                            Ice.Current __current)
                     throws ServerError
        Description copied from interface: _IScriptOperations
        Get the parameters that the script takes and returns, along with other metadata available from the script.
        Specified by:
        getParams_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        scriptID - see above.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getScriptID_async

        public void getScriptID_async​(AMD_IScript_getScriptID __cb,
                              java.lang.String path,
                              Ice.Current __current)
                       throws ServerError
        Description copied from interface: _IScriptOperations
        Get the id of an official script by the script path. The script service ensures that all script paths are unique. Note: there is no similar method for user scripts (e.g. getUserScriptID) since the path is not guaranteed to be unique.
        Specified by:
        getScriptID_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        path - The name of the script.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getScripts_async

        public void getScripts_async​(AMD_IScript_getScripts __cb,
                             Ice.Current __current)
                      throws ServerError
        Description copied from interface: _IScriptOperations
        This method returns official server scripts as a list of OriginalFile objects. These scripts will be executed by the server if submitted via runScript. The input parameters necessary for proper functioning can be retrieved via getParams. The OriginalFile.path value can be used in other official scripts via the language specific import command, since the script directory will be placed on the appropriate environment path variable. 
         
 scripts = scriptService.getScripts()
 for script in scripts:
 text = scriptService.getScriptText(script.id.val)
 # First character is a "/" symbol
 path = script.path.val\[1:\]
 path = path.replace("/",".")
 print "Possible import: %s" % path
        Specified by:
        getScripts_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getScriptsByMimetype_async

        public void getScriptsByMimetype_async​(AMD_IScript_getScriptsByMimetype __cb,
                                       java.lang.String mimetype,
                                       Ice.Current __current)
                                throws ServerError
        Description copied from interface: _IScriptOperations
        This method returns official server scripts identified with the specified extension as a list of OriginalFile objects. These scripts will be executed by the server if submitted via runScript. The input parameters necessary for proper functioning can be retrieved via getParams. The OriginalFile.path value can be used in other official scripts via the language specific import command, since the script directory will be placed on the appropriate environment path variable. 
         
 scripts = scriptService.getScripts("py")
 for script in scripts:
 text = scriptService.getScriptText(script.id.val)
 path = script.path.val\[1:\] # First symbol is a "/"
 path = path.replace("/",".")
 print "Possible import: %s" % path
        Specified by:
        getScriptsByMimetype_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        mimetype - the mimetype identifying the scripts.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getUserScripts_async

        public void getUserScripts_async​(AMD_IScript_getUserScripts __cb,
                                 java.util.List<IObject> acceptsList,
                                 Ice.Current __current)
                          throws ServerError
        Description copied from interface: _IScriptOperations
        Returns non-official scripts which have been uploaded by individual users. These scripts will not be run by the server, though a user can start a personal usermode processor which will allow the scripts to be executed. This is particularly useful for testing new scripts.
        Specified by:
        getUserScripts_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • runScript_async

        public void runScript_async​(AMD_IScript_runScript __cb,
                            long scriptID,
                            java.util.Map<java.lang.String,​RType> inputs,
                            RInt waitSecs,
                            Ice.Current __current)
                     throws ServerError
        Description copied from interface: _IScriptOperations
        If ResourceError is thrown, then no Processor is available. Use scheduleJob to create a ScriptJob in the Waiting state. A Processor may become available. 
         
 try:
 proc = scriptService.runScript(1, {}, None)
 except ResourceError:
 job = scriptService.scheduleScript(1, {}, None)
        The ScriptProcess proxy MUST be closed before exiting. If you would like the script execution to continue in the background, pass True as the argument. 
         
 try:
 proc.poll()         # See if process is finished
 finally:
 proc.close(True)    # Detach and execution can continue
 # proc.close(False) # OR script is immediately stopped.
        Specified by:
        runScript_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • uploadScript_async

        public void uploadScript_async​(AMD_IScript_uploadScript __cb,
                               java.lang.String path,
                               java.lang.String scriptText,
                               Ice.Current __current)
                        throws ServerError
        Description copied from interface: _IScriptOperations
        Upload a user script to the server and return the id. This method checks that a script with that names does not exist and that the script has parameters if possible, i.e. a usermode processor is running which for the current user.
        Specified by:
        uploadScript_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        path - see above.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • validateScript_async

        public void validateScript_async​(AMD_IScript_validateScript __cb,
                                 Job j,
                                 java.util.List<IObject> acceptsList,
                                 Ice.Current __current)
                          throws ServerError
        Description copied from interface: _IScriptOperations
        Used internally by processor.py to check if the script attached to the Job has a valid script attached, based on the acceptsList and the current security context. An example of an acceptsList might be 
        Experimenter(myUserId, False)
        , meaning that only scripts belonging to me should be trusted. An empty list implies that the server should return what it would by default trust. A valid script will be returned if it exists; otherwise null.
        Specified by:
        validateScript_async in interface _IScriptOperations
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError