Package io.micronaut.web.router.version

Class RouteVersionFilter

java.lang.Object

io.micronaut.web.router.version.RouteVersionFilter

All Implemented Interfaces:

RouteMatchFilter, VersionRouteMatchFilter

@Singleton
@Requires(beans=RoutesVersioningConfiguration.class)
public class RouteVersionFilter
extends java.lang.Object
implements VersionRouteMatchFilter

Implementation of RouteMatchFilter responsible for filtering route matches on Version.

Since:

1.1.0

Constructor Summary

Constructors

Constructor	Description
RouteVersionFilter(java.util.List<RequestVersionResolver> resolvingStrategies, DefaultVersionProvider defaultVersionProvider)	Deprecated. Use RouteVersionFilter(java.util.List<io.micronaut.web.router.version.resolution.RequestVersionResolver>,io.micronaut.web.router.version.DefaultVersionProvider,io.micronaut.web.router.version.RoutesVersioningConfiguration,io.micronaut.web.router.version.resolution.HeaderVersionResolverConfiguration) instead.
RouteVersionFilter(java.util.List<RequestVersionResolver> resolvingStrategies, DefaultVersionProvider defaultVersionProvider, RoutesVersioningConfiguration routesVersioningConfiguration, HeaderVersionResolverConfiguration headerVersionResolverConfiguration)	Creates a RouteVersionFilter with a collection of RequestVersionResolver.

Method Summary

Modifier and Type	Method	Description
<T,R> java.util.function.Predicate<UriRouteMatch<T,R>>	filter(io.micronaut.http.HttpRequest<?> request)	Filters route matches by specified version.
protected <T,R> java.util.Optional<java.lang.String>	getVersion(UriRouteMatch<T,R> routeMatch)
protected boolean	matchIfRouteIsNotVersioned(io.micronaut.http.HttpRequest<?> request, java.lang.String version)
protected boolean	matchIfRouteIsVersioned(io.micronaut.http.HttpRequest<?> request, java.lang.String resolvedVersion, java.lang.String routeVersion)
protected java.util.Optional<java.lang.String>	resolveVersion(io.micronaut.http.HttpRequest<?> request)

Methods inherited from class java.lang.Object

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

Constructor Detail

RouteVersionFilter

@Deprecated
public RouteVersionFilter(java.util.List<RequestVersionResolver> resolvingStrategies,
                          @Nullable
                          DefaultVersionProvider defaultVersionProvider)

Deprecated.

Use RouteVersionFilter(java.util.List<io.micronaut.web.router.version.resolution.RequestVersionResolver>,io.micronaut.web.router.version.DefaultVersionProvider,io.micronaut.web.router.version.RoutesVersioningConfiguration,io.micronaut.web.router.version.resolution.HeaderVersionResolverConfiguration) instead.

Creates a RouteVersionFilter with a collection of RequestVersionResolver.

Parameters:

resolvingStrategies - A list of RequestVersionResolver beans to extract version from HTTP request

defaultVersionProvider - The Default Version Provider

RouteVersionFilter

@Inject
public RouteVersionFilter(java.util.List<RequestVersionResolver> resolvingStrategies,
                          @Nullable
                          DefaultVersionProvider defaultVersionProvider,
                          @Nullable
                          RoutesVersioningConfiguration routesVersioningConfiguration,
                          @Nullable
                          HeaderVersionResolverConfiguration headerVersionResolverConfiguration)

Creates a RouteVersionFilter with a collection of RequestVersionResolver.

Parameters:

resolvingStrategies - A list of RequestVersionResolver beans to extract version from HTTP request

defaultVersionProvider - The Default Version Provider

routesVersioningConfiguration - Configuration for routes versioning

headerVersionResolverConfiguration - Configuration for Header Version resolution

Method Detail

filter

public <T,R> java.util.function.Predicate<UriRouteMatch<T,R>> filter(io.micronaut.http.HttpRequest<?> request)

Filters route matches by specified version.

Specified by:

filter in interface RouteMatchFilter

Type Parameters:

T - The target type

R - The return type

Parameters:

request - The HTTP request

Returns:

A filtered list of route matches

matchIfRouteIsNotVersioned

protected boolean matchIfRouteIsNotVersioned(@NonNull
                                             io.micronaut.http.HttpRequest<?> request,
                                             @Nullable
                                             java.lang.String version)

Parameters:

request - HTTP Request

version - The version resolved evaluating the HTTP Request with beans of type RequestVersionResolver

Returns:

true if no version was resolved from the request

matchIfRouteIsVersioned

protected boolean matchIfRouteIsVersioned(@NonNull
                                          io.micronaut.http.HttpRequest<?> request,
                                          @Nullable
                                          java.lang.String resolvedVersion,
                                          @NonNull
                                          java.lang.String routeVersion)

Parameters:

request - HTTP Request

resolvedVersion - The version resolved evaluating the HTTP Request with beans of type RequestVersionResolver and the RoutesVersioningConfiguration.getDefaultVersion().

routeVersion - The route's version. For example, it could specified by the Version annotation.

Returns:

true if the resolved version matches the route version or if the resolved version is null

resolveVersion

@NonNull
protected java.util.Optional<java.lang.String> resolveVersion(@NonNull
                                                              io.micronaut.http.HttpRequest<?> request)

Parameters:

request - HTTP Request

Returns:

the resolved requested version wrapped in an Optional

getVersion

protected <T,R> java.util.Optional<java.lang.String> getVersion(UriRouteMatch<T,R> routeMatch)

Type Parameters:

T - The target type

R - The return type

Parameters:

routeMatch -

Returns:

Returns the value of the annotation Version in the route method wrapped in an Optional.