org.restlet.util
Class WrapperResponse

java.lang.Object
  org.restlet.Message
      org.restlet.Response
          org.restlet.util.WrapperResponse

public class WrapperResponse
extends Response

Request wrapper. Useful for application developer who need to enrich the request with application related properties and behavior.

Author:

Jerome Louvel

See Also:

The decorator (aka wrapper) pattern

Constructor Summary

WrapperResponse(Response wrappedResponse)
Constructor.

Method Summary

void	abort()
void	commit()
int	getAge()
Set<Method>	getAllowedMethods() Returns the set of methods allowed on the requested resource.
ConcurrentMap<String,Object>	getAttributes() Returns a modifiable attributes map that can be used by developers to save information relative to the message.
AuthenticationInfo	getAuthenticationInfo()
List<ChallengeRequest>	getChallengeRequests() Returns the list of authentication requests sent by an origin server to a client.
Series<CookieSetting>	getCookieSettings() Returns the cookie settings provided by the server.
Set<Dimension>	getDimensions() Returns the set of selecting dimensions on which the response entity may vary.
Representation	getEntity() Returns the entity representation.
Reference	getLocationRef() Returns the reference that the client should follow for redirections or resource creations.
List<ChallengeRequest>	getProxyChallengeRequests() Returns the list of authentication requests sent by a proxy to a client.
Request	getRequest() Returns the associated request
Date	getRetryAfter()
ServerInfo	getServerInfo() Returns the server-specific information.
Status	getStatus() Returns the status.
protected Response	getWrappedResponse() Returns the wrapped response.
boolean	isAutoCommitting()
boolean	isCommitted()
boolean	isConfidential() Indicates if the call came over a confidential channel such as an SSL-secured connection.
boolean	isEntityAvailable() Indicates if a content is available and can be sent.
void	redirectPermanent(Reference targetRef) Permanently redirects the client to a target URI.
void	redirectPermanent(String targetUri) Permanently redirects the client to a target URI.
void	redirectSeeOther(Reference targetRef) Redirects the client to a different URI that SHOULD be retrieved using a GET method on that resource.
void	redirectSeeOther(String targetUri) Redirects the client to a different URI that SHOULD be retrieved using a GET method on that resource.
void	redirectTemporary(Reference targetRef) Temporarily redirects the client to a target URI.
void	redirectTemporary(String targetUri) Temporarily redirects the client to a target URI.
void	setAge(int age)
void	setAllowedMethods(Set<Method> allowedMethods)
void	setAuthenticationInfo(AuthenticationInfo authenticationInfo)
void	setAutoCommitting(boolean autoCommitting)
void	setChallengeRequests(List<ChallengeRequest> requests) Sets the list of authentication requests sent by an origin server to a client.
void	setCommitted(boolean committed)
void	setCookieSettings(Series<CookieSetting> cookieSettings)
void	setDimensions(Set<Dimension> dimensions)
void	setEntity(Representation entity) Sets the entity representation.
void	setEntity(String value, MediaType mediaType) Sets a textual entity.
void	setLocationRef(Reference locationRef) Sets the reference that the client should follow for redirections or resource creations.
void	setLocationRef(String locationUri) Sets the reference that the client should follow for redirections or resource creations.
void	setProxyChallengeRequests(List<ChallengeRequest> requests) Sets the list of authentication requests sent by a proxy to a client.
void	setRequest(Request request) Sets the associated request.
void	setRequest(WrapperRequest request) Sets the associated request.
void	setRetryAfter(Date retryAfter)
void	setServerInfo(ServerInfo serverInfo)
void	setStatus(Status status) Sets the status.
void	setStatus(Status status, String message) Sets the status.
void	setStatus(Status status, Throwable throwable)
void	setStatus(Status status, Throwable throwable, String message)
String	toString()

Methods inherited from class org.restlet.Response

getCurrent, isFinal, isProvisional, setCurrent

Methods inherited from class org.restlet.Message

getCacheDirectives, getDate, getEntityAsText, getOnError, getOnSent, getRecipientsInfo, getWarnings, release, setAttributes, setCacheDirectives, setDate, setOnError, setOnSent, setRecipientsInfo, setWarnings

Methods inherited from class java.lang.Object

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

Constructor Detail

WrapperResponse

public WrapperResponse(Response wrappedResponse)

Constructor.

Parameters:

wrappedResponse - The wrapped response.

Method Detail

abort

public void abort()

Overrides:

abort in class Response

commit

public void commit()

