io.micronaut.http.server.cors

Class CorsFilter

java.lang.Object

io.micronaut.http.server.cors.CorsFilter

All Implemented Interfaces:

io.micronaut.core.order.Ordered, io.micronaut.http.filter.HttpFilter, io.micronaut.http.filter.HttpServerFilter

@Filter(value="/**")
public class CorsFilter
extends java.lang.Object
implements io.micronaut.http.filter.HttpServerFilter

Responsible for handling CORS requests and responses.

Since:

1.0

Field Summary

Fields

Modifier and Type	Field and Description
protected HttpServerConfiguration.CorsConfiguration	corsConfiguration

Fields inherited from interface io.micronaut.core.order.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
CorsFilter(HttpServerConfiguration.CorsConfiguration corsConfiguration)

Method Summary

Modifier and Type	Method and Description
org.reactivestreams.Publisher<io.micronaut.http.MutableHttpResponse<?>>	doFilter(io.micronaut.http.HttpRequest<?> request, io.micronaut.http.filter.ServerFilterChain chain)
int	getOrder()
protected java.util.Optional<io.micronaut.http.MutableHttpResponse<?>>	handleRequest(io.micronaut.http.HttpRequest request) Handles a CORS HttpRequest.
protected void	handleResponse(io.micronaut.http.HttpRequest<?> request, io.micronaut.http.MutableHttpResponse<?> response) Handles a CORS response.
protected void	setAllowCredentials(CorsOriginConfiguration config, io.micronaut.http.MutableHttpResponse<?> response)
protected void	setAllowHeaders(java.util.List<?> optionalAllowHeaders, io.micronaut.http.MutableHttpResponse response)
protected void	setAllowMethods(io.micronaut.http.HttpMethod method, io.micronaut.http.MutableHttpResponse response)
protected void	setExposeHeaders(java.util.List<java.lang.String> exposedHeaders, io.micronaut.http.MutableHttpResponse<?> response)
protected void	setMaxAge(long maxAge, io.micronaut.http.MutableHttpResponse response)
protected void	setOrigin(java.lang.String origin, io.micronaut.http.MutableHttpResponse response)
protected void	setVary(io.micronaut.http.MutableHttpResponse<?> response)

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.micronaut.http.filter.HttpServerFilter

doFilter

Field Detail

corsConfiguration

protected final HttpServerConfiguration.CorsConfiguration corsConfiguration

Constructor Detail

CorsFilter

public CorsFilter(HttpServerConfiguration.CorsConfiguration corsConfiguration)

Parameters:

corsConfiguration - The CorsOriginConfiguration instance

Method Detail

doFilter

public org.reactivestreams.Publisher<io.micronaut.http.MutableHttpResponse<?>> doFilter(io.micronaut.http.HttpRequest<?> request,
                                                                                        io.micronaut.http.filter.ServerFilterChain chain)

Specified by:

doFilter in interface io.micronaut.http.filter.HttpServerFilter

getOrder

public int getOrder()

Specified by:

getOrder in interface io.micronaut.core.order.Ordered

handleResponse

protected void handleResponse(io.micronaut.http.HttpRequest<?> request,
                              io.micronaut.http.MutableHttpResponse<?> response)

Handles a CORS response.

Parameters:

request - The HttpRequest object

response - The MutableHttpResponse object

handleRequest

protected java.util.Optional<io.micronaut.http.MutableHttpResponse<?>> handleRequest(io.micronaut.http.HttpRequest request)

Handles a CORS HttpRequest.

Parameters:

request - The HttpRequest object

Returns:

An optional MutableHttpResponse. The request should proceed normally if empty

setAllowCredentials

protected void setAllowCredentials(CorsOriginConfiguration config,
                                   io.micronaut.http.MutableHttpResponse<?> response)

Parameters:

config - The CorsOriginConfiguration instance

response - The MutableHttpResponse object

setExposeHeaders

protected void setExposeHeaders(java.util.List<java.lang.String> exposedHeaders,
                                io.micronaut.http.MutableHttpResponse<?> response)

Parameters:

exposedHeaders - A list of the exposed headers

response - The MutableHttpResponse object

setVary

protected void setVary(io.micronaut.http.MutableHttpResponse<?> response)

Parameters:

response - The MutableHttpResponse object

setOrigin

protected void setOrigin(java.lang.String origin,
                         io.micronaut.http.MutableHttpResponse response)

Parameters:

origin - The origin

response - The MutableHttpResponse object

setAllowMethods

protected void setAllowMethods(io.micronaut.http.HttpMethod method,
                               io.micronaut.http.MutableHttpResponse response)

Parameters:

method - The HttpMethod object

response - The MutableHttpResponse object

setAllowHeaders

protected void setAllowHeaders(java.util.List<?> optionalAllowHeaders,
                               io.micronaut.http.MutableHttpResponse response)

Parameters:

optionalAllowHeaders - A list with optional allow headers

response - The MutableHttpResponse object

setMaxAge

protected void setMaxAge(long maxAge,
                         io.micronaut.http.MutableHttpResponse response)

Parameters:

maxAge - The max age

response - The MutableHttpResponse object