Field Detail

• CLASS_NAME

  private static final java.lang.String CLASS_NAME

• logger

  private static final java.util.logging.Logger logger

• threads

  private final java.util.Map<java.io.Closeable,java.lang.Thread> threads

  The pool of all open entry streams. This is implemented as a map where the keys are the streams and the value is the current thread. The weak hash map allows the garbage collector to pick up an entry stream if there are no more references to it. This reduces the likeliness of an OutputBusyException in case a sloppy client application has forgot to close a stream before this output shop gets closed.

• closed

  private volatile boolean closed

Constructor Detail

• ConcurrentOutputShop

  public ConcurrentOutputShop(OutputShop<E> output)

  Constructs a concurrent output shop.

  Parameters:

  output - the shop to decorate.

  Throws:

  java.lang.NullPointerException - if output is null.

Method Detail

• waitCloseOthers

  public final int waitCloseOthers(long timeout)

  Waits until all entry output streams which have been opened by other threads get closed or a timeout occurs. If the current thread is interrupted while waiting, a warn message is logged using java.util.logging and this method returns.

  Unless otherwise prevented, another thread could immediately open another stream upon return of this method. So there is actually no guarantee that really all streams are closed upon return of this method - use carefully!

  Returns:

  The number of all open streams.

• threadStreams

  private int threadStreams()

  Returns the number of streams opened by the current thread.

• closeAll

  public final <X extends java.lang.Exception> void closeAll(ExceptionHandler<java.io.IOException,X> handler)
                      throws X extends java.lang.Exception

  Closes and disconnects all entry output streams created by this concurrent output shop. Disconnecting means that any subsequent operation on the entry streams will throw an IOException, with the exception of their close() method.

  Throws:

  X extends java.lang.Exception

• close

  public final void close()
                   throws java.io.IOException

  Closes this concurrent output shop.

  Specified by:

  close in interface java.io.Closeable

  Specified by:

  close in interface java.lang.AutoCloseable

  Overrides:

  close in class DecoratingOutputShop<E extends Entry,OutputShop<E extends Entry>>

  Throws:

  java.lang.IllegalStateException - If any open output streams are detected.

  java.io.IOException

  See Also:

  closeAll(de.schlichtherle.truezip.util.ExceptionHandler<java.io.IOException, X>)

• assertNotShopClosed

  private void assertNotShopClosed()
                            throws java.io.IOException

  Needs to be externally synchronized!

  Throws:

  java.io.IOException

• getOutputSocket

  public final OutputSocket<? extends E> getOutputSocket(E entry)

  Description copied from interface: OutputService
  Returns an output socket for writing to the given entry.

  Specified by:

  getOutputSocket in interface OutputService<E extends Entry>

  Overrides:

  getOutputSocket in class DecoratingOutputShop<E extends Entry,OutputShop<E extends Entry>>

  Parameters:

  entry - the entry, which will be the local target of the returned output socket.

  Returns:

  An output socket for writing to the given entry.