Method Detail

• channel

  @CreatesObligation
  SeekableByteChannel channel(@Nullable
                                              OutputSocket<? extends Entry> peer)
                              throws IOException

  Optional operation: Returns a new seekable byte channel for reading bytes. If this operation is supported, then the returned seekable byte channel should not be buffered. Buffering should get addressed by the caller instead.

  Because the intention of this interface is input, the returned channel may not be able to write data and any attempt to do so should fail with a NonWritableChannelException.

  Parameters:

  peer - the nullable peer socket for copying entry contents.

  Returns:

  A new seekable byte channel for reading bytes.

  Throws:

  UnsupportedOperationException - if this operation is not supported.

  IOException - on any I/O error.

• stream

  @CreatesObligation
  InputStream stream(@Nullable
                                     OutputSocket<? extends Entry> peer)
                     throws IOException

  Returns a new input stream for reading bytes. The returned input stream should not be buffered. Buffering should get addressed by the caller instead.

  Parameters:

  peer - the nullable peer socket for copying entry contents.

  Returns:

  A new input stream for reading bytes.

  Throws:

  IOException - on any I/O error.