io.micronaut.web.router.filter

Class FilteredRouter

java.lang.Object

io.micronaut.web.router.filter.FilteredRouter

All Implemented Interfaces:

Router

public class FilteredRouter
extends Object
implements Router

Allows decorating an existing Router with filtering capabilities.

Filters themselves should be supplied via the RouteMatchFilter interface.

A filtered router can be enabled by implementing a BeanCreatedEventListener for the existing Router and decorating appropriately. See for example VersionAwareRouterListener

Since:

1.1.0

Author:

Bogdan Oros, graemerocher

See Also:

RouteMatchFilter

Constructor Summary

Constructors

Constructor and Description
FilteredRouter(Router router, RouteMatchFilter routeFilter) Creates a decorated router for an existing router and RouteMatchFilter.

Method Summary

Modifier and Type	Method and Description
void	applyDefaultPorts(List<Integer> ports) Sets the ports the application will listen to by default.
<T,R> Optional<UriRouteMatch<T,R>>	DELETE(CharSequence uri) Find the first RouteMatch route for an HttpMethod.DELETE method and the given URI.
<T,R> Stream<UriRouteMatch<T,R>>	find(HttpMethod httpMethod, CharSequence uri) Finds all of the possible routes for the given HTTP method and URI.
<T,R> Stream<UriRouteMatch<T,R>>	find(HttpMethod httpMethod, CharSequence uri, HttpRequest<?> context) Finds all of the possible routes for the given HTTP method and URI.
<T,R> Stream<UriRouteMatch<T,R>>	find(HttpMethod httpMethod, URI uri) Deprecated.
<T,R> Stream<UriRouteMatch<T,R>>	find(HttpRequest<?> request) Finds all of the possible routes for the given HTTP request.
<T,R> Stream<UriRouteMatch<T,R>>	find(HttpRequest request, CharSequence uri) Find method, that should be used for non-standard http methods.
<T,R> List<UriRouteMatch<T,R>>	findAllClosest(HttpRequest<?> request) Finds the closest match for the given request.
<T,R> Stream<UriRouteMatch<T,R>>	findAny(CharSequence uri) Deprecated.
<T,R> Stream<UriRouteMatch<T,R>>	findAny(CharSequence uri, HttpRequest<?> context) Find any RouteMatch regardless of HTTP method.
List<HttpFilter>	findFilters(HttpRequest<?> request) Build a filtered Publisher for an action.
<T,R> Optional<UriRouteMatch<T,R>>	GET(CharSequence uri) Find the first RouteMatch route for an HttpMethod.GET method and the given URI.
Set<Integer>	getExposedPorts()
<T,R> Optional<UriRouteMatch<T,R>>	HEAD(CharSequence uri) Find the first RouteMatch route for an HttpMethod.HEAD method and the given URI.
<T,R> Optional<UriRouteMatch<T,R>>	OPTIONS(CharSequence uri) Find the first RouteMatch route for an HttpMethod.OPTIONS method and the given URI.
<T,R> Optional<UriRouteMatch<T,R>>	PATCH(CharSequence uri) Find the first RouteMatch route for an HttpMethod.PATCH method and the given URI.
<T,R> Optional<UriRouteMatch<T,R>>	POST(CharSequence uri) Find the first RouteMatch route for an HttpMethod.POST method and the given URI.
<T,R> Optional<UriRouteMatch<T,R>>	PUT(CharSequence uri) Find the first RouteMatch route for an HttpMethod.PUT method and the given URI.
<R> Optional<RouteMatch<R>>	route(Class originatingClass, HttpStatus status) Found a RouteMatch for the given HttpStatus code.
<R> Optional<RouteMatch<R>>	route(Class originatingClass, Throwable error) Match a route to an error.
<T,R> Optional<UriRouteMatch<T,R>>	route(HttpMethod httpMethod, CharSequence uri) Finds the first possible route for the given HTTP method and URI.
<R> Optional<RouteMatch<R>>	route(HttpStatus status) Found a RouteMatch for the given HttpStatus code.
<R> Optional<RouteMatch<R>>	route(Throwable error) Match a route to an error.
Stream<UriRoute>	uriRoutes() Returns all UriRoutes.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.micronaut.web.router.Router

find

Constructor Detail

FilteredRouter

public FilteredRouter(Router router,
                      RouteMatchFilter routeFilter)

Creates a decorated router for an existing router and RouteMatchFilter.

Parameters:

router - A Router to delegate to

routeFilter - A RouteMatchFilter to filter non matching routes

Method Detail

findAny

@Nonnull
 @Deprecated
public <T,R> Stream<UriRouteMatch<T,R>> findAny(@Nonnull
                                                                      CharSequence uri)

