Package omero.api

Interface _ServiceFactoryOperations

    • Method Detail

      • getSecurityContexts

        java.util.List<IObject> getSecurityContexts​(Ice.Current __current)
                                     throws ServerError
        Provides a list of all valid security contexts for this session. Each of the returned IObject instances can be passed to setSecurityContext.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setSecurityContext

        IObject setSecurityContext​(IObject obj,
                           Ice.Current __current)
                    throws ServerError
        Changes the security context for the current session.

        A security context limits the set of objects which will be returned by all queries and restricts what updates can be made.

        Current valid values for security context:

        Passing an unloaded version of either object type will change the way the current session operates. Note: only objects which are returned by the getSecurityContext method are considered valid. Any other instance will cause an exception to be thrown.

        Example usage in Python:

         sf = client.createSession()
 objs = sf.getSecurityContexts()
 old = sf.setSecurityContext(objs\[-1])

        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setSecurityPassword

        void setSecurityPassword​(java.lang.String password,
                         Ice.Current __current)
                  throws ServerError
        Re-validates the password for the current session. This prevents See methods that mention "HasPassword".
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getByName

        ServiceInterfacePrx getByName​(java.lang.String name,
                              Ice.Current __current)
                       throws ServerError
        Allows looking up any stateless service by name. See Constants.ice for examples of services. If a service has been added by third-parties, getByName can be used even though no concrete method is available.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • createByName

        StatefulServiceInterfacePrx createByName​(java.lang.String name,
                                         Ice.Current __current)
                                  throws ServerError
        Allows looking up any stateful service by name. See Constants.ice for examples of services. If a service has been added by third-parties, createByName can be used even though no concrete method is available.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • subscribe

        void subscribe​(java.lang.String topicName,
               Ice.ObjectPrx prx,
               Ice.Current __current)
        throws ServerError
        Subscribe to a given topic. The topic must exist and the user must have sufficient permissions for that topic. Further the proxy object must match the required type for the topic as encoded in the topic name.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setCallback

        void setCallback​(ClientCallbackPrx callback,
                 Ice.Current __current)
          throws ServerError
        Sets the single callback used by the ServiceFactory to communicate with the client application. A default callback is set by the omero::client object on session creation which should suffice for most usage. See the client object's documentation in each language mapping for ways to use the callback.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • closeOnDestroy

        void closeOnDestroy​(Ice.Current __current)
             throws ServerError
        Marks the session for closure rather than detachment, which will be triggered by the destruction of the Glacier2 connection via router.destroySession() Closing the session rather the detaching is more secure, since all resources are removed from the server and can safely be set once it is clear that a client is finished with those resources.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • detachOnDestroy

        void detachOnDestroy​(Ice.Current __current)
              throws ServerError
        Marks the session for detachment rather than closure, which will be triggered by the destruction of the Glacier2 connection via router.destroySession() This is the default and allows a lost session to be reconnected, at a slight security cost since the session will persist longer and can be used by others if the UUID is intercepted.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • activeServices

        java.util.List<java.lang.String> activeServices​(Ice.Current __current)
                                         throws ServerError
        Returns a list of string ids for currently active services. This will _not_ keep services alive, and in fact checks for all expired services and removes them.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • keepAllAlive

        long keepAllAlive​(ServiceInterfacePrx[] proxies,
                  Ice.Current __current)
           throws ServerError
        Requests that the given services be marked as alive. It is possible that one of the services has already timed out, in which case the returned long value will be non-zero. Specifically, the bit representing the 0-based index will be 1: if (retval & 1&lt;&lt;idx == 1&lt;&lt;idx) { // not alive } Except for fatal server or session errors, this method should never throw an exception.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • keepAlive

        boolean keepAlive​(ServiceInterfacePrx proxy,
                  Ice.Current __current)
           throws ServerError
        Returns true if the given service is alive. Except for fatal server or session errors, this method should never throw an exception.
        Parameters:
        __current - The Current object for the invocation.
        Throws:
        ServerError