Interface IFileChangesListener

All Superinterfaces:
com.polarion.core.util.event.IEventListener
All Known Subinterfaces:
IExtendedFileChangesListener
All Known Implementing Classes:
ExtendedFileChangesListenerAdapter, FileChangesListenerAdapter

public interface IFileChangesListener extends com.polarion.core.util.event.IEventListener
Listener used by IRepositoryService clients. It allows them to watch changes occurring in the storage.

Only really commited changes are notified.

It is assured that this listener is not called again unless previous call finished.

Listener may be called synchronously or asynchronously to the (finish) commit call and should end as early as possible.

Passed locations have revisions.

Author:
Stepan Roh, Polarion Software
  • Method Details

    • resourceCreated

      void resourceCreated(ILocation loc)
      Resource on given location was created.

      If both resource and its parent folder were created, event is sent for each of them.

      Parameters:
      loc - location
    • resourceCopied

      void resourceCopied(ILocation oldLoc, ILocation newLoc)
      Resource on given location was copied.

      Some storage implementations may not be able to detect the copy and may issue resourceCreated(ILocation) instead.

      If folders are copied, only one event is sent. Events about copied children are not sent.

      Parameters:
      oldLoc - old location
      newLoc - new location
    • resourceRemoved

      void resourceRemoved(ILocation loc)
      Resource on given location was removed.

      If folder is removed, only one event is sent. Events about removed children are not sent.

      Parameters:
      loc - location
    • resourceModified

      void resourceModified(ILocation loc)
      Resource on given location was modified (either its resource properties, custom properties or contents).

      Changes of children do not affect parent folders.

      Parameters:
      loc - location
    • resourceMoved

      void resourceMoved(ILocation oldLoc, ILocation newLoc)
      Resource was moved from old to new location.

      Some storage implementations may not be able to detect the move and may issue resourceRemoved(ILocation) and resourceCreated(ILocation) (in either order) instead.

      If folders are moved, only one event is sent. Events about moved children are not sent.

      Parameters:
      oldLoc - old location
      newLoc - new location