public class BufferedRandomAccess extends AbstractRandomAccess
Constructor and Description |
---|
BufferedRandomAccess(IRandomAccess randomAccess) |
BufferedRandomAccess(IRandomAccess randomAccess,
int bufferSize) |
Modifier and Type | Method and Description |
---|---|
protected int |
basicRead(byte[] buffer,
int start,
int numBytes) |
void |
close()
Closes this random access data container and releases any system
resources associated with the stream.
|
protected void |
fillBuffer() |
void |
flush()
Force changes to be made persistent.
|
protected void |
flushBuffer() |
long |
getLength()
Returns the length of this data container.
|
long |
getOffset()
Returns the current offset in this data container.
|
protected boolean |
isClosed() |
boolean |
isReadOnly()
true if this is a read only data container. |
int |
read()
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 .
|
asInputStream, asOutputStream, getPositionStack, mark, reset
public BufferedRandomAccess(IRandomAccess randomAccess) throws java.io.IOException
java.io.IOException
public BufferedRandomAccess(IRandomAccess randomAccess, int bufferSize) throws java.io.IOException
java.io.IOException
protected int basicRead(byte[] buffer, int start, int numBytes) throws java.io.IOException
java.io.IOException
public void close() throws java.io.IOException
IRandomAccess
java.io.IOException
- if an I/O error occurs.protected void fillBuffer() throws java.io.IOException
java.io.IOException
public void flush() throws java.io.IOException
IRandomAccess
java.io.IOException
protected void flushBuffer() throws java.io.IOException
java.io.IOException
public long getLength() throws java.io.IOException
IRandomAccess
java.io.IOException
- if an I/O error occurs.public long getOffset() throws java.io.IOException
IRandomAccess
java.io.IOException
- if an I/O error occurs.protected boolean isClosed()
public boolean isReadOnly()
IRandomAccess
true
if this is a read only data container.true
if this is a read only data container.public int read() throws java.io.IOException
IRandomAccess
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
.
-1
if the end of the data
container has been reached.java.io.IOException
- if an I/O error occurs. Not thrown if the end of the data
container has been reached.public int read(byte[] buffer) throws java.io.IOException
IRandomAccess
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
.
buffer
- the buffer into which the data is read.-1
if there is no more data because the end of this
data container has been reached.java.io.IOException
- if an I/O error occurs.public int read(byte[] buffer, int start, int numBytes) throws java.io.IOException
IRandomAccess
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.
buffer
- the buffer into which the data is read.start
- the start offset of the data.numBytes
- the maximum number of bytes read.-1
if there is no more data because the end of the
file has been reached.java.io.IOException
- if an I/O error occurs.public void seek(long offset) throws java.io.IOException
IRandomAccess
offset
- the offset position, measured in bytes from the beginning of
the data containerjava.io.IOException
- if offset
is less than 0
or if
an I/O error occurs.public void seekBy(long delta) throws java.io.IOException
IRandomAccess
delta
- the amount of bytes by which to change the current offset
positionjava.io.IOException
- if the resulting offset
is less than
0
or if an I/O error occurs.protected void setClosed(boolean closed)
public void setLength(long newLength) throws java.io.IOException
IRandomAccess
java.io.IOException
public void write(byte[] buffer) throws java.io.IOException
IRandomAccess
b.length
bytes from the specified byte array,
starting at the current offset.buffer
- the data.java.io.IOException
- if an I/O error occurs.public void write(byte[] buffer, int start, int numBytes) throws java.io.IOException
IRandomAccess
len
bytes from the specified byte array starting at
start
.buffer
- the data.start
- the start offset in the data.numBytes
- the number of bytes to write.java.io.IOException
- if an I/O error occurs.public void write(int b) throws java.io.IOException
IRandomAccess
b
- the byte
to be written.java.io.IOException
- if an I/O error occurs.