Index (Frames) | Index (No Frames) | Package | Package Tree | Tree
java.io

Class SequenceInputStream

java.lang.Object
|
+--java.io.InputStream
   |
   +--java.io.SequenceInputStream


public class SequenceInputStream

extends InputStream

This class merges a sequence of multiple InputStream's in order to form a single logical stream that can be read by applications that expect only one stream.

The streams passed to the constructor method are read in order until they return -1 to indicate they are at end of stream. When a stream reports end of stream, it is closed, then the next stream is read. When the last stream is closed, the next attempt to read from this stream will return a -1 to indicate it is at end of stream.

If this stream is closed prior to all subordinate streams being read to completion, all subordinate streams are closed.

Authors:

Constructor Summary

SequenceInputStream(java.util.Enumeration e)

This method creates a new SequenceInputStream that obtains its list of subordinate InputStreams from the specified Enumeration
SequenceInputStream(java.io.InputStream s1, java.io.InputStream s2)

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

Method Summary

intavailable()

This method returns the number of bytes than can be read from the currently being read subordinate stream before that stream could block.
voidclose()

Closes this stream.
intread()

This method reads an unsigned byte from the input stream and returns it as an int in the range of 0-255.
intread(byte[] b, int off, int len)

This method reads bytes from a stream and stores them into a caller supplied buffer.

Constructor Details

SequenceInputStream

public SequenceInputStream(java.io.InputStream s1, java.io.InputStream s2)

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

Parameters:


SequenceInputStream

public SequenceInputStream(java.util.Enumeration e)

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

Parameters:


Method Details

available

public int available()

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.

Returns:

Throws:


close

public void close()

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.

Throws:


read

public int read()

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.

Returns:

Throws:


read

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

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.

Parameters:

Returns:

Throws: