org.restlet.engine.cors

Class CorsResponseHelper

java.lang.Object

org.restlet.engine.cors.CorsResponseHelper

public class CorsResponseHelper
extends Object

Helps to generate response CORS headers.
The CORS specification defines a subset of methods qualified as simple HEAD, GET and POST. Any other methods should send a preflight request with the method OPTIONS.

Author:

Manuel Boillod

See Also:

W3C CORS Specification, Simple methods

Field Summary

Fields

Modifier and Type	Field and Description
boolean	allowAllRequestedHeaders If true, copies the value of 'Access-Control-Request-Headers' request header into the 'Access-Control-Allow-Headers' response header.
boolean	allowedCredentials If true, add 'Access-Control-Allow-Credentials' header.
Set<String>	allowedHeaders The value of 'Access-Control-Allow-Headers' response header.
Set<String>	allowedOrigins The value of 'Access-Control-Allow-Origin' header.
Set<String>	exposedHeaders The value of 'Access-Control-Expose-Headers' response header.

Constructor Summary

Constructors

Constructor and Description
CorsResponseHelper()

Method Summary

Methods

Modifier and Type	Method and Description
void	addCorsResponseHeaders(Request request, Response response) Adds CORS headers to the given response.
Set<String>	getAllowedHeaders() Returns the modifiable set of headers allowed by the actual request on the current resource. Note that when used with HTTP connectors, this property maps to the "Access-Control-Allow-Headers" header.
Set<String>	getAllowedOrigins() Returns the URI an origin server allows for the requested resource.
Set<String>	getExposedHeaders() Returns a modifiable whitelist of headers an origin server allows for the requested resource. Note that when used with HTTP connectors, this property maps to the "Access-Control-Expose-Headers" header.
boolean	isAllowAllRequestedHeaders() If true, indicates that the value of 'Access-Control-Request-Headers' request header will be copied into the 'Access-Control-Allow-Headers' response header.
boolean	isAllowedCredentials() If true, adds 'Access-Control-Allow-Credentials' header.
CorsResponseHelper	setAllowAllRequestedHeaders(boolean allowAllRequestedHeaders) If true, copies the value of 'Access-Control-Request-Headers' request header into the 'Access-Control-Allow-Headers' response header.
CorsResponseHelper	setAllowedCredentials(boolean allowedCredentials) If true, adds 'Access-Control-Allow-Credentials' header.
CorsResponseHelper	setAllowedHeaders(Set<String> allowedHeaders) Sets the value of the 'Access-Control-Allow-Headers' response header.
CorsResponseHelper	setAllowedOrigins(Set<String> allowedOrigins) Sets the value of 'Access-Control-Allow-Origin' header.
CorsResponseHelper	setExposedHeaders(Set<String> exposedHeaders) Sets the value of 'Access-Control-Expose-Headers' response header.

Methods inherited from class java.lang.Object

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

Field Detail

allowAllRequestedHeaders

public boolean allowAllRequestedHeaders

If true, copies the value of 'Access-Control-Request-Headers' request header into the 'Access-Control-Allow-Headers' response header. If false, use allowedHeaders. Default is true.

allowedCredentials

public boolean allowedCredentials

If true, add 'Access-Control-Allow-Credentials' header. Default is false.

allowedHeaders

public Set<String> allowedHeaders

The value of 'Access-Control-Allow-Headers' response header. Used only if allowAllRequestedHeaders is false.

allowedOrigins

public Set<String> allowedOrigins

The value of 'Access-Control-Allow-Origin' header. Default is '*'.

exposedHeaders

public Set<String> exposedHeaders

The value of 'Access-Control-Expose-Headers' response header.

Constructor Detail

CorsResponseHelper

public CorsResponseHelper()

Method Detail

addCorsResponseHeaders

public void addCorsResponseHeaders(Request request,
                          Response response)

Adds CORS headers to the given response.

Parameters:

request - The current request.

response - The response.

getAllowedHeaders

public Set<String> getAllowedHeaders()

Returns the modifiable set of headers allowed by the actual request on the current resource.
Note that when used with HTTP connectors, this property maps to the "Access-Control-Allow-Headers" header.

Returns:

The set of headers allowed by the actual request on the current resource.

getAllowedOrigins

public Set<String> getAllowedOrigins()

Returns the URI an origin server allows for the requested resource. Use "*" as a wildcard character.
Note that when used with HTTP connectors, this property maps to the "Access-Control-Allow-Origin" header.

Returns:

The origin allowed by the requested resource.

getExposedHeaders

public Set<String> getExposedHeaders()

Returns a modifiable whitelist of headers an origin server allows for the requested resource.
Note that when used with HTTP connectors, this property maps to the "Access-Control-Expose-Headers" header.

Returns:

The set of headers an origin server allows for the requested resource.

isAllowAllRequestedHeaders

public boolean isAllowAllRequestedHeaders()

If true, indicates that the value of 'Access-Control-Request-Headers' request header will be copied into the 'Access-Control-Allow-Headers' response header. If false, use allowedHeaders.

isAllowedCredentials

public boolean isAllowedCredentials()

If true, adds 'Access-Control-Allow-Credentials' header.

Returns:

True, if the 'Access-Control-Allow-Credentials' header will be added.

setAllowAllRequestedHeaders

public CorsResponseHelper setAllowAllRequestedHeaders(boolean allowAllRequestedHeaders)

If true, copies the value of 'Access-Control-Request-Headers' request header into the 'Access-Control-Allow-Headers' response header. If false, use allowedHeaders.

Parameters:

allowAllRequestedHeaders - True to copy the value of 'Access-Control-Request-Headers' request header into the 'Access-Control-Allow-Headers' response header. If false, use allowedHeaders.

Returns:

Itself for chaining methods calls.

setAllowedCredentials

public CorsResponseHelper setAllowedCredentials(boolean allowedCredentials)

If true, adds 'Access-Control-Allow-Credentials' header.

Parameters:

allowedCredentials - True to add the 'Access-Control-Allow-Credentials' header.

Returns:

Itself for chaining methods calls.

setAllowedHeaders

public CorsResponseHelper setAllowedHeaders(Set<String> allowedHeaders)

Sets the value of the 'Access-Control-Allow-Headers' response header. Used only if allowAllRequestedHeaders is false.

Parameters:

allowedHeaders - The value of 'Access-Control-Allow-Headers' response header.

Returns:

Itself for chaining methods calls.

setAllowedOrigins

public CorsResponseHelper setAllowedOrigins(Set<String> allowedOrigins)

Sets the value of 'Access-Control-Allow-Origin' header.

Parameters:

allowedOrigins - The value of 'Access-Control-Allow-Origin' header.

Returns:

Itself for chaining methods calls.

setExposedHeaders

public CorsResponseHelper setExposedHeaders(Set<String> exposedHeaders)

Sets the value of 'Access-Control-Expose-Headers' response header.

Parameters:

exposedHeaders - The value of 'Access-Control-Expose-Headers' response header.

Returns:

Itself for chaining methods calls.