Field Detail

• peer

  @CheckForNull
  private OutputSocket<?> peer

Constructor Detail

• InputSocket

  public InputSocket()

Method Detail

• bind

  public final InputSocket<E> bind(@CheckForNull
                    InputSocket<?> 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 input socket with the peer target to inherit.

  Returns:

  this

• connect

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

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

  Parameters:

  newPeer - the nullable peer output socket to connect to.

  Returns:

  this

• 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.OutputSocket<?>)ed to another socket.

  Specified by:

  getPeerTarget in class IOSocket<E extends Entry,Entry>

  Returns:

  The peer target for I/O operations.

  Throws:

  IOException

• newInputStream

  public InputStream newInputStream()
                             throws IOException

  Returns a new input stream for reading bytes from the local target.

  Implementations must enable calling this method any number of times. Furthermore, the returned input 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<?>).

  The implementation in the class InputSocket calls newReadOnlyFile() and wraps the resulting object in a new ReadOnlyFileInputStream as an adapter. Note that this may violate the contract for this method because newReadOnlyFile() is allowed to throw an UnsupportedOperationException while this method is not!

  Returns:

  A new input stream.

  Throws:

  IOException - on any I/O error.

• newReadOnlyFile

  public abstract ReadOnlyFile newReadOnlyFile()
                                        throws IOException

  Optional: Returns a new read only file for reading bytes from the local target in arbitrary order.

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

  Returns:

  A new read only file.

  Throws:

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

  IOException - on any I/O error.

• newSeekableByteChannel

  public SeekableByteChannel newSeekableByteChannel()
                                             throws IOException

  Optional: Returns a new seekable byte channel for reading bytes from 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.

  Throws:

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

  IOException - on any I/O error.

  Since:

  TrueZIP 7.2