Constructor Detail

• OutputSocket

  public OutputSocket()

Method Detail

• bind

  public final OutputSocket<E> bind(OutputSocket<?> to)

  Binds this socket to given socket by inheriting its peer target. Note that this method does not change the state of the given socket and does not connect this socket to the peer socket, that is it does not set this socket as the peer of of the given socket.

  Parameters:

  to - the output socket with the peer target to inherit.

  Returns:

  this

  Throws:

  IllegalArgumentException - if this == to.

• getPeerTarget

  @Nullable
  public final Entry getPeerTarget()
                            throws IOException

  Returns the peer target for I/O operations.

  The same considerations as for IOSocket.getLocalTarget() apply here, too.

  The peer target is null if and only if this socket is not connect(de.schlichtherle.truezip.socket.InputSocket<?>)ed to another socket.

  Specified by:

  getPeerTarget in class IOSocket<E extends Entry,Entry>

  Returns:

  The peer target for I/O operations.

  Throws:

  IOException - On any I/O failure.

• newOutputStream

  @CreatesObligation
  public abstract OutputStream newOutputStream()
                                        throws IOException

  Returns a new output stream for writing bytes to the local target.

  Implementations must enable calling this method any number of times. Furthermore, the returned output stream should not be buffered. Buffering should be addressed by the caller instead - see IOSocket.copy(de.schlichtherle.truezip.socket.InputSocket<?>, de.schlichtherle.truezip.socket.OutputSocket<?>).

  Returns:

  A new output stream.

  Throws:

  IOException - On any I/O failure.

• newSeekableByteChannel

  @CreatesObligation
  public SeekableByteChannel newSeekableByteChannel()
                                             throws IOException

  Optional: Returns a new seekable byte channel for writing bytes to the local target in arbitrary order.

  If this method is supported, implementations must enable calling it any number of times. Furthermore, the returned seekable byte channel should not be buffered. Buffering should be addressed by client applications instead.

  Returns:

  A new seekable byte channel.

  Throws:

  IOException - On any I/O failure.

  UnsupportedOperationException - if this operation is not supported by the implementation.

  Since:

  TrueZIP 7.2