Constructor Detail

• FsArchiveDriver

  public FsArchiveDriver()

Method Detail

• getClosedIcon

  @CheckForNull
  public Icon getClosedIcon(FsModel model)

  Returns the icon that should be displayed for the given archive file if it's closed/collapsed in the view.

  The implementation in the abstract class FsArchiveDriver simply returns null.

  Parameters:

  model - the file system model.

  Returns:

  The icon that should be displayed for the given archive file if it's closed/collapsed in the view. If null is returned, a default icon should be displayed.

• getInputSocket

  public InputSocket<?> getInputSocket(FsController<?> controller,
                              FsEntryName name,
                              BitField<FsInputOption> options)

  Called to prepare reading an archive file artifact of this driver from name in controller using options.

  This method should be overridden in order to modify the given options before forwarding the call to the given controller. The implementation in the class FsArchiveDriver simply forwards the call to the given controller with the given options unaltered.

  Parameters:

  controller - the controller to use for reading an artifact of this driver.

  name - the entry name.

  options - the options to use.

  Returns:

  An input socket for reading an artifact of this driver.

  Since:

  TrueZIP 7.1

• getOpenIcon

  @CheckForNull
  public Icon getOpenIcon(FsModel model)

  Returns the icon that should be displayed for the given archive file if it's open/expanded in the view.

  The implementation in the abstract class FsArchiveDriver simply returns null.

  Parameters:

  model - the file system model.

  Returns:

  The icon that should be displayed for the given archive file if it's open/expanded in the view. If null is returned, a default icon should be displayed.

• getOutputSocket

  public OutputSocket<?> getOutputSocket(FsController<?> controller,
                                FsEntryName name,
                                BitField<FsOutputOption> options,
                                @CheckForNull
                                Entry template)

  Called to prepare writing an archive file artifact of this driver to name in controller using options and template.

  This method should be overridden in order to modify the given options before forwarding the call to the given controller. The implementation in the class FsArchiveDriver simply forwards the call to the given controller with the given options unaltered.

  Parameters:

  controller - the controller to use for writing an artifact of this driver.

  name - the entry name.

  options - the options to use.

  template - the template to use.

  Returns:

  An output socket for writing an artifact of this driver.

  Since:

  TrueZIP 7.1

• getPool

  protected abstract IOPool<?> getPool()

  Returns the I/O pool to use for allocating temporary I/O entries.

  Returns:

  The I/O pool to use for allocating temporary I/O entries.

• getRedundantContentSupport

  public boolean getRedundantContentSupport()

  Returns true if and only if the archive files produced by this archive driver may contain redundant archive entry contents. If the return value is true, then an archive file may contain redundant archive entry contents, but only the last contents written should get used when reading the archive file.

  Returns:

  The implementation in the class FsArchiveDriver returns false for backwards compatibility.

  Since:

  TrueZIP 7.3

• getRedundantMetaDataSupport

  public boolean getRedundantMetaDataSupport()

  Returns true if and only if the archive files produced by this archive driver may contain redundant archive entry meta data. If the return value is true, then an archive file may contain redundant archive entry meta data, but only the last meta data written should get used when reading the archive file. This usually implies the existence of a central directory in the resulting archive file.

  Returns:

  The implementation in the class FsArchiveDriver returns false for backwards compatibility.

  Since:

  TrueZIP 7.3

• isFederated

  public final boolean isFederated()

  Returns true iff this file system driver implements a federated file system type, i.e. if the type of file system must be a member of a parent file system.

  The implementation in the class FsDriver returns false.

  The implementation in the class FsArchiveDriver always returns true. This can't get overridden.

  Overrides:

  isFederated in class FsDriver

  Returns:

  true iff the type of the file system implemented by this file system driver is federated, i.e. must be a member of a parent file system.