Deprecated.

Description copied from interface: Router

Find any RouteMatch regardless of HTTP method.

Specified by:

findAny in interface Router

Type Parameters:

T - The target type

R - The return type

Parameters:

uri - The URI

Returns:

A stream of route matches

findAny

@Nonnull
public <T,R> Stream<UriRouteMatch<T,R>> findAny(@Nonnull
                                                         CharSequence uri,
                                                         @Nullable
                                                         HttpRequest<?> context)

Description copied from interface: Router

Find any RouteMatch regardless of HTTP method.

Specified by:

findAny in interface Router

Type Parameters:

T - The target type

R - The return type

Parameters:

uri - The URI

context - The optional HttpRequest context information to apply RouteMatchFilter.

Returns:

A stream of route matches

getExposedPorts

public Set<Integer> getExposedPorts()

Specified by:

getExposedPorts in interface Router

Returns:

The exposed ports.

applyDefaultPorts

public void applyDefaultPorts(List<Integer> ports)

Description copied from interface: Router

Sets the ports the application will listen to by default.

Specified by:

applyDefaultPorts in interface Router

Parameters:

ports - The default ports

find

@Nonnull
public <T,R> Stream<UriRouteMatch<T,R>> find(@Nonnull
                                                      HttpMethod httpMethod,
                                                      @Nonnull
                                                      CharSequence uri)

Description copied from interface: Router

Finds all of the possible routes for the given HTTP method and URI.

Specified by:

find in interface Router

Type Parameters:

T - The target type

R - The type

Parameters:

httpMethod - The HTTP method

uri - The URI route match

Returns:

A Stream of possible Route instances.

find

@Nonnull
public <T,R> Stream<UriRouteMatch<T,R>> find(@Nonnull
                                                      HttpMethod httpMethod,
                                                      @Nonnull
                                                      CharSequence uri,
                                                      @Nullable
                                                      HttpRequest<?> context)

Description copied from interface: Router

Finds all of the possible routes for the given HTTP method and URI.

Specified by:

find in interface Router

Type Parameters:

T - The target type

R - The type

Parameters:

httpMethod - The HTTP method

uri - The URI route match

context - The optional HttpRequest context information to apply RouteMatchFilter.

Returns:

A Stream of possible Route instances.

findAllClosest

@Nonnull
public <T,R> List<UriRouteMatch<T,R>> findAllClosest(@Nonnull
                                                              HttpRequest<?> request)

Description copied from interface: Router

Finds the closest match for the given request.

Specified by:

findAllClosest in interface Router

Type Parameters:

T - The target type

R - The type

Parameters:

request - The request

Returns:

A List of possible Route instances.

find

@Nonnull
public <T,R> Stream<UriRouteMatch<T,R>> find(@Nonnull
                                                      HttpRequest request,
                                                      @Nonnull
                                                      CharSequence uri)

Description copied from interface: Router

Find method, that should be used for non-standard http methods. For standards it should act the same as Router.find(HttpMethod, URI)

Specified by:

find in interface Router

Type Parameters:

T - The target type.

R - The type of what

Parameters:

request - The request, that can have overridden HttpRequest.getMethodName()

uri - The URI route match.

Returns:

A Stream of possible Route instances.

uriRoutes

@Nonnull
public Stream<UriRoute> uriRoutes()

Description copied from interface: Router

Returns all UriRoutes.

Specified by:

uriRoutes in interface Router

Returns:

A Stream of all registered UriRoute instances.

route

public <T,R> Optional<UriRouteMatch<T,R>> route(@Nonnull
                                                HttpMethod httpMethod,
                                                @Nonnull
                                                CharSequence uri)

Description copied from interface: Router

Finds the first possible route for the given HTTP method and URI.

Specified by:

route in interface Router

Type Parameters:

T - The target type

R - The URI route match

Parameters:

httpMethod - The HTTP method

uri - The URI

Returns:

The route match

route

public <R> Optional<RouteMatch<R>> route(@Nonnull
                                         HttpStatus status)

Description copied from interface: Router

Found a RouteMatch for the given HttpStatus code.

Specified by:

route in interface Router

Type Parameters:

R - The matched route

Parameters:

status - The HTTP status

Returns:

The RouteMatch

route

public <R> Optional<RouteMatch<R>> route(@Nonnull
                                         Class originatingClass,
                                         @Nonnull
                                         HttpStatus status)

Description copied from interface: Router

Found a RouteMatch for the given HttpStatus code.

Specified by:

route in interface Router

Type Parameters:

R - The matched route

Parameters:

originatingClass - The class the error originates from

status - The HTTP status

Returns:

The RouteMatch

route

public <R> Optional<RouteMatch<R>> route(@Nonnull
                                         Throwable error)

Description copied from interface: Router

Match a route to an error.

Specified by:

route in interface Router

Type Parameters:

R - The matched route

Parameters:

error - The error

Returns:

The RouteMatch

route

public <R> Optional<RouteMatch<R>> route(@Nonnull
                                         Class originatingClass,
                                         @Nonnull
                                         Throwable error)

Description copied from interface: Router

Match a route to an error.

Specified by:

route in interface Router

Type Parameters:

R - The matched route

Parameters:

originatingClass - The class the error originates from

error - The error

Returns:

The RouteMatch

findFilters

@Nonnull
public List<HttpFilter> findFilters(@Nonnull
                                             HttpRequest<?> request)

Description copied from interface: Router

Build a filtered Publisher for an action.

Specified by:

findFilters in interface Router

Parameters:

request - The request

Returns:

A new filtered publisher

GET

public <T,R> Optional<UriRouteMatch<T,R>> GET(@Nonnull
                                              CharSequence uri)

Description copied from interface: Router

Find the first RouteMatch route for an HttpMethod.GET method and the given URI.

Specified by:

GET in interface Router

Type Parameters:

T - The target type

R - The return type

Parameters:

uri - The URI

Returns:

An Optional of RouteMatch

POST

public <T,R> Optional<UriRouteMatch<T,R>> POST(@Nonnull
                                               CharSequence uri)

Description copied from interface: Router

Find the first RouteMatch route for an HttpMethod.POST method and the given URI.

Specified by:

POST in interface Router

Type Parameters:

T - The target type

R - The return type

Parameters:

uri - The URI

Returns:

An Optional of RouteMatch

PUT

public <T,R> Optional<UriRouteMatch<T,R>> PUT(@Nonnull
                                              CharSequence uri)

Description copied from interface: Router

Find the first RouteMatch route for an HttpMethod.PUT method and the given URI.

Specified by:

PUT in interface Router

Type Parameters:

T - The target type

R - The URI route match

Parameters:

uri - The URI

Returns:

An Optional of RouteMatch

PATCH

public <T,R> Optional<UriRouteMatch<T,R>> PATCH(@Nonnull
                                                CharSequence uri)

Description copied from interface: Router

Find the first RouteMatch route for an HttpMethod.PATCH method and the given URI.

Specified by:

PATCH in interface Router

Type Parameters:

T - The target type

R - The return type

Parameters:

uri - The URI

Returns:

An Optional of RouteMatch

DELETE

public <T,R> Optional<UriRouteMatch<T,R>> DELETE(@Nonnull
                                                 CharSequence uri)

Description copied from interface: Router

Find the first RouteMatch route for an HttpMethod.DELETE method and the given URI.

Specified by:

DELETE in interface Router

Type Parameters:

T - The target type

R - The return type

Parameters:

uri - The URI

Returns:

An Optional of RouteMatch

OPTIONS

public <T,R> Optional<UriRouteMatch<T,R>> OPTIONS(@Nonnull
                                                  CharSequence uri)

Description copied from interface: Router

Find the first RouteMatch route for an HttpMethod.OPTIONS method and the given URI.

Specified by:

OPTIONS in interface Router

Type Parameters:

T - The target type

R - The return type

Parameters:

uri - The URI

Returns:

An Optional of RouteMatch

HEAD

public <T,R> Optional<UriRouteMatch<T,R>> HEAD(@Nonnull
                                               CharSequence uri)

Description copied from interface: Router

Find the first RouteMatch route for an HttpMethod.HEAD method and the given URI.

Specified by:

HEAD in interface Router

Type Parameters:

T - The target type

R - The return type

Parameters:

uri - The URI

Returns:

An Optional of RouteMatch

find

@Nonnull
 @Deprecated
public <T,R> Stream<UriRouteMatch<T,R>> find(@Nonnull
                                                                   HttpMethod httpMethod,
                                                                   @Nonnull
                                                                   URI uri)

Deprecated.

Description copied from interface: Router

Finds all of the possible routes for the given HTTP method and URI.

Specified by:

find in interface Router

Type Parameters:

T - The target type

R - The URI route match

Parameters:

httpMethod - The HTTP method

uri - The URI

Returns:

A Stream of possible Route instances.

find

@Nonnull
public <T,R> Stream<UriRouteMatch<T,R>> find(@Nonnull
                                                      HttpRequest<?> request)

Description copied from interface: Router

Finds all of the possible routes for the given HTTP request.

Specified by:

find in interface Router

Type Parameters:

T - The target type

R - The URI route match

Parameters:

request - The HTTP request

Returns:

A Stream of possible Route instances.