Class BufferedRandomAccess

java.lang.Object
de.intarsys.tools.randomaccess.AbstractRandomAccess
de.intarsys.tools.randomaccess.BufferedRandomAccess
All Implemented Interfaces:
IRandomAccess

public class BufferedRandomAccess extends AbstractRandomAccess
todo 1 length reply may be invalid
  • Constructor Summary

    Constructors
    Constructor
    Description
     
    BufferedRandomAccess(IRandomAccess randomAccess, int bufferSize)
     
  • Method Summary

    Modifier and Type
    Method
    Description
    protected int
    basicRead(byte[] buffer, int start, int numBytes)
     
    void
    Closes this random access data container and releases any system resources associated with the stream.
    protected void
     
    void
    Force changes to be made persistent.
    protected void
     
    long
    Returns the length of this data container.
    long
    Returns the current offset in this data container.
    protected boolean
     
    boolean
    true if this is a read only data container.
    int
    Reads a byte of data from this data container.
    int
    read(byte[] buffer)
    Reads up to buffer.length bytes of data from this data container into an array of bytes.
    int
    read(byte[] buffer, int start, int numBytes)
    Reads up to len bytes of data from this data container into an array of bytes.
    void
    seek(long offset)
    Sets the offset, measured from the beginning of the data container at which the next read or write occurs.
    void
    seekBy(long delta)
    Sets the offset, measured from the current offset at which the next read or write occurs.
    protected void
    setClosed(boolean closed)
     
    void
    setLength(long newLength)
    Assign the length.
    void
    write(byte[] buffer)
    Writes b.length bytes from the specified byte array, starting at the current offset.
    void
    write(byte[] buffer, int start, int numBytes)
    Writes len bytes from the specified byte array starting at start.
    void
    write(int b)
    Writes the specified byte .

    Methods inherited from class de.intarsys.tools.randomaccess.AbstractRandomAccess

    asInputStream, asOutputStream, getPositionStack, mark, reset

    Methods inherited from class java.lang.Object

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

  • Method Details

    • basicRead

      protected int basicRead(byte[] buffer, int start, int numBytes) throws IOException
      Throws:
      IOException
    • close

      public void close() throws IOException
      Description copied from interface: IRandomAccess
      Closes this random access data container and releases any system resources associated with the stream. A closed random access data container cannot perform input or output operations and cannot be reopened.
      Throws:
      IOException - if an I/O error occurs.
    • fillBuffer

      protected void fillBuffer() throws IOException
      Throws:
      IOException
    • flush

      public void flush() throws IOException
      Description copied from interface: IRandomAccess
      Force changes to be made persistent.
      Throws:
      IOException
    • flushBuffer

      protected void flushBuffer() throws IOException
      Throws:
      IOException
    • getLength

      public long getLength() throws IOException
      Description copied from interface: IRandomAccess
      Returns the length of this data container.
      Returns:
      the length of this data container, measured in bytes.
      Throws:
      IOException - if an I/O error occurs.
    • getOffset

      public long getOffset() throws IOException
      Description copied from interface: IRandomAccess
      Returns the current offset in this data container.
      Returns:
      the offset from the beginning of the data container, in bytes, at which the next read or write occurs.
      Throws:
      IOException - if an I/O error occurs.
    • isClosed

      protected boolean isClosed()
    • isReadOnly

      public boolean isReadOnly()
      Description copied from interface: IRandomAccess
      true if this is a read only data container.
      Returns:
      true if this is a read only data container.
    • read

      public int read() throws IOException
      Description copied from interface: IRandomAccess
      Reads a byte of data from this data container. The byte is returned as an integer in the range 0 to 255 (0x00-0x0ff). This method blocks if no input is yet available.

      This method behaves in exactly the same way as the InputStream.read() method of InputStream.

      Returns:
      the next byte of data, or -1 if the end of the data container has been reached.
      Throws:
      IOException - if an I/O error occurs. Not thrown if the end of the data container has been reached.
    • read

      public int read(byte[] buffer) throws IOException
      Description copied from interface: IRandomAccess
      Reads up to buffer.length bytes of data from this data container into an array of bytes. This method blocks until at least one byte of input is available.

      This method behaves in the exactly the same way as the InputStream.read(byte[]) method of InputStream.

      Parameters:
      buffer - the buffer into which the data is read.
      Returns:
      the total number of bytes read into the buffer, or -1 if there is no more data because the end of this data container has been reached.
      Throws:
      IOException - if an I/O error occurs.
    • read

      public int read(byte[] buffer, int start, int numBytes) throws IOException
      Description copied from interface: IRandomAccess
      Reads up to len bytes of data from this data container into an array of bytes. This method blocks until at least one byte of input is available.

      Parameters:
      buffer - the buffer into which the data is read.
      start - the start offset of the data.
      numBytes - the maximum number of bytes read.
      Returns:
      the total number of bytes read into the buffer, or -1 if there is no more data because the end of the file has been reached.
      Throws:
      IOException - if an I/O error occurs.
    • seek

      public void seek(long offset) throws IOException
      Description copied from interface: IRandomAccess
      Sets the offset, measured from the beginning of the data container at which the next read or write occurs. The offset may be set beyond the end of the data container. Setting the offset beyond the end of the data container does not change the data container length. The length will change only by writing after the offset has been set beyond the end of the data container.
      Parameters:
      offset - the offset position, measured in bytes from the beginning of the data container
      Throws:
      IOException - if offset is less than 0 or if an I/O error occurs.
    • seekBy

      public void seekBy(long delta) throws IOException
      Description copied from interface: IRandomAccess
      Sets the offset, measured from the current offset at which the next read or write occurs. The offset may be set beyond the end of the data container. Setting the offset beyond the end of the data container does not change the data container length. The length will change only by writing after the offset has been set beyond the end of the data container.
      Parameters:
      delta - the amount of bytes by which to change the current offset position
      Throws:
      IOException - if the resulting offset is less than 0 or if an I/O error occurs.
    • setClosed

      protected void setClosed(boolean closed)
    • setLength

      public void setLength(long newLength) throws IOException
      Description copied from interface: IRandomAccess
      Assign the length. All bytes after length are truncated. If the real length is currently less than newLength, the data structure will be enlarged.
      Throws:
      IOException
    • write

      public void write(byte[] buffer) throws IOException
      Description copied from interface: IRandomAccess
      Writes b.length bytes from the specified byte array, starting at the current offset.
      Parameters:
      buffer - the data.
      Throws:
      IOException - if an I/O error occurs.
    • write

      public void write(byte[] buffer, int start, int numBytes) throws IOException
      Description copied from interface: IRandomAccess
      Writes len bytes from the specified byte array starting at start.
      Parameters:
      buffer - the data.
      start - the start offset in the data.
      numBytes - the number of bytes to write.
      Throws:
      IOException - if an I/O error occurs.
    • write

      public void write(int b) throws IOException
      Description copied from interface: IRandomAccess
      Writes the specified byte . The write starts at the current offset.
      Parameters:
      b - the byte to be written.
      Throws:
      IOException - if an I/O error occurs.