• newController

  public FsController<?> newController(FsModel model,
                              FsController<?> parent)

  Returns a new thread-safe file system controller for the mount point of the given file system model and parent file system controller.

  When called, the following expression is a precondition: model.getParent().equals(parent.getModel())

  Note that an archive file system is always federated and therefore its parent file system controller is never null.

  Furthermore, an archive driver implementation is not expected to consider the scheme of the given mount point to determine the class of the returned file system controller. Consequently, it is an error to call this method with a mount point which has a scheme which is not supported by this archive driver.

  Note again that unlike the other components created by this factory, the returned file system controller must be thread-safe!

  Specified by:

  newController in class FsDriver

  Parameters:

  model - the file system model.

  parent - the nullable parent file system controller.

  Returns:

  A new thread-safe file system controller for the given mount point and parent file system controller.

  See Also:

  FsCompositeDriver.newController(de.schlichtherle.truezip.fs.FsModel, de.schlichtherle.truezip.fs.FsController<?>)

• newEntry

  public final E newEntry(String name,
           Entry.Type type,
           @CheckForNull
           Entry template)
                                          throws CharConversionException

  Equivalent to newEntry(name, type, template, FsOutputOptions.NO_OUTPUT_OPTIONS).

  Throws:

  CharConversionException

• newEntry

  public abstract E newEntry(String name,
           Entry.Type type,
           @CheckForNull
           Entry template,
           BitField<FsOutputOption> mknod)
                                             throws CharConversionException

  Returns a new archive entry for the given name. The implementation may need to fix this name in order to form a valid entry name for their particular requirements.

  If template is not null, then the returned entry shall inherit as much properties from this template as possible - with the exception of its name and type. Furthermore, if name and type are equal to the name and type of this template, then the returned entry shall be a (deep) clone of the template which shares no mutable objects with the template.

  Parameters:

  name - an entry name.

  type - an entry type.

  template - if not null, then the new entry shall inherit as much properties from this entry as possible - with the exception of its name and type.

  mknod - when called from FsArchiveController.mknod(de.schlichtherle.truezip.fs.FsEntryName, de.schlichtherle.truezip.entry.Entry.Type, de.schlichtherle.truezip.util.BitField<de.schlichtherle.truezip.fs.FsOutputOption>, de.schlichtherle.truezip.entry.Entry), this is its options parameter, otherwise it's typically an empty set.

  Returns:

  A new entry for the given name.

  Throws:

  CharConversionException - if name contains characters which are invalid.

• newInputShop

  public abstract InputShop<E> newInputShop(FsModel model,
                          InputSocket<?> input)
                                                            throws IOException

  Creates a new input shop for reading the archive entries for the given model from the given input socket's target.

  Note that the returned input shop does not need to be thread-safe.

  Parameters:

  model - the file system model.

  input - the input socket for reading the contents of the archive file from its target. This is guaranteed to be the product of this driver's getInputSocket(de.schlichtherle.truezip.fs.FsController<?>, de.schlichtherle.truezip.fs.FsEntryName, de.schlichtherle.truezip.util.BitField<de.schlichtherle.truezip.fs.FsInputOption>) method.

  Returns:

  A new input shop.

  Throws:

  IOException - on any I/O error. If the file system entry for the given model exists in the parent file system and is not of the type Entry.Type.SPECIAL, then this exception is deemed to indicate a permanent false positive archive file and gets cached until the file system controller for the given model is synced again. Otherwise, this exception is deemed to indicate a preliminary false positive archive file and does not get cached.

• newOutputShop

  public abstract OutputShop<E> newOutputShop(FsModel model,
                            OutputSocket<?> output,
                            @CheckForNull
                            InputShop<E> source)
                                                              throws IOException

  Creates a new output shop for writing archive entries for the given model to the given output socket's target.

  Note that the returned output shop does not need to be thread-safe.

  Parameters:

  model - the file system model.

  output - the output socket for writing the contents of the archive file to its target. This is guaranteed to be the product of this driver's getOutputSocket(de.schlichtherle.truezip.fs.FsController<?>, de.schlichtherle.truezip.fs.FsEntryName, de.schlichtherle.truezip.util.BitField<de.schlichtherle.truezip.fs.FsOutputOption>, de.schlichtherle.truezip.entry.Entry) method.

  source - the InputShop if archive is going to get updated. If not null, this is guaranteed to be the product of this driver's newInputShop(de.schlichtherle.truezip.fs.FsModel, de.schlichtherle.truezip.socket.InputSocket<?>) factory method. This feature could get used to copy some meta data which is specific to the type of archive this driver supports, e.g. the comment of a ZIP file.

  Returns:

  A new output shop.

  Throws:

  IOException - on any I/O error.