org.forgerock.http.protocol

Class Response

java.lang.Object

org.forgerock.http.protocol.MessageImpl<Response>

org.forgerock.http.protocol.Response

All Implemented Interfaces:

Closeable, AutoCloseable, Message

public final class Response
extends MessageImpl<Response>

A response message.

Constructor Summary

Constructors

Constructor and Description
Response() Creates a new response.
Response(Response response) Creates a defensive copy of the given response message.
Response(Status status) Creates a new response with a default status.

Method Summary

Modifier and Type	Method and Description
Exception	getCause() Returns the (possibly null) cause of this error message (assuming it is a 4xx or a 5xx).
Status	getStatus() Returns the response status.
static Promise<Response,NeverThrowsException>	newResponsePromise(Response response) Returns a Promise representing the Response for an asynchronous Request which has already completed.
static PromiseImpl<Response,NeverThrowsException>	newResponsePromiseImpl() Creates a new pending Promise implementation representing the Response for an asynchronous Request.
Response	setCause(Exception cause) Link a 'caused by' exception to this response.
Response	setEntity(Object o) Sets the content of the entity to the provided value.
Response	setStatus(Status status) Sets the response status code.
Response	setVersion(String version) Sets the protocol version.

Methods inherited from class org.forgerock.http.protocol.MessageImpl

close, getEntity, getHeaders, getVersion

Methods inherited from class java.lang.Object

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

Constructor Detail

Response

public Response()

Creates a new response.

Response

public Response(Response response)
         throws IOException

Creates a defensive copy of the given response message.

Parameters:

response - response to be copied

Throws:

IOException - when entity cannot be cloned

Response

public Response(Status status)

Creates a new response with a default status.

Parameters:

status - The status to use for the Reponse.

Method Detail

newResponsePromise

public static Promise<Response,NeverThrowsException> newResponsePromise(Response response)

Returns a Promise representing the Response for an asynchronous Request which has already completed. Attempts to get the Response will immediately return without blocking, and any listeners registered against the returned promise will be immediately invoked in the same thread as the caller.

Parameters:

response - The Response.

Returns:

A Promise representing the Response for an asynchronous Request which has already completed.

newResponsePromiseImpl

public static PromiseImpl<Response,NeverThrowsException> newResponsePromiseImpl()

Creates a new pending Promise implementation representing the Response for an asynchronous Request. The returned PromiseImpl must be completed once the Response is received by invoking the handleResult method.

Returns:

A new pending Promise implementation representing the Response for an asynchronous Request.

getStatus

public Status getStatus()

Returns the response status.

Returns:

The response status.

getCause

public Exception getCause()

Returns the (possibly null) cause of this error message (assuming it is a 4xx or a 5xx).

Returns:

the (possibly null) cause of this error message (assuming it is a 4xx or a 5xx).

setCause

public Response setCause(Exception cause)

Link a 'caused by' exception to this response. That can be used to determine if this error response was triggered by an exception (as opposed to obtained from a remote server). Note: this method does not change the status of this message, neither touch its content. It's up to the caller to ensure consistency (if required in the execution context).

Parameters:

cause - Cause of this error response

Returns:

This response.

setEntity

public Response setEntity(Object o)

Description copied from interface: Message

Sets the content of the entity to the provided value. Calling this method will close any existing streams associated with the entity. May also set the Content-Length header, overwriting any existing header.

This method is intended mostly as a convenience method within scripts. The parameter will be handled depending on its type as follows:

• BranchingInputStream - equivalent to calling Entity.setRawContentInputStream(org.forgerock.http.io.BranchingInputStream)
• byte[] - equivalent to calling Entity.setBytes(byte[])
• String - equivalent to calling Entity.setString(java.lang.String)
• Object - equivalent to calling Entity.setJson(java.lang.Object).

Note: This method does not attempt to encode the entity based-on any codings specified in the Content-Encoding header.

Parameters:

o - The object whose value should be stored in the entity.

Returns:

This message.

setStatus

public Response setStatus(Status status)

Sets the response status code.

Parameters:

status - The response status code.

Returns:

This response.

setVersion

public Response setVersion(String version)

Description copied from interface: Message

Sets the protocol version. Default: HTTP/1.1.

Parameters:

version - The protocol version.

Returns:

This message.