Constructor Detail

• AbstractSource

  public AbstractSource()

Method Detail

• channel

  public SeekableByteChannel channel()
                              throws IOException

  Optional operation: Returns a 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 does not need to be able to write data and any attempt to do so may fail with a NonWritableChannelException.

  Specified by:

  channel in interface Source

  Returns:

  A seekable byte channel for reading bytes.

  Throws:

  UnsupportedOperationException - the implementation in the class AbstractSource always throws an exception of this type.

  IOException - on any I/O error.

• stream

  public InputStream stream()
                     throws IOException

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

  The implementation in the class AbstractSource calls channel() and wraps the result in a ChannelInputStream adapter. Note that this violates the contract for this method unless you override either this method or channel() with a valid implementation.

  Specified by:

  stream in interface Source

  Returns:

  An input stream for reading bytes.

  Throws:

  IOException - on any I/O error.