Package com.adobe.internal.io
Class LazyRandomAccessFileByteWriter
- java.lang.Object
-
- com.adobe.internal.io.LazyRandomAccessFileByteWriter
-
- All Implemented Interfaces:
ByteReader
,ByteWriter
public class LazyRandomAccessFileByteWriter extends java.lang.Object implements ByteWriter
An implementation of the ByteWriter interface that provides lazy access to aRandomAccessFile
. It will not open theFile
until the first attempt to read or operate on thatFile
. At that point aRandomAccessFileByteReader
will be constructed and used. This class is not threadsafe. It is not safe to pass an instance of this class to multiple threads. It is not safe to pass an instance of this class to multiple users even if in the same thread.
-
-
Field Summary
-
Fields inherited from interface com.adobe.internal.io.ByteReader
EOF
-
-
Constructor Summary
Constructors Constructor Description LazyRandomAccessFileByteWriter(java.io.File file)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
close()
Closes thisByteReader
and releases any system resources associated with this stream.void
flush()
Flushes thisByteWriter
and forces any buffered output bytes to be written out.long
length()
Returns the number of total bytes in the repository that are visible through this API.int
read(long position)
Read a single byte from the underlying bytes at the given position.int
read(long position, byte[] b, int offset, int length)
Transfers bytes from the underlying repository into the given destination array.void
write(long position, byte[] b, int offset, int length)
Write an array of bytes at the position given.void
write(long position, int b)
Write the byte given at the position given.
-
-
-
Method Detail
-
read
public int read(long position) throws java.io.IOException
Description copied from interface:ByteReader
Read a single byte from the underlying bytes at the given position.- Specified by:
read
in interfaceByteReader
- Parameters:
position
- the position to read the byte from.- Returns:
- the byte at the postion or EOF if the position is outside of the legal range.
- Throws:
java.io.IOException
- if an error occurs during the read operation- See Also:
ByteReader.read(long)
-
read
public int read(long position, byte[] b, int offset, int length) throws java.io.IOException
Description copied from interface:ByteReader
Transfers bytes from the underlying repository into the given destination array. Copy up tolength
bytes from the repository starting at the postion given into the given array starting at the given offset.- Specified by:
read
in interfaceByteReader
- Parameters:
position
- the position to read the byte from.b
- the array to write the bytes into.offset
- the offset in the array at which the first byte is written.length
- the maximum number of bytes to write into the array.- Returns:
- the number of bytes actually written to the array.
- Throws:
java.io.IOException
- if an error occurs during the read operation- See Also:
ByteReader.read(long, byte[], int, int)
-
length
public long length() throws java.io.IOException
Description copied from interface:ByteReader
Returns the number of total bytes in the repository that are visible through this API.- Specified by:
length
in interfaceByteReader
- Returns:
- the number of bytes in the repository.
- Throws:
java.io.IOException
- if an error occurs while trying to determine the length- See Also:
ByteReader.length()
-
close
public void close() throws java.io.IOException
Description copied from interface:ByteReader
Closes thisByteReader
and releases any system resources associated with this stream.- Specified by:
close
in interfaceByteReader
- Throws:
java.io.IOException
- if an error occurs while trying to close- See Also:
ByteReader.close()
-
write
public void write(long position, int b) throws java.io.IOException
Write the byte given at the position given.- Specified by:
write
in interfaceByteWriter
- Parameters:
position
- the zero-based offset within the byte array.b
- the byte to write.- Throws:
java.io.IOException
-
write
public void write(long position, byte[] b, int offset, int length) throws java.io.IOException
Write an array of bytes at the position given.- Specified by:
write
in interfaceByteWriter
- Parameters:
position
- the zero-based offset within the byte array.b
- the array of bytes to write from.offset
- the offset within the byte array to start writing from.length
- the number of bytes to write from the byte array.- Throws:
java.io.IOException
-
flush
public void flush() throws java.io.IOException
Flushes thisByteWriter
and forces any buffered output bytes to be written out.- Specified by:
flush
in interfaceByteWriter
- Throws:
java.io.IOException
-
-