Interface _MonitorServerOperations

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      java.lang.String createMonitor​(MonitorType mType, WatchEventType[] eTypes, PathMode pMode, java.lang.String pathString, java.lang.String[] whitelist, java.lang.String[] blacklist, float timeout, int blockSize, boolean ignoreSysFiles, boolean ignoreDirEvents, boolean platformCheck, MonitorClientPrx proxy, Ice.Current __current)
      Create a monitor of events.
      void destroyMonitor​(java.lang.String id, Ice.Current __current)
      Destroy an existing monitor.
      MonitorState getMonitorState​(java.lang.String id, Ice.Current __current)
      Get the state of an existing monitor.
      void startMonitor​(java.lang.String id, Ice.Current __current)
      Start an existing monitor.
      void stopMonitor​(java.lang.String id, Ice.Current __current)
      Stop an existing monitor.
    • Method Detail

      • createMonitor

        java.lang.String createMonitor​(MonitorType mType,
                                       WatchEventType[] eTypes,
                                       PathMode pMode,
                                       java.lang.String pathString,
                                       java.lang.String[] whitelist,
                                       java.lang.String[] blacklist,
                                       float timeout,
                                       int blockSize,
                                       boolean ignoreSysFiles,
                                       boolean ignoreDirEvents,
                                       boolean platformCheck,
                                       MonitorClientPrx proxy,
                                       Ice.Current __current)
                                throws OmeroFSError
        Create a monitor of events. A exception will be raised if the event type or path mode is not supported by the Monitor implementation for a given OS. An exception will be raised if the path does not exist or is inaccessible to the monitor. An exception will be raised if a monitor cannot be created for any other reason.
        Parameters:
        mType - type of monitor to create (MonitorType).
        eTypes - a sequence of watch event type to monitor (WatchEventTypeList).
        pathString - full path of directory of interest (string).
        whitelist - list of files or extensions of interest (Ice::StringSeq).
        blacklist - list of directories, files or extensions that are not of interest (Ice::StringSeq).
        pMode - path mode of monitor (PathMode).
        proxy - a proxy of the client to which notifications will be sent (MonitorClient*).
        timeout - time in seconds fo monitor to time out (float).
        blockSize - the number of events to pack into each notification (int).
        ignoreSysFiles - ignore system files or not (bool).
        ignoreDirEvents - ignore directory events (bool).
        platformCheck - if true strictly check platform (bool).
        __current - The Current object for the invocation.
        Returns:
        monitorId, a uuid1 (string).
        Throws:
        OmeroFSError
      • startMonitor

        void startMonitor​(java.lang.String id,
                          Ice.Current __current)
                   throws OmeroFSError
        Start an existing monitor. An exception will be raised if the id does not correspond to an existing monitor. An exception will be raised if a monitor cannot be started for any other reason, in this case the monitor's state cannot be assumed.
        Parameters:
        id - monitor id (string).
        __current - The Current object for the invocation.
        Throws:
        OmeroFSError
      • stopMonitor

        void stopMonitor​(java.lang.String id,
                         Ice.Current __current)
                  throws OmeroFSError
        Stop an existing monitor. Attempting to stop a monitor that is not running raises no exception. An exception will be raised if the id does not correspond to an existing monitor. An exception will be raised if a monitor cannot be stopped for any other reason, in this case the monitor's state cannot be assumed.
        Parameters:
        id - monitor id (string).
        __current - The Current object for the invocation.
        Throws:
        OmeroFSError
      • destroyMonitor

        void destroyMonitor​(java.lang.String id,
                            Ice.Current __current)
                     throws OmeroFSError
        Destroy an existing monitor. Attempting to destroy a monitor that is running will try to first stop the monitor and then destroy it. An exception will be raised if the id does not correspond to an existing monitor. An exception will be raised if a monitor cannot be destroyed (or stopped and destroyed) for any other reason, in this case the monitor's state cannot be assumed.
        Parameters:
        id - monitor id (string).
        __current - The Current object for the invocation.
        Throws:
        OmeroFSError
      • getMonitorState

        MonitorState getMonitorState​(java.lang.String id,
                                     Ice.Current __current)
                              throws OmeroFSError
        Get the state of an existing monitor. An exception will be raised if the id does not correspond to an existing monitor.
        Parameters:
        id - monitor id (string).
        __current - The Current object for the invocation.
        Returns:
        the monitor state (MonitorState).
        Throws:
        OmeroFSError