Enum Constant Detail

• ABORT_CHANGES

  public static final FsSyncOption ABORT_CHANGES

  If this option is set, all pending changes are aborted. This option is only meaningful immediately before the federated file system itself gets deleted.

• CLEAR_CACHE

  public static final FsSyncOption CLEAR_CACHE

  Suppose a controller for a federated file system has cached entry data. Then if this option is set when the file system gets synchronized, the cached entry data get cleared after flushing it to the file system.

• FORCE_CLOSE_INPUT

  public static final FsSyncOption FORCE_CLOSE_INPUT

  Suppose there are any open input resources (input streams etc.) for any file system entries. Then if this option is set, the respective file system controller proceeds to update the federated file system anyway and finally throws an FsSyncWarningException with an InputBusyException as its cause to indicate that any subsequent operations on these resources will fail with an InputClosedException because they have been forced to close.

  If this option is not set however, the federated file system is not updated, but instead an FsSyncException with an InputBusyException as its cause is thrown to indicate that the application must close all input resources first.

• FORCE_CLOSE_OUTPUT

  public static final FsSyncOption FORCE_CLOSE_OUTPUT

  Similar to FORCE_CLOSE_INPUT, but applies to file system entry output resources (output streams etc.) and may throw an OutputClosedException / OutputBusyException instead.

  If this option is set, then FORCE_CLOSE_INPUT must be set, too. Otherwise, an IllegalArgumentException is thrown.

• WAIT_CLOSE_INPUT

  public static final FsSyncOption WAIT_CLOSE_INPUT

  Suppose there are any open input resources (input streams etc.) for any file system entries. Then if this option is set, the respective file system controller waits until all other threads have closed their input resources before proceeding with the update of the federated file system. Input resources allocated by the current thread are always ignored. If the current thread gets interrupted while waiting, it will stop waiting and proceed normally as if this option wasn't set.

  Beware: If an input resource has not been closed because the client application does not always properly close its streams, even on an IOException (which is a typical bug in many Java applications), then the respective file system controller will not return from the update until the current thread gets interrupted!

• WAIT_CLOSE_OUTPUT

  public static final FsSyncOption WAIT_CLOSE_OUTPUT

  Similar to WAIT_CLOSE_INPUT, but applies to file system entry output resources (output streams etc.) instead.

Method Detail

• valueOf

  public static FsSyncOption valueOf(String name)

  Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

  Parameters:

  name - the name of the enum constant to be returned.

  Returns:

  the enum constant with the specified name

  Throws:

  IllegalArgumentException - if this enum type has no constant with the specified name

  NullPointerException - if the argument is null

• values

  public static FsSyncOption[] values()

  Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

  for (FsSyncOption c : FsSyncOption.values())
      System.out.println(c);
  

  Returns:

  an array containing the constants of this enum type, in the order they are declared