Overrides:

commit in class Response

getAge

public int getAge()

Overrides:

getAge in class Response

getAllowedMethods

public Set<Method> getAllowedMethods()

Returns the set of methods allowed on the requested resource. This property only has to be updated when a status CLIENT_ERROR_METHOD_NOT_ALLOWED is set.

Overrides:

getAllowedMethods in class Response

Returns:

The list of allowed methods.

getAttributes

public ConcurrentMap<String,Object> getAttributes()

Returns a modifiable attributes map that can be used by developers to save information relative to the message. This is an easier alternative to the creation of a wrapper instance around the whole message.

In addition, this map is a shared space between the developer and the connectors. In this case, it is used to exchange information that is not uniform across all protocols and couldn't therefore be directly included in the API. For this purpose, all attribute names starting with "org.restlet" are reserved. Currently the following attributes are used:

Attribute name	Class name	Description
org.restlet.http.headers	org.restlet.data.Form	Server HTTP connectors must provide all request headers and client HTTP connectors must provide all response headers, exactly as they were received. In addition, developers can also use this attribute to specify non-standard headers that should be added to the request or to the response.

Adding standard HTTP headers is forbidden because it could conflict with the connector's internal behavior, limit portability or prevent future optimizations.

Overrides:

getAttributes in class Message

Returns:

The modifiable attributes map.

getAuthenticationInfo

public AuthenticationInfo getAuthenticationInfo()

Overrides:

getAuthenticationInfo in class Response

getChallengeRequests

public List<ChallengeRequest> getChallengeRequests()

Returns the list of authentication requests sent by an origin server to a client.

Overrides:

getChallengeRequests in class Response

Returns:

The list of authentication requests sent by an origin server to a client.

getCookieSettings

public Series<CookieSetting> getCookieSettings()

Returns the cookie settings provided by the server.

Overrides:

getCookieSettings in class Response

Returns:

The cookie settings provided by the server.

getDimensions

public Set<Dimension> getDimensions()

Returns the set of selecting dimensions on which the response entity may vary. If some server-side content negotiation is done, this set should be properly updated, other it can be left empty.

Overrides:

getDimensions in class Response

Returns:

The set of dimensions on which the response entity may vary.

getEntity

public Representation getEntity()

Returns the entity representation.

Overrides:

getEntity in class Message

Returns:

The entity representation.

getLocationRef

public Reference getLocationRef()

Returns the reference that the client should follow for redirections or resource creations.

Overrides:

getLocationRef in class Response

Returns:

The redirection reference.

getProxyChallengeRequests

public List<ChallengeRequest> getProxyChallengeRequests()

Returns the list of authentication requests sent by a proxy to a client.

Overrides:

getProxyChallengeRequests in class Response

Returns:

The list of authentication requests sent by a proxy to a client.

getRequest

public Request getRequest()

Returns the associated request

Overrides:

getRequest in class Response

Returns:

The associated request

getRetryAfter

public Date getRetryAfter()

Overrides:

getRetryAfter in class Response

getServerInfo

public ServerInfo getServerInfo()

Returns the server-specific information.

Overrides:

getServerInfo in class Response

Returns:

The server-specific information.

getStatus

public Status getStatus()

Returns the status.

Overrides:

getStatus in class Response

Returns:

The status.

getWrappedResponse

protected Response getWrappedResponse()

Returns the wrapped response.

Returns:

The wrapped response.

isAutoCommitting

public boolean isAutoCommitting()

Overrides:

isAutoCommitting in class Response

isCommitted

public boolean isCommitted()

Overrides:

isCommitted in class Response

isConfidential

public boolean isConfidential()

Indicates if the call came over a confidential channel such as an SSL-secured connection.

Overrides:

isConfidential in class Response

Returns:

True if the call came over a confidential channel.

isEntityAvailable

public boolean isEntityAvailable()

Indicates if a content is available and can be sent. Several conditions must be met: the content must exists and have some available data.

Overrides:

isEntityAvailable in class Message

Returns:

True if a content is available and can be sent.

redirectPermanent

public void redirectPermanent(Reference targetRef)

Permanently redirects the client to a target URI. The client is expected to reuse the same method for the new request.

Overrides:

redirectPermanent in class Response

Parameters:

targetRef - The target URI reference.

redirectPermanent

public void redirectPermanent(String targetUri)

Permanently redirects the client to a target URI. The client is expected to reuse the same method for the new request.

Overrides:

redirectPermanent in class Response

Parameters:

targetUri - The target URI.

redirectSeeOther

public void redirectSeeOther(Reference targetRef)

Redirects the client to a different URI that SHOULD be retrieved using a GET method on that resource. This method exists primarily to allow the output of a POST-activated script to redirect the user agent to a selected resource. The new URI is not a substitute reference for the originally requested resource.

Overrides:

redirectSeeOther in class Response

Parameters:

targetRef - The target reference.

redirectSeeOther

public void redirectSeeOther(String targetUri)

Redirects the client to a different URI that SHOULD be retrieved using a GET method on that resource. This method exists primarily to allow the output of a POST-activated script to redirect the user agent to a selected resource. The new URI is not a substitute reference for the originally requested resource.

Overrides:

redirectSeeOther in class Response

Parameters:

targetUri - The target URI.

redirectTemporary

public void redirectTemporary(Reference targetRef)

Temporarily redirects the client to a target URI. The client is expected to reuse the same method for the new request.

Overrides:

redirectTemporary in class Response

Parameters:

targetRef - The target reference.

redirectTemporary

public void redirectTemporary(String targetUri)

Temporarily redirects the client to a target URI. The client is expected to reuse the same method for the new request.

Overrides:

redirectTemporary in class Response

Parameters:

targetUri - The target URI.

setAge

public void setAge(int age)

Overrides:

setAge in class Response

setAllowedMethods

public void setAllowedMethods(Set<Method> allowedMethods)

Overrides:

setAllowedMethods in class Response

setAuthenticationInfo

public void setAuthenticationInfo(AuthenticationInfo authenticationInfo)

Overrides:

setAuthenticationInfo in class Response

setAutoCommitting

public void setAutoCommitting(boolean autoCommitting)

Overrides:

setAutoCommitting in class Response

setChallengeRequests

public void setChallengeRequests(List<ChallengeRequest> requests)

Sets the list of authentication requests sent by an origin server to a client.

Overrides:

setChallengeRequests in class Response

Parameters:

requests - The list of authentication requests sent by an origin server to a client.

setCommitted

public void setCommitted(boolean committed)

Overrides:

setCommitted in class Response

setCookieSettings

public void setCookieSettings(Series<CookieSetting> cookieSettings)

Overrides:

setCookieSettings in class Response

setDimensions

public void setDimensions(Set<Dimension> dimensions)

Overrides:

setDimensions in class Response

setEntity

public void setEntity(Representation entity)

Sets the entity representation.

Overrides:

setEntity in class Message

Parameters:

entity - The entity representation.

setEntity

public void setEntity(String value,
                      MediaType mediaType)

Sets a textual entity.

Overrides:

setEntity in class Message

Parameters:

value - The represented string.

mediaType - The representation's media type.

setLocationRef

public void setLocationRef(Reference locationRef)

Sets the reference that the client should follow for redirections or resource creations.

Overrides:

setLocationRef in class Response

Parameters:

locationRef - The reference to set.

setLocationRef

public void setLocationRef(String locationUri)

Sets the reference that the client should follow for redirections or resource creations.

Overrides:

setLocationRef in class Response

Parameters:

locationUri - The URI to set.

setProxyChallengeRequests

public void setProxyChallengeRequests(List<ChallengeRequest> requests)

Sets the list of authentication requests sent by a proxy to a client.

Overrides:

setProxyChallengeRequests in class Response

Parameters:

requests - The list of authentication requests sent by a proxy to a client.

setRequest

public void setRequest(Request request)

Sets the associated request.

Overrides:

setRequest in class Response

Parameters:

request - The associated request

setRequest

public void setRequest(WrapperRequest request)

Sets the associated request.

Parameters:

request - The associated request

setRetryAfter

public void setRetryAfter(Date retryAfter)

Overrides:

setRetryAfter in class Response

setServerInfo

public void setServerInfo(ServerInfo serverInfo)

Overrides:

setServerInfo in class Response

setStatus

public void setStatus(Status status)

Sets the status.

Overrides:

setStatus in class Response

Parameters:

status - The status to set.

setStatus

public void setStatus(Status status,
                      String message)

Sets the status.

Overrides:

setStatus in class Response

Parameters:

status - The status to set.

message - The status message.

setStatus

public void setStatus(Status status,
                      Throwable throwable)

Overrides:

setStatus in class Response

setStatus

public void setStatus(Status status,
                      Throwable throwable,
                      String message)

Overrides:

setStatus in class Response

toString

public String toString()

Overrides:

toString in class Response