org.apache.juneau.internal

Class TeeOutputStream

java.lang.Object

java.io.OutputStream

org.apache.juneau.internal.TeeOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public class TeeOutputStream
extends OutputStream

Output stream that can send output to multiple output streams.

Constructor Summary

Constructors

Constructor and Description
TeeOutputStream(Collection<OutputStream> outputStreams) Constructor.
TeeOutputStream(OutputStream... outputStreams) Constructor.

Method Summary

Modifier and Type	Method and Description
TeeOutputStream	add(OutputStream os, boolean close) Adds an output stream to this tee output stream.
TeeOutputStream	add(String id, OutputStream os, boolean close) Same as add(OutputStream, boolean) but associates the stream with an identifier so the stream can be retrieved through getOutputStream(String).
void	close()
void	flush()
OutputStream	getOutputStream(String id) Returns the output stream identified through the id parameter passed in through the add(String, OutputStream, boolean) method.
int	size() Returns the number of inner streams in this tee stream.
void	write(byte[] b, int off, int len)
void	write(int b)

Methods inherited from class java.io.OutputStream

write

Methods inherited from class java.lang.Object

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

Constructor Detail

TeeOutputStream

public TeeOutputStream(OutputStream... outputStreams)

Constructor.

Parameters:

outputStreams - The list of output streams.

TeeOutputStream

public TeeOutputStream(Collection<OutputStream> outputStreams)

Constructor.

Parameters:

outputStreams - The list of output streams.

Method Detail

add

public TeeOutputStream add(OutputStream os,
                           boolean close)

Adds an output stream to this tee output stream.

Parameters:

os - The output stream to add to this tee output stream.

close - If false, then calling close() on this stream will not filter to the specified output stream.

Returns:

This object (for method chaining).

getOutputStream

public OutputStream getOutputStream(String id)

Returns the output stream identified through the id parameter passed in through the add(String, OutputStream, boolean) method.

Parameters:

id - The ID associated with the output stream.

Returns:

The output stream, or null if no identifier was specified when the output stream was added.

add

public TeeOutputStream add(String id,
                           OutputStream os,
                           boolean close)

Same as add(OutputStream, boolean) but associates the stream with an identifier so the stream can be retrieved through getOutputStream(String).

Parameters:

id - The ID to associate the output stream with.

os - The output stream to add.

close - Close the specified stream afterwards.

Returns:

This object (for method chaining).

size

public int size()

Returns the number of inner streams in this tee stream.

Returns:

The number of streams in this tee stream.

write

public void write(int b)
           throws IOException

Specified by:

write in class OutputStream

Throws:

IOException

write

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

Overrides:

write in class OutputStream

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Overrides:

flush in class OutputStream

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class OutputStream

Throws:

IOException