Package org.forgerock.http.io

Class BranchingInputStream

java.lang.Object

java.io.InputStream

org.forgerock.http.io.BranchingInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

FileBranchingStream

public abstract class BranchingInputStream
extends InputStream

An input stream that can branch into separate input streams to perform divergent reads.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BranchingInputStream(BranchingInputStream parent)	Initialise the BranchingInputStream with the specified parent.

Method Summary

Modifier and Type	Method	Description
abstract BranchingInputStream	branch()	Creates a new branch at this stream's current position.
abstract void	close()	Closes this branching stream and all of the branches created from it.
abstract BranchingInputStream	copy()	Creates a twin of this stream at this stream's current position.
BranchingInputStream	parent()	Returns the parent branching input stream from which this branch was created, or null if this is the trunk.

Methods inherited from class java.io.InputStream

available, mark, markSupported, nullInputStream, read, read, read, readAllBytes, readNBytes, readNBytes, reset, skip, transferTo

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BranchingInputStream

protected BranchingInputStream(BranchingInputStream parent)

Initialise the BranchingInputStream with the specified parent.

Parameters:

parent - The parent stream, or null if it is the trunk.

Method Detail

branch

public abstract BranchingInputStream branch()
                                     throws IOException

Creates a new branch at this stream's current position. The returned stream will have this stream as its parent.

Returns:

a new branching stream, in the same position as this branch.

Throws:

IOException - if an I/O exception occurs.

copy

public abstract BranchingInputStream copy()
                                   throws IOException

Creates a twin of this stream at this stream's current position. The returned stream will have the same parent as this stream.

Returns:

a new twin stream, in the same position as this branch.

Throws:

IOException - if an I/O exception occurs.

close

public abstract void close()
                    throws IOException

Closes this branching stream and all of the branches created from it.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class InputStream

Throws:

IOException - if an I/O exception occurs.

parent

public BranchingInputStream parent()

Returns the parent branching input stream from which this branch was created, or null if this is the trunk.

Returns:

the parent branching input stream from which this branch was created, or null if this is the trunk.