org.glassfish.grizzly.http.server.io

Class OutputBuffer

java.lang.Object

org.glassfish.grizzly.http.server.io.OutputBuffer

public class OutputBuffer
extends Object

Abstraction exposing both byte and character methods to write content to the HTTP messaging system in Grizzly.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	OutputBuffer.LifeCycleListener

Constructor Summary

Constructors

Constructor and Description
OutputBuffer()

Method Summary

Methods

Modifier and Type	Method and Description
void	acknowledge() Acknowledge a HTTP Expect header.
boolean	canWrite(int length)
boolean	canWriteChar(int length)
void	close()
void	endRequest()
void	flush() Flush the response.
int	getBufferedDataSize() Get the number of bytes buffered on OutputBuffer and ready to be sent.
int	getBufferSize()
void	initialize(Response response, FilterChainContext ctx)
boolean	isAsyncEnabled() Returns true if content will be written in a non-blocking fashion, otherwise returns false.
boolean	isClosed()
void	notifyCanWrite(WriteHandler handler, int length)
void	prepareCharacterEncoder()
void	recycle() Recycle the output buffer.
void	registerLifeCycleListener(OutputBuffer.LifeCycleListener listener)
boolean	removeLifeCycleListener(OutputBuffer.LifeCycleListener listener)
void	reset() Reset current response.
void	sendfile(File file, CompletionHandler<WriteResult> handler) Calls write(file, 0, file.length()).
void	sendfile(File file, long offset, long length, CompletionHandler<WriteResult> handler) Will use FileChannel.transferTo(long, long, java.nio.channels.WritableByteChannel) to send file to the remote endpoint.
void	setAsyncEnabled(boolean asyncEnabled) Sets the asynchronous processing state of this OutputBuffer.
void	setBufferSize(int bufferSize)
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(char[] cbuf)
void	write(char[] cbuf, int off, int len)
void	write(String str)
void	write(String str, int off, int len)
void	writeBuffer(Buffer buffer) Writes the contents of the specified Buffer to the client.
void	writeByte(int b)
void	writeByteBuffer(ByteBuffer byteBuffer) Writes the contents of the specified ByteBuffer to the client.
void	writeChar(int c)

Methods inherited from class java.lang.Object

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

Constructor Detail

OutputBuffer

public OutputBuffer()

Method Detail

initialize

public void initialize(Response response,
              FilterChainContext ctx)

isAsyncEnabled

public boolean isAsyncEnabled()

Returns true if content will be written in a non-blocking fashion, otherwise returns false.

Returns:

true if content will be written in a non-blocking fashion, otherwise returns false.

Since:

2.1.2

setAsyncEnabled

public void setAsyncEnabled(boolean asyncEnabled)

Sets the asynchronous processing state of this OutputBuffer.

Parameters:

asyncEnabled - true if this OutputBuffer will write content without blocking.

Since:

2.1.2

prepareCharacterEncoder

public void prepareCharacterEncoder()

getBufferSize

public int getBufferSize()

registerLifeCycleListener

public void registerLifeCycleListener(OutputBuffer.LifeCycleListener listener)

removeLifeCycleListener

public boolean removeLifeCycleListener(OutputBuffer.LifeCycleListener listener)

setBufferSize

public void setBufferSize(int bufferSize)

reset

public void reset()

Reset current response.

Throws:

IllegalStateException - if the response has already been committed

isClosed

public boolean isClosed()

Returns:

true if this OutputBuffer is closed, otherwise returns false.

getBufferedDataSize

public int getBufferedDataSize()

Get the number of bytes buffered on OutputBuffer and ready to be sent.

Returns:

the number of bytes buffered on OutputBuffer and ready to be sent.

recycle

public void recycle()

Recycle the output buffer. This should be called when closing the connection.

endRequest

public void endRequest()
                throws IOException

Throws:

IOException

acknowledge

public void acknowledge()
                 throws IOException

Acknowledge a HTTP Expect header. The response status code and reason phrase should be set before invoking this method.

Throws:

IOException - if an error occurs writing the acknowledgment.

writeChar

public void writeChar(int c)
               throws IOException

Throws:

IOException

write

public void write(char[] cbuf,
         int off,
         int len)
           throws IOException

Throws:

IOException

write

public void write(char[] cbuf)
           throws IOException

Throws:

IOException

write

public void write(String str)
           throws IOException

Throws:

IOException

write

public void write(String str,
         int off,
         int len)
           throws IOException

Throws:

IOException

writeByte

public void writeByte(int b)
               throws IOException

Throws:

IOException

write

public void write(byte[] b)
           throws IOException

Throws:

IOException

sendfile

public void sendfile(File file,
            CompletionHandler<WriteResult> handler)
              throws IOException

Calls write(file, 0, file.length()).

Parameters:

file - the File to transfer.

handler - CompletionHandler that will be notified of the transfer progress/completion or failure.

Throws:

IOException - if an error occurs during the transfer

IllegalArgumentException - if file is null

Since:

2.2

See Also:

sendfile(java.io.File, long, long, org.glassfish.grizzly.CompletionHandler)

sendfile

public void sendfile(File file,
            long offset,
            long length,
            CompletionHandler<WriteResult> handler)
              throws IOException

Will use FileChannel.transferTo(long, long, java.nio.channels.WritableByteChannel) to send file to the remote endpoint. Note that all headers necessary for the file transfer must be set prior to invoking this method as this will case the HTTP header to be flushed to the client prior to sending the file content. This should also be the last call to write any content to the remote endpoint.

It's required that the response be suspended when using this functionality. It will be assumed that if the response wasn't suspended when this method is called, that it's desired that this method manages the suspend/resume cycle.

Parameters:

file - the File to transfer.

offset - the starting offset within the File

length - the total number of bytes to transfer

handler - CompletionHandler that will be notified of the transfer progress/completion or failure.

Throws:

IOException - if an error occurs during the transfer

IOException - if an I/O error occurs

IllegalArgumentException - if the response has already been committed at the time this method was invoked.

IllegalStateException - if a file transfer request has already been made or if send file support isn't available.

IllegalStateException - if the response was in a suspended state when this method was invoked, but no CompletionHandler was provided.

Since:

2.2

write

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

Throws:

IOException

close

public void close()
           throws IOException

Throws:

IOException

flush

public void flush()
           throws IOException

Flush the response.

Throws:

IOException - an underlying I/O error occurred

writeByteBuffer

public void writeByteBuffer(ByteBuffer byteBuffer)
                     throws IOException

Writes the contents of the specified ByteBuffer to the client.

Note, that passed ByteBuffer will be directly used by underlying connection, so it could be reused only if it has been flushed.

Parameters:

byteBuffer - the ByteBuffer to write

Throws:

IOException - if an error occurs during the write

writeBuffer

public void writeBuffer(Buffer buffer)
                 throws IOException

Writes the contents of the specified Buffer to the client.

Note, that passed Buffer will be directly used by underlying connection, so it could be reused only if it has been flushed.

Parameters:

buffer - the Buffer to write

Throws:

IOException - if an error occurs during the write

canWriteChar

public boolean canWriteChar(int length)

canWrite

public boolean canWrite(int length)

See Also:

AsyncQueueWriter.canWrite(org.glassfish.grizzly.Connection, int)

notifyCanWrite

public void notifyCanWrite(WriteHandler handler,
                  int length)