org.restlet.util
Class WrapperRequest

java.lang.Object
  org.restlet.Message
      org.restlet.Request
          org.restlet.util.WrapperRequest

public class WrapperRequest
extends Request

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

WrapperRequest(Request wrappedRequest)
Constructor.

Method Summary

boolean	abort()
void	commit(Response response)
ConcurrentMap<String,Object>	getAttributes() Returns a modifiable attributes map that can be used by developers to save information relative to the message.
ChallengeResponse	getChallengeResponse() Returns the authentication response sent by a client to an origin server.
ClientInfo	getClientInfo() Returns the client-specific information.
Conditions	getConditions() Returns the conditions applying to this call.
Series<Cookie>	getCookies() Returns the cookies provided by the client.
Representation	getEntity() Returns the entity representation.
Reference	getHostRef() Returns the host reference.
int	getMaxForwards()
Method	getMethod() Returns the method.
Uniform	getOnResponse()
Reference	getOriginalRef()
Protocol	getProtocol() Returns the protocol by first returning the baseRef.schemeProtocol property if it is set, or the resourceRef.schemeProtocol property otherwise.
ChallengeResponse	getProxyChallengeResponse() Returns the authentication response sent by a client to a proxy.
List<Range>	getRanges()
Reference	getReferrerRef() Returns the referrer reference if available.
Reference	getResourceRef() Returns the reference of the target resource.
Reference	getRootRef() Returns the application root reference.
protected Request	getWrappedRequest() Returns the wrapped request.
boolean	isAsynchronous()
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.
boolean	isExpectingResponse()
boolean	isSynchronous()
void	setChallengeResponse(ChallengeResponse response) Sets the authentication response sent by a client to an origin server.
void	setClientInfo(ClientInfo clientInfo)
void	setConditions(Conditions conditions)
void	setCookies(Series<Cookie> cookies)
void	setEntity(Representation entity) Sets the entity representation.
void	setEntity(String value, MediaType mediaType) Sets a textual entity.
void	setHostRef(Reference hostRef) Sets the host reference.
void	setHostRef(String hostUri) Sets the host reference using an URI string.
void	setMaxForwards(int maxForwards)
void	setMethod(Method method) Sets the method called.
void	setOnResponse(Uniform onResponseCallback)
void	setOriginalRef(Reference originalRef)
void	setProtocol(Protocol protocol)
void	setProxyChallengeResponse(ChallengeResponse response) Sets the authentication response sent by a client to a proxy.
void	setRanges(List<Range> ranges)
void	setReferrerRef(Reference referrerRef) Sets the referrer reference if available.
void	setReferrerRef(String referrerUri) Sets the referrer reference if available using an URI string.
void	setResourceRef(Reference resourceRef) Sets the target resource reference.
void	setResourceRef(String resourceUri) Sets the target resource reference using an URI string.
void	setRootRef(Reference rootRef) Sets the application root reference.
String	toString()

Methods inherited from class org.restlet.Request

getCurrent, isLoggable, setLoggable

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

WrapperRequest

public WrapperRequest(Request wrappedRequest)

Constructor.

Parameters:

wrappedRequest - The wrapped request.

Method Detail

abort

public boolean abort()

Overrides:

abort in class Request

commit

public void commit(Response response)

Overrides:

commit in class Request

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.

getChallengeResponse

public ChallengeResponse getChallengeResponse()

Returns the authentication response sent by a client to an origin server.

Overrides:

getChallengeResponse in class Request

Returns:

The authentication response sent by a client to an origin server.

getClientInfo

public ClientInfo getClientInfo()

Returns the client-specific information.

Overrides:

getClientInfo in class Request

Returns:

The client-specific information.

getConditions

public Conditions getConditions()

Returns the conditions applying to this call.

Overrides:

getConditions in class Request

Returns:

The conditions applying to this call.

getCookies

public Series<Cookie> getCookies()

Returns the cookies provided by the client.

Overrides:

getCookies in class Request

Returns:

The cookies provided by the client.

getEntity

public Representation getEntity()

Returns the entity representation.

Overrides:

getEntity in class Message

Returns:

The entity representation.

getHostRef

public Reference getHostRef()

Returns the host reference. This may be different from the resourceRef's host, for example for URNs and other URIs that don't contain host information.

Overrides:

getHostRef in class Request

Returns:

The host reference.

getMaxForwards

public int getMaxForwards()

Overrides:

getMaxForwards in class Request

getMethod

public Method getMethod()

Returns the method.

Overrides:

getMethod in class Request

Returns:

The method.

getOnResponse

public Uniform getOnResponse()

Overrides:

getOnResponse in class Request

getOriginalRef

public Reference getOriginalRef()

Overrides:

getOriginalRef in class Request

getProtocol

public Protocol getProtocol()

Returns the protocol by first returning the baseRef.schemeProtocol property if it is set, or the resourceRef.schemeProtocol property otherwise.

Overrides:

getProtocol in class Request

Returns:

The protocol or null if not available.

getProxyChallengeResponse

public ChallengeResponse getProxyChallengeResponse()

Returns the authentication response sent by a client to a proxy.

Overrides:

getProxyChallengeResponse in class Request

Returns:

The authentication response sent by a client to a proxy.

getRanges

public List<Range> getRanges()

Overrides:

getRanges in class Request

getReferrerRef

public Reference getReferrerRef()

Returns the referrer reference if available.

Overrides:

getReferrerRef in class Request

Returns:

The referrer reference.

getResourceRef

public Reference getResourceRef()

Returns the reference of the target resource.

Overrides:

getResourceRef in class Request

Returns:

The reference of the target resource.

getRootRef

public Reference getRootRef()

Returns the application root reference.

Overrides:

getRootRef in class Request

Returns:

The application root reference.

getWrappedRequest

protected Request getWrappedRequest()

Returns the wrapped request.

Returns:

The wrapped request.

isAsynchronous

public boolean isAsynchronous()

Overrides:

isAsynchronous in class Request

isConfidential

public boolean isConfidential()

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

Overrides:

isConfidential in class Request

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 method must allow the sending of content, the content must exists and have some available data.

Overrides:

isEntityAvailable in class Request

Returns:

True if a content is available and can be sent.

isExpectingResponse

public boolean isExpectingResponse()

Overrides:

isExpectingResponse in class Request

isSynchronous

public boolean isSynchronous()

Overrides:

isSynchronous in class Request

setChallengeResponse

public void setChallengeResponse(ChallengeResponse response)

Sets the authentication response sent by a client to an origin server.

Overrides:

setChallengeResponse in class Request

Parameters:

response - The authentication response sent by a client to an origin server.

setClientInfo

public void setClientInfo(ClientInfo clientInfo)

Overrides:

setClientInfo in class Request

setConditions

public void setConditions(Conditions conditions)

Overrides:

setConditions in class Request

setCookies

public void setCookies(Series<Cookie> cookies)

Overrides:

setCookies in class Request

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.

setHostRef

public void setHostRef(Reference hostRef)

Sets the host reference.

Overrides:

setHostRef in class Request

Parameters:

hostRef - The host reference.

setHostRef

public void setHostRef(String hostUri)

Sets the host reference using an URI string.

Overrides:

setHostRef in class Request

Parameters:

hostUri - The host URI.

setMaxForwards

public void setMaxForwards(int maxForwards)

Overrides:

setMaxForwards in class Request

setMethod

public void setMethod(Method method)

Sets the method called.

Overrides:

setMethod in class Request

Parameters:

method - The method called.

setOnResponse

public void setOnResponse(Uniform onResponseCallback)

Overrides:

setOnResponse in class Request

setOriginalRef

public void setOriginalRef(Reference originalRef)

Overrides:

setOriginalRef in class Request

setProtocol

public void setProtocol(Protocol protocol)

Overrides:

setProtocol in class Request

setProxyChallengeResponse

public void setProxyChallengeResponse(ChallengeResponse response)

Sets the authentication response sent by a client to a proxy.

Overrides:

setProxyChallengeResponse in class Request

Parameters:

response - The authentication response sent by a client to a proxy.

setRanges

public void setRanges(List<Range> ranges)

Overrides:

setRanges in class Request

setReferrerRef

public void setReferrerRef(Reference referrerRef)

Sets the referrer reference if available.

Overrides:

setReferrerRef in class Request

Parameters:

referrerRef - The referrer reference.

setReferrerRef

public void setReferrerRef(String referrerUri)

Sets the referrer reference if available using an URI string.

Overrides:

setReferrerRef in class Request

Parameters:

referrerUri - The referrer URI.

setResourceRef

public void setResourceRef(Reference resourceRef)

Sets the target resource reference. If the reference is relative, it will be resolved as an absolute reference. Also, the context's base reference will be reset. Finally, the reference will be normalized to ensure a consistent handling of the call.

Overrides:

setResourceRef in class Request

Parameters:

resourceRef - The resource reference.

setResourceRef

public void setResourceRef(String resourceUri)

Sets the target resource reference using an URI string. Note that the URI can be either absolute or relative to the context's base reference.

Overrides:

setResourceRef in class Request

Parameters:

resourceUri - The resource URI.

setRootRef

public void setRootRef(Reference rootRef)

Sets the application root reference.

Overrides:

setRootRef in class Request

Parameters:

rootRef - The application root reference.

toString

public String toString()

Overrides:

toString in class Request