org.eclipse.jetty.client.util

Class BufferingResponseListener

java.lang.Object

org.eclipse.jetty.client.api.Response.Listener.Empty

org.eclipse.jetty.client.util.BufferingResponseListener

All Implemented Interfaces:

Response.Listener

Direct Known Subclasses:

BlockingResponseListener

public class BufferingResponseListener
extends Response.Listener.Empty

Implementation of Response.Listener that buffers the content up to a maximum length specified to the constructors.

The content may be retrieved from Response.Listener.Empty.onSuccess(Response) or Response.Listener.Empty.onComplete(Result) via getContent() or getContentAsString().

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.client.api.Response.Listener

Response.Listener.Empty

Constructor Summary

Constructors

Constructor and Description
BufferingResponseListener() Creates an instance with a default maximum length of 2 MiB.
BufferingResponseListener(int maxLength) Creates an instance with the given maximum length

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	getContent()
String	getContentAsString()
String	getContentAsString(String encoding)
String	getEncoding()
void	onContent(Response response, ByteBuffer content) Callback method invoked when the response content has been received.
void	onHeaders(Response response) Callback method invoked when the response headers have been received and parsed.

Methods inherited from class org.eclipse.jetty.client.api.Response.Listener.Empty

onBegin, onComplete, onFailure, onSuccess

Methods inherited from class java.lang.Object

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

Constructor Detail

BufferingResponseListener

public BufferingResponseListener()

Creates an instance with a default maximum length of 2 MiB.

BufferingResponseListener

public BufferingResponseListener(int maxLength)

Creates an instance with the given maximum length

Parameters:

maxLength - the maximum length of the content

Method Detail

onHeaders

public void onHeaders(Response response)

Description copied from interface: Response.Listener

Callback method invoked when the response headers have been received and parsed.

Specified by:

onHeaders in interface Response.Listener

Overrides:

onHeaders in class Response.Listener.Empty

Parameters:

response - the response containing the response line data and the headers

onContent

public void onContent(Response response,
             ByteBuffer content)

Description copied from interface: Response.Listener

Callback method invoked when the response content has been received. This method may be invoked multiple times, and the content buffer must be consumed before returning from this method.

Specified by:

onContent in interface Response.Listener

Overrides:

onContent in class Response.Listener.Empty

Parameters:

response - the response containing the response line data and the headers

content - the content bytes received

getEncoding

public String getEncoding()

getContent

public byte[] getContent()

Returns:

the content as bytes

See Also:

getContentAsString()

getContentAsString

public String getContentAsString()

Returns:

the content as a string, using the "Content-Type" header to detect the encoding or defaulting to UTF-8 if the encoding could not be detected.

See Also:

getContentAsString(String)

getContentAsString

public String getContentAsString(String encoding)

Parameters:

encoding - the encoding of the content bytes

Returns:

the content as a string, with the specified encoding

See Also:

getContentAsString()