Class IndependentRandomAccessSource

  • All Implemented Interfaces:
    IRandomAccessSource

    public class IndependentRandomAccessSource
    extends java.lang.Object
    implements IRandomAccessSource
    A RandomAccessSource that is wraps another RandomAccessSource but does not propagate close(). This is useful when passing a RandomAccessSource to a method that would normally close the source.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void close()
      Does nothing - the underlying source is not closed
      int get​(long position)
      Gets a byte at the specified position
      int get​(long position, byte[] bytes, int off, int len)
      Read an array of bytes of specified length from the specified position of source to the buffer applying the offset.
      long length()
      Gets the length of the source
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • IndependentRandomAccessSource

        public IndependentRandomAccessSource​(IRandomAccessSource source)
        Constructs a new IndependentRandomAccessSource object
        Parameters:
        source - the source
    • Method Detail

      • get

        public int get​(long position)
                throws java.io.IOException
        Gets a byte at the specified position
        Specified by:
        get in interface IRandomAccessSource
        Parameters:
        position - byte position
        Returns:
        the byte, or -1 if EOF is reached
        Throws:
        java.io.IOException - in case of any reading error.
      • get

        public int get​(long position,
                       byte[] bytes,
                       int off,
                       int len)
                throws java.io.IOException
        Read an array of bytes of specified length from the specified position of source to the buffer applying the offset. If the number of bytes requested cannot be read, all the possible bytes will be read to the buffer, and the number of actually read bytes will be returned.
        Specified by:
        get in interface IRandomAccessSource
        Parameters:
        position - the position in the RandomAccessSource to read from
        bytes - output buffer
        off - offset into the output buffer where results will be placed
        len - the number of bytes to read
        Returns:
        the number of bytes actually read, or -1 if the file is at EOF
        Throws:
        java.io.IOException - in case of any I/O error.
      • length

        public long length()
        Gets the length of the source
        Specified by:
        length in interface IRandomAccessSource
        Returns:
        the length of this source
      • close

        public void close()
                   throws java.io.IOException
        Does nothing - the underlying source is not closed
        Specified by:
        close in interface IRandomAccessSource
        Throws:
        java.io.IOException - in case of any reading error.