Class SequenceInputStream

public SequenceInputStream(InputStream> e)

This method creates a new SequenceInputStream that obtains its list of subordinate InputStreams from the specified Enumeration

Parameters:

e - An Enumeration that will return a list of InputStreams to read in sequence

public SequenceInputStream(InputStream s1,
                           InputStream s2)

This method creates a new SequenceInputStream that will read the two specified subordinate InputStreams in sequence.

Parameters:

s1 - The first InputStream to read

s2 - The second InputStream to read

public int available()
            throws IOException

This method returns the number of bytes than can be read from the currently being read subordinate stream before that stream could block. Note that it is possible more bytes than this can actually be read without the stream blocking. If a 0 is returned, then the stream could block on the very next read.

Overrides:

available in interface InputStream

Returns:

The number of bytes that can be read before blocking could occur

Throws:

IOException - If an error occurs

public void close()
            throws IOException

Closes this stream. This will cause any remaining unclosed subordinate InputStream's to be closed as well. Subsequent attempts to read from this stream may cause an exception.

Specified by:

close in interface Closeable

close in interface AutoCloseable

Overrides:

close in interface InputStream

Throws:

IOException - If an error occurs

public int read()
            throws IOException

This method reads an unsigned byte from the input stream and returns it as an int in the range of 0-255. This method also will return -1 if the end of the stream has been reached. This will only happen when all of the subordinate streams have been read.

This method will block until the byte can be read.

Overrides:

read in interface InputStream

Returns:

The byte read, or -1 if end of stream

Throws:

IOException - If an error occurs

public int read(byte[] b,
                int off,
                int len)
            throws IOException

This method reads bytes from a stream and stores them into a caller supplied buffer. It starts storing the data at index offset into the buffer and attempts to read len bytes. This method can return before reading the number of bytes requested. The actual number of bytes read is returned as an int. A -1 is returend to indicate the end of the stream. This will only happen when all of the subordinate streams have been read.

This method will block until at least one byte can be read.

Overrides:

read in interface InputStream

Parameters:

b - The array into which bytes read should be stored

off - The offset into the array to start storing bytes

len - The requested number of bytes to read

Returns:

The actual number of bytes read, or -1 if end of stream

Throws:

IOException - If an error occurs