Package com.yahoo.jdisc.handler

Class FastContentOutputStream

java.lang.Object

java.io.OutputStream

com.yahoo.jdisc.handler.FastContentOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable, Future<Boolean>

public class FastContentOutputStream
extends OutputStream
implements Future<Boolean>

This class extends the AbstractContentOutputStream, and forwards all write() and close() calls to a FastContentWriter. This means that once OutputStream.close() has been called, the asynchronous completion of all pending operations can be awaited using the Future interface of this class. Any asynchronous failure will be rethrown when calling either of the get() methods on this class.

Please notice that the Future implementation of this class will NEVER complete unless OutputStream.close() has been called.

Author:

Simon Thoresen Hult

Field Summary

Fields

Modifier and Type	Field	Description
static final int	BUFFERSIZE

Constructor Summary

Constructors

Constructor	Description
FastContentOutputStream(ContentChannel out)	Constructs a new FastContentOutputStream that writes into the given ContentChannel.
FastContentOutputStream(FastContentWriter out)	Constructs a new FastContentOutputStream that writes into the given FastContentWriter.

Method Summary

Modifier and Type	Method	Description
void	addListener(Runnable listener, Executor executor)
boolean	cancel(boolean mayInterruptIfRunning)
final void	close()
protected void	doClose()
protected void	doFlush(ByteBuffer buf)
final void	flush()
Boolean	get()
Boolean	get(long timeout, TimeUnit unit)
boolean	isCancelled()
boolean	isDone()
final void	write(byte[] buffer)
final void	write(byte[] buffer, int offset, int length)
final void	write(int b)

Methods inherited from class java.io.OutputStream

nullOutputStream

Methods inherited from class java.lang.Object

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

Field Details

BUFFERSIZE

public static final int BUFFERSIZE

See Also:

• Constant Field Values

Constructor Details

FastContentOutputStream

public FastContentOutputStream(ContentChannel out)

Constructs a new FastContentOutputStream that writes into the given ContentChannel.

Parameters:

out - The ContentChannel to write the stream into.

FastContentOutputStream

public FastContentOutputStream(FastContentWriter out)

Constructs a new FastContentOutputStream that writes into the given FastContentWriter.

Parameters:

out - The ContentWriter to write the stream into.

Method Details

doFlush

protected void doFlush(ByteBuffer buf)

doClose

protected void doClose()

cancel

public boolean cancel(boolean mayInterruptIfRunning)

Specified by:

cancel in interface Future<Boolean>

isCancelled

public boolean isCancelled()

Specified by:

isCancelled in interface Future<Boolean>

isDone

public boolean isDone()

Specified by:

isDone in interface Future<Boolean>

get

public Boolean get()
            throws InterruptedException,
ExecutionException

Specified by:

get in interface Future<Boolean>

Throws:

InterruptedException

ExecutionException

get

public Boolean get(long timeout,
 TimeUnit unit)
            throws InterruptedException,
ExecutionException,
TimeoutException

Specified by:

get in interface Future<Boolean>

Throws:

InterruptedException

ExecutionException

TimeoutException

addListener

public void addListener(Runnable listener,
 Executor executor)

write

public final void write(int b)

Specified by:

write in class OutputStream

write

public final void write(byte[] buffer,
 int offset,
 int length)

Overrides:

write in class OutputStream

write

public final void write(byte[] buffer)

Overrides:

write in class OutputStream

flush

public final void flush()

Specified by:

flush in interface Flushable

Overrides:

flush in class OutputStream

close

public final void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class OutputStream