Class ScriptI

    • Field Detail

      • scripts

        protected final ome.services.scripts.ScriptRepoHelper scripts
      • aclVoter

        protected final ome.security.ACLVoter aclVoter
      • interceptor

        protected final ome.security.basic.OmeroInterceptor interceptor
      • cpf

        protected final ome.util.checksum.ChecksumProviderFactory cpf
    • Constructor Detail

      • ScriptI

        public ScriptI​(BlitzExecutor be,
                       ome.services.scripts.ScriptRepoHelper scripts,
                       ome.security.ACLVoter aclVoter,
                       ome.security.basic.OmeroInterceptor interceptor,
                       ome.util.checksum.ChecksumProviderFactory cpf,
                       ParamsCache cache)
    • Method Detail

      • 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
      • 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
      • getScriptID_async

        public void getScriptID_async​(AMD_IScript_getScriptID __cb,
                                      java.lang.String scriptPath,
                                      Ice.Current __current)
                               throws ServerError
        Get the id of the official script with given path.
        Specified by:
        getScriptID_async in interface _IScriptOperations
        Parameters:
        __cb - The script context.
        scriptPath - OriginalFile.getPath() of the script to find id for.
        __current - ice context.
        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
        Upload script to the server.
        Specified by:
        uploadScript_async in interface _IScriptOperations
        Parameters:
        path - the path to the script
        scriptText - the content for the new script
        __current - ice context.
        __cb - The callback object for the operation.
        Throws:
        ServerError
      • getScripts_async

        public void getScripts_async​(AMD_IScript_getScripts __cb,
                                     Ice.Current __current)
                              throws ServerError
        Get Scripts will return all the scripts by id and name available on the server.
        Specified by:
        getScripts_async in interface _IScriptOperations
        Parameters:
        __current - ice context,
        __cb - The callback object for the operation.
        Throws:
        ServerError - validation, api usage.
      • getScriptsByMimetype_async

        public void getScriptsByMimetype_async​(AMD_IScript_getScriptsByMimetype __cb,
                                               java.lang.String mimetype,
                                               Ice.Current __current)
                                        throws ServerError
        Get Scripts will return all the scripts by id and name available on the server.
        Specified by:
        getScriptsByMimetype_async in interface _IScriptOperations
        Parameters:
        mimetype - The mimetype of the scripts to retrieve.
        __current - ice context,
        __cb - The callback object for the operation.
        Throws:
        ServerError - validation, api usage.
      • 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
      • 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
      • deleteScript_async

        public void deleteScript_async​(AMD_IScript_deleteScript cb,
                                       long id,
                                       Ice.Current __current)
                                throws ServerError
        Delete the script with id from the server.
        Specified by:
        deleteScript_async in interface _IScriptOperations
        Parameters:
        id - the id of the script to delete.
        cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError