de.schlichtherle.io
Class ArchiveBusyException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.io.IOException
              de.schlichtherle.io.ChainableIOException
                  de.schlichtherle.io.ArchiveException
                      de.schlichtherle.io.ArchiveBusyException

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

ArchiveInputBusyException, ArchiveOutputBusyException

public class ArchiveBusyException
extends ArchiveException

Thrown if an archive file could not get updated because some input or output streams for its entries are still open. The canonical path name of the archive file is provided as the detail message.

In order to recover from this exception, client applications may call File.umount() or File.update() in order to force all entry streams for all archive files to close and prepare to catch the resulting ArchiveBusyWarningException. A subsequent try to create the archive entry stream will then succeed unless other exceptional conditions apply. However, if the client application is still using a disconnected stream, it will receive an ArchiveEntryStreamClosedException on the next call to any other method than close().

Since:

TrueZIP 6.0

Version:

TrueZIP 6.7

Author:

Christian Schlichtherle

See Also:

Using Archive Entry Streams, File.umount(), File.update(), Serialized Form

Constructor Summary

ArchiveBusyException(ArchiveException priorException, File target)
Deprecated. You should not use this constructor. It will vanish in the next major version.

Method Summary

int	getPriority() Returns the priority for this class of exception.

Methods inherited from class de.schlichtherle.io.ChainableIOException

clone, getAppearance, getMaxPrintExceptions, getPrior, initCause, initCause, printStackTrace, printStackTrace, printStackTrace, printStackTrace, setMaxPrintExceptions, sortAppearance, sortPriority

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ArchiveBusyException

public ArchiveBusyException(ArchiveException priorException,
                            File target)

Deprecated. You should not use this constructor. It will vanish in the next major version.

Method Detail

getPriority

public int getPriority()

Description copied from class: ChainableIOException

Returns the priority for this class of exception. This should always return the same value for all instances of a particular class.

Overrides:

getPriority in class ChainableIOException

Returns:

0 for all instances of this class.