Method Detail

• accept

  <X extends IOException> void accept(net.java.truecommons.shed.Filter<? super FsController> filter,
                                    net.java.truecommons.shed.Visitor<? super FsController,X> visitor)
              throws X extends IOException

  Invokes the given visitor on all managed file system controllers which get accepted by the given filter. This is the engine for calls to sync(net.java.truecommons.shed.Filter<? super net.java.truevfs.kernel.spec.FsController>, net.java.truecommons.shed.Visitor<? super net.java.truevfs.kernel.spec.FsController, net.java.truevfs.kernel.spec.FsSyncException>).

  Parameters:

  filter - the filter for the managed file system controllers.

  visitor - the visitor for the filtered file system controllers.

  Throws:

  IOException - at the discretion of the visitor. This will abort the visiting.

• controller

  FsController controller(FsCompositeDriver driver,
                        FsMountPoint mountPoint)

  Returns the thread-safe file system controller for the given mount point. The life cycle of the returned file system controller gets managed by this manager, i.e. it gets remembered for future lookup and synchronization.

  Parameters:

  driver - the composite file system driver which shall get used to create a new file system controller if required.

  mountPoint - the mount point of the file system.

  Returns:

  The thread-safe file system controller for the given mount point.

• sync

  void sync(net.java.truecommons.shed.Filter<? super FsController> filter,
          net.java.truecommons.shed.Visitor<? super FsController,FsSyncException> visitor)
            throws FsSyncException

  Invokes the given visitor to sync() all managed file system controllers which get accepted by the given filter.

  Call this method instead of accept(net.java.truecommons.shed.Filter<? super net.java.truevfs.kernel.spec.FsController>, net.java.truecommons.shed.Visitor<? super net.java.truevfs.kernel.spec.FsController, X>) for sync()ing in order to support processing of additional aspects such as controlling a shutdown hook, logging statistics et al.

  The implementation needs to use an FsSyncExceptionBuilder while iterating over all managed file system controllers in order to ensure that all controllers get synced, even if one or more controllers fail with an FsSyncException.

  Parameters:

  filter - the filter for the managed file system controllers. If set to Filter.ACCEPT_ANY, then the implementation may perform additional cleanup operations, e.g. remove a shutdown hook.

  visitor - the visitor for syncing the filtered file system controllers.

  Throws:

  FsSyncWarningException - if only warning conditions apply. This implies that the respective file system controller has been sync()ed with constraints, e.g. if an open archive entry stream or channel gets forcibly close()d.

  FsSyncException - if any error conditions apply.