Class EndpointRequest

java.lang.Object

org.springframework.boot.security.autoconfigure.actuate.web.reactive.EndpointRequest

public final class EndpointRequest
extends Object

Factory that can be used to create a ServerWebExchangeMatcher for actuator endpoint locations.

Since:

4.0.0

Author:

Madhura Bhave, Phillip Webb, Chris Bono

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	EndpointRequest.AdditionalPathsEndpointServerWebExchangeMatcher	The ServerWebExchangeMatcher used to match against additional paths for actuator endpoints.
static final class	EndpointRequest.EndpointServerWebExchangeMatcher	The ServerWebExchangeMatcher used to match against actuator endpoints.
static final class	EndpointRequest.LinksServerWebExchangeMatcher	The ServerWebExchangeMatcher used to match against the links endpoint.

Method Summary

Modifier and Type	Method	Description
static EndpointRequest.EndpointServerWebExchangeMatcher	to(Class<?>... endpoints)	Returns a matcher that includes the specified actuator endpoints.
static EndpointRequest.EndpointServerWebExchangeMatcher	to(String... endpoints)	Returns a matcher that includes the specified actuator endpoints.
static EndpointRequest.AdditionalPathsEndpointServerWebExchangeMatcher	toAdditionalPaths(WebServerNamespace webServerNamespace, Class<?>... endpoints)	Returns a matcher that includes additional paths under a WebServerNamespace for the specified actuator endpoints.
static EndpointRequest.AdditionalPathsEndpointServerWebExchangeMatcher	toAdditionalPaths(WebServerNamespace webServerNamespace, String... endpoints)	Returns a matcher that includes additional paths under a WebServerNamespace for the specified actuator endpoints.
static EndpointRequest.EndpointServerWebExchangeMatcher	toAnyEndpoint()	Returns a matcher that includes all actuator endpoints.
static EndpointRequest.LinksServerWebExchangeMatcher	toLinks()	Returns a matcher that matches only on the links endpoint.

Methods inherited from class Object

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

Method Details

toAnyEndpoint

public static EndpointRequest.EndpointServerWebExchangeMatcher toAnyEndpoint()

Returns a matcher that includes all actuator endpoints. It also includes the links endpoint which is present at the base path of the actuator endpoints. The excluding method can be used to further remove specific endpoints if required. For example:

EndpointRequest.toAnyEndpoint().excluding(ShutdownEndpoint.class)

Returns:

the configured ServerWebExchangeMatcher

to

public static EndpointRequest.EndpointServerWebExchangeMatcher to(Class<?>... endpoints)

Returns a matcher that includes the specified actuator endpoints. For example:

EndpointRequest.to(ShutdownEndpoint.class, HealthEndpoint.class)

Parameters:

endpoints - the endpoints to include

Returns:

the configured ServerWebExchangeMatcher

to

public static EndpointRequest.EndpointServerWebExchangeMatcher to(String... endpoints)

Returns a matcher that includes the specified actuator endpoints. For example:

EndpointRequest.to("shutdown", "health")

Parameters:

endpoints - the endpoints to include

Returns:

the configured ServerWebExchangeMatcher

toLinks

public static EndpointRequest.LinksServerWebExchangeMatcher toLinks()

Returns a matcher that matches only on the links endpoint. It can be used when security configuration for the links endpoint is different from the other actuator endpoints. The excludingLinks method can be used in combination with this to remove the links endpoint from toAnyEndpoint. For example:

EndpointRequest.toLinks()

Returns:

the configured ServerWebExchangeMatcher

toAdditionalPaths

public static EndpointRequest.AdditionalPathsEndpointServerWebExchangeMatcher toAdditionalPaths(WebServerNamespace webServerNamespace,
 Class<?>... endpoints)

Returns a matcher that includes additional paths under a WebServerNamespace for the specified actuator endpoints. For example:

EndpointRequest.toAdditionalPaths(WebServerNamespace.SERVER, "health")

Parameters:

webServerNamespace - the web server namespace

endpoints - the endpoints to include

Returns:

the configured RequestMatcher

toAdditionalPaths

public static EndpointRequest.AdditionalPathsEndpointServerWebExchangeMatcher toAdditionalPaths(WebServerNamespace webServerNamespace,
 String... endpoints)

Returns a matcher that includes additional paths under a WebServerNamespace for the specified actuator endpoints. For example:

EndpointRequest.toAdditionalPaths(WebServerNamespace.SERVER, HealthEndpoint.class)

Parameters:

webServerNamespace - the web server namespace

endpoints - the endpoints to include

Returns:

the configured RequestMatcher