org.eclipse.jetty.server

Class HttpOutput

java.lang.Object

java.io.OutputStream

javax.servlet.ServletOutputStream

org.eclipse.jetty.server.HttpOutput

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable, Runnable

public class HttpOutput
extends ServletOutputStream
implements Runnable

HttpOutput implements ServletOutputStream as required by the Servlet specification.

HttpOutput buffers content written by the application until a further write will overflow the buffer, at which point it triggers a commit of the response.

HttpOutput can be closed and reopened, to allow requests included via RequestDispatcher.include(ServletRequest, ServletResponse) to close the stream, to be reopened after the inclusion ends.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	HttpOutput.Interceptor The HttpOutput.Interceptor is a single intercept point for all output written to the HttpOutput: via writer; via output stream; asynchronously; or blocking.

Constructor Summary

Constructors

Constructor and Description
HttpOutput(HttpChannel channel)

Method Summary

Modifier and Type	Method and Description
protected SharedBlockingCallback.Blocker	acquireWriteBlockingCallback()
void	close()
void	flush()
int	getBufferSize()
HttpChannel	getHttpChannel()
HttpOutput.Interceptor	getInterceptor()
long	getWritten()
boolean	isAllContentWritten()
boolean	isClosed()
boolean	isReady()
boolean	isWritten()
void	print(String s)
void	recycle()
void	reopen()
void	resetBuffer()
void	run()
void	sendContent(ByteBuffer content) Blocking send of whole content.
void	sendContent(ByteBuffer content, Callback callback) Asynchronous send of whole content.
void	sendContent(HttpContent content) Blocking send of HTTP content.
void	sendContent(HttpContent httpContent, Callback callback) Asynchronous send of HTTP content.
void	sendContent(InputStream in) Blocking send of stream content.
void	sendContent(InputStream in, Callback callback) Asynchronous send of stream content.
void	sendContent(ReadableByteChannel in) Blocking send of channel content.
void	sendContent(ReadableByteChannel in, Callback callback) Asynchronous send of channel content.
void	setBufferSize(int size)
void	setInterceptor(HttpOutput.Interceptor filter)
void	setWriteListener(WriteListener writeListener)
String	toString()
void	write(byte[] b, int off, int len)
void	write(ByteBuffer buffer)
protected void	write(ByteBuffer content, boolean complete, Callback callback)
void	write(int b)

Methods inherited from class javax.servlet.ServletOutputStream

print, print, print, print, print, print, println, println, println, println, println, println, println, println

Methods inherited from class java.io.OutputStream

write

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpOutput

public HttpOutput(HttpChannel channel)

Method Detail

getHttpChannel

public HttpChannel getHttpChannel()

getInterceptor

public HttpOutput.Interceptor getInterceptor()

setInterceptor

public void setInterceptor(HttpOutput.Interceptor filter)

isWritten

public boolean isWritten()

getWritten

public long getWritten()

reopen

public void reopen()

isAllContentWritten

public boolean isAllContentWritten()

acquireWriteBlockingCallback

protected SharedBlockingCallback.Blocker acquireWriteBlockingCallback()
                                                               throws IOException

Throws:

IOException

write

protected void write(ByteBuffer content,
                     boolean complete,
                     Callback callback)

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class OutputStream

isClosed

public boolean isClosed()

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Overrides:

flush in class OutputStream

Throws:

IOException

write

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

Overrides:

write in class OutputStream

Throws:

IOException

write

public void write(ByteBuffer buffer)
           throws IOException

Throws:

IOException

write

public void write(int b)
           throws IOException

Specified by:

write in class OutputStream

Throws:

IOException

print

public void print(String s)
           throws IOException

Overrides:

print in class ServletOutputStream

Throws:

IOException

sendContent

public void sendContent(ByteBuffer content)
                 throws IOException

Blocking send of whole content.

Parameters:

content - The whole content to send

Throws:

IOException - if the send fails

sendContent

public void sendContent(InputStream in)
                 throws IOException

Blocking send of stream content.

Parameters:

in - The stream content to send

Throws:

IOException - if the send fails

sendContent

public void sendContent(ReadableByteChannel in)
                 throws IOException

Blocking send of channel content.

Parameters:

in - The channel content to send

Throws:

IOException - if the send fails

sendContent

public void sendContent(HttpContent content)
                 throws IOException

Blocking send of HTTP content.

Parameters:

content - The HTTP content to send

Throws:

IOException - if the send fails

sendContent

public void sendContent(ByteBuffer content,
                        Callback callback)

Asynchronous send of whole content.

Parameters:

content - The whole content to send

callback - The callback to use to notify success or failure

sendContent

public void sendContent(InputStream in,
                        Callback callback)

Asynchronous send of stream content. The stream will be closed after reading all content.

Parameters:

in - The stream content to send

callback - The callback to use to notify success or failure

sendContent

public void sendContent(ReadableByteChannel in,
                        Callback callback)

Asynchronous send of channel content. The channel will be closed after reading all content.

Parameters:

in - The channel content to send

callback - The callback to use to notify success or failure

sendContent

public void sendContent(HttpContent httpContent,
                        Callback callback)

Asynchronous send of HTTP content.

Parameters:

httpContent - The HTTP content to send

callback - The callback to use to notify success or failure

getBufferSize

public int getBufferSize()

setBufferSize

public void setBufferSize(int size)

recycle

public void recycle()

resetBuffer

public void resetBuffer()

setWriteListener

public void setWriteListener(WriteListener writeListener)

Specified by:

setWriteListener in class ServletOutputStream

isReady

public boolean isReady()

Specified by:

isReady in class ServletOutputStream

See Also:

ServletOutputStream.isReady()

run

public void run()

Specified by:

run in interface Runnable

toString

public String toString()

Overrides:

toString in class Object