Constructor Detail

• RandomAccessFileReader

  public RandomAccessFileReader(RandomAccessFile file)
                         throws IOException

  Throws:

  IOException

Method Detail

• getLength

  public long getLength()

  Description copied from class: RandomAccessReader
  Returns the length of the data source in bytes.

  This is a simple operation for implementations (such as RandomAccessFileReader and ByteArrayReader) that have the entire data source available.

  Users of this method must be aware that sequentially accessed implementations such as RandomAccessStreamReader will have to read and buffer the entire data source in order to determine the length.

  Specified by:

  getLength in class RandomAccessReader

  Returns:

  the length of the data source, in bytes.

• getByte

  protected byte getByte(int index)
                  throws IOException

  Description copied from class: RandomAccessReader
  Gets the byte value at the specified byte index.

  Implementations should not perform any bounds checking in this method. That should be performed in validateIndex and isValidIndex.

  Specified by:

  getByte in class RandomAccessReader

  Parameters:

  index - The index from which to read the byte

  Returns:

  The read byte value

  Throws:

  BufferBoundsException - if the requested byte is beyond the end of the underlying data source

  IOException - if the byte is unable to be read

• getBytes

  public byte[] getBytes(int index,
                int count)
                  throws IOException

  Description copied from class: RandomAccessReader
  Returns the required number of bytes from the specified index from the underlying source.

  Specified by:

  getBytes in class RandomAccessReader

  Parameters:

  index - The index from which the bytes begins in the underlying source

  count - The number of bytes to be returned

  Returns:

  The requested bytes

  Throws:

  BufferBoundsException - if the requested bytes extend beyond the end of the underlying data source

  IOException - if the byte is unable to be read

• isValidIndex

  protected boolean isValidIndex(int index,
                     int bytesRequested)
                          throws IOException

  Specified by:

  isValidIndex in class RandomAccessReader

  Throws:

  IOException

• validateIndex

  protected void validateIndex(int index,
                   int bytesRequested)
                        throws IOException

  Description copied from class: RandomAccessReader
  Ensures that the buffered bytes extend to cover the specified index. If not, an attempt is made to read to that point.

  If the stream ends before the point is reached, a BufferBoundsException is raised.

  Specified by:

  validateIndex in class RandomAccessReader

  Parameters:

  index - the index from which the required bytes start

  bytesRequested - the number of bytes which are required

  Throws:

  IOException - if the stream ends before the required number of bytes are acquired