Package io.micronaut.core.io.buffer

Interface ReadBufferFactory.BufferingOutputStream

All Superinterfaces:

AutoCloseable, Closeable

Enclosing class:

ReadBufferFactory

public static interface ReadBufferFactory.BufferingOutputStream
extends Closeable

Wrapper around a OutputStream that buffers into a ReadBuffer. Must be closed after use, even if finishBuffer() has not been called (e.g. on error), to avoid resource leaks.

Method Summary

Modifier and Type	Method	Description
void	close()	Close this buffer.
@NonNull ReadBuffer	finishBuffer()	Finalize this buffer, returning it as a ReadBuffer.
@NonNull OutputStream	stream()	Get the stream you can write to.

Method Details

stream

@NonNull
@NonNull OutputStream stream()
                      throws IllegalStateException

Get the stream you can write to. May be called multiple times.

Returns:

The OutputStream

Throws:

IllegalStateException - If the buffer has already been finalized

finishBuffer

@NonNull
@NonNull ReadBuffer finishBuffer()
                          throws IOException,
IllegalStateException

Finalize this buffer, returning it as a ReadBuffer. This method can only be called once. Release ownership of the buffer transfers to the caller: Closing this ReadBufferFactory.BufferingOutputStream after this method has been called will not close the returned ReadBuffer.

Returns:

The finished buffer

Throws:

IOException - If there was an exception finishing up the buffer

IllegalStateException - If this method has already been called

close

void close()
    throws IOException

Close this buffer. finishBuffer() cannot be called after this method. If it has not been called yet, the content of this buffer will be discarded.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException - If there was an exception finishing up the buffer