Field Detail

• peer

  @CheckForNull
  private InputSocket<?> peer

Constructor Detail

• OutputSocket

  public OutputSocket()

Method Detail

• getPeerTarget

  @Nullable
  public 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

• bind

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

  Binds the peer target of the given socket to this socket. Note that this method does not change the state of the given socket and does not connect this socket to the peer socket, i.e. it does not set this socket as the peer of of the given socket.

  Parameters:

  to - the output socket which has a peer target to share.

  Returns:

  this

• connect

  final OutputSocket<E> connect(@CheckForNull
                        InputSocket<?> newPeer)

  Connects this output socket to the given peer input socket. Note that this method changes the peer output socket of the given peer input socket to this instance.

  Parameters:

  newPeer - the nullable peer input socket to connect to.

  Returns:

  this

• newOutputStream

  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:

  FileNotFoundException - if the local target is not accessible for some reason.

  IOException - on any other exceptional condition.