com.adobe.internal.io

Class InputStreamByteWriter

java.lang.Object

com.adobe.internal.io.InputStreamByteWriter

All Implemented Interfaces:

ByteReader, ByteWriter

public final class InputStreamByteWriter
extends Object
implements ByteWriter

This class provides convenience functionality to take an InputStream and buffer the bytes from it and create an appropriate ByteReader implementation to wrap those bytes.

Field Summary

Fields inherited from interface com.adobe.internal.io.ByteReader

EOF

Constructor Summary

Constructors

Constructor and Description
InputStreamByteWriter(InputStream inputStream) Creates a new InputStreamByteWriter from the given InputStream.
InputStreamByteWriter(InputStream inputStream, RandomAccessFile raf) Creates a new InputStreamByteWriter from the given InputStream.

Method Summary

Modifier and Type	Method and Description
void	close() Closes this ByteReader and releases any system resources associated with this stream.
void	flush() Flushes this ByteWriter 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.
String	toString()
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.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

InputStreamByteWriter

public InputStreamByteWriter(InputStream inputStream)
                      throws IOException

Creates a new InputStreamByteWriter from the given InputStream. This reads all of the bytes from the InputStream into memory and then wraps those bytes with a ByteArrayByteReader. Once the constructor returns the stream will have been fully read and closed.

Parameters:

inputStream - the source of the bytes.

Throws:

IOException

InputStreamByteWriter

public InputStreamByteWriter(InputStream inputStream,
                             RandomAccessFile raf)
                      throws IOException

Creates a new InputStreamByteWriter from the given InputStream. This reads all of the bytes from the InputStream into the RandomAccessFile provided and then wraps that file with a RandomAccessFileByteReader. Once the constructor returnss the stream will have been fully read and closed. The provided RandomAccessFile must have read and write access.

Parameters:

inputStream - the source of the bytes.

raf - the location to buffer those bytes to.

Throws:

IOException

Method Detail

read

public int read(long position)
         throws IOException

Description copied from interface: ByteReader

Read a single byte from the underlying bytes at the given position.

Specified by:

read in interface ByteReader

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:

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 IOException

Description copied from interface: ByteReader

Transfers bytes from the underlying repository into the given destination array. Copy up to length bytes from the repository starting at the postion given into the given array starting at the given offset.

Specified by:

read in interface ByteReader

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:

IOException - if an error occurs during the read operation

See Also:

ByteReader.read(long, byte[], int, int)

length

public long length()
            throws 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 interface ByteReader

Returns:

the number of bytes in the repository.

Throws:

IOException - if an error occurs while trying to determine the length

See Also:

ByteReader.length()

close

public void close()
           throws IOException

Description copied from interface: ByteReader

Closes this ByteReader and releases any system resources associated with this stream.

Specified by:

close in interface ByteReader

Throws:

IOException - if an error occurs while trying to close

See Also:

ByteReader.close()

toString

public String toString()

Overrides:

toString in class Object

See Also:

Object.toString()

write

public void write(long position,
                  int b)
           throws IOException

Write the byte given at the position given.

Specified by:

write in interface ByteWriter

Parameters:

position - the zero-based offset within the byte array.

b - the byte to write.

Throws:

IOException

write

public void write(long position,
                  byte[] b,
                  int offset,
                  int length)
           throws IOException

Write an array of bytes at the position given.

Specified by:

write in interface ByteWriter

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:

IOException

flush

public void flush()
           throws IOException

Flushes this ByteWriter and forces any buffered output bytes to be written out.

Specified by:

flush in interface ByteWriter

Throws:

IOException