Package io.micronaut.web.router
Class DefaultRouter
java.lang.Object
io.micronaut.web.router.DefaultRouter
- All Implemented Interfaces:
HttpFilterResolver<RouteMatch<?>>
,HttpServerFilterResolver<RouteMatch<?>>
,Router
@Singleton
public class DefaultRouter
extends Object
implements Router, HttpServerFilterResolver<RouteMatch<?>>
The default Router
implementation. This implementation does not perform any additional caching of
route discovery.
- Since:
- 1.0
- Author:
- Graeme Rocher
-
Nested Class Summary
Nested classes/interfaces inherited from interface io.micronaut.http.filter.HttpFilterResolver
HttpFilterResolver.FilterEntry
-
Constructor Summary
ConstructorDescriptionDefaultRouter
(RouteBuilder... builders) Construct a new router for the given route builders.DefaultRouter
(Collection<RouteBuilder> builders) Construct a new router for the given route builders. -
Method Summary
Modifier and TypeMethodDescriptionvoid
applyDefaultPorts
(List<Integer> ports) Sets the ports the application will listen to by default.<T,
R> @NonNull Stream<UriRouteMatch<T, R>> find
(@NonNull HttpMethod httpMethod, @NonNull CharSequence uri, @Nullable HttpRequest<?> context) Finds all possible routes for the given HTTP method and URI.<T,
R> @NonNull Stream<UriRouteMatch<T, R>> find
(@NonNull HttpRequest<?> request) Finds all possible routes for the given HTTP request.<T,
R> @NonNull Stream<UriRouteMatch<T, R>> find
(@NonNull HttpRequest<?> request, @NonNull CharSequence uri) Find method, that should be used for non-standard http methods.<T,
R> @NonNull List<UriRouteMatch<T, R>> findAllClosest
(@NonNull HttpRequest<?> request) Finds the closest match for the given request.<T,
R> @NonNull Stream<UriRouteMatch<T, R>> findAny
(@NonNull CharSequence uri, @Nullable HttpRequest<?> request) Find anyRouteMatch
regardless of HTTP method.<T,
R> List<UriRouteMatch<T, R>> findAny
(HttpRequest<?> request) Find anyRouteMatch
regardless of HTTP method.<T,
R> UriRouteMatch<T, R> findClosest
(HttpRequest<?> request) Finds the closest match for the given request or null if none is found.<R> Optional<RouteMatch<R>>
findErrorRoute
(@NonNull Class<?> originatingClass, @NonNull Throwable error, HttpRequest<?> request) Match a route to an error.<R> Optional<RouteMatch<R>>
findErrorRoute
(@NonNull Throwable error, HttpRequest<?> request) Match a route to an error.findFilters
(@NonNull HttpRequest<?> request) Build a filteredPublisher
for an action.<R> Optional<RouteMatch<R>>
findStatusRoute
(int statusCode, HttpRequest<?> request) Found aRouteMatch
for the given status code.<R> Optional<RouteMatch<R>>
findStatusRoute
(@NonNull HttpStatus status, HttpRequest<?> request) Found aRouteMatch
for the givenHttpStatus
code.<R> Optional<RouteMatch<R>>
findStatusRoute
(@NonNull Class<?> originatingClass, @NonNull HttpStatus status, HttpRequest<?> request) Found aRouteMatch
for the givenHttpStatus
code.<R> Optional<RouteMatch<R>>
findStatusRoute
(Class<?> originatingClass, int statusCode, HttpRequest<?> request) Found aRouteMatch
for the given status code.resolveFilterEntries
(RouteMatch<?> routeMatch) Resolves the initial list of filters.resolveFilters
(HttpRequest<?> request, List<HttpFilterResolver.FilterEntry> filterEntries) Returns which filters should apply for the given request.<T,
R> @NonNull Optional<UriRouteMatch<T, R>> route
(@NonNull HttpMethod httpMethod, @NonNull CharSequence uri) Finds the first possible route for the given HTTP method and URI.<R> Optional<RouteMatch<R>>
route
(@NonNull HttpStatus status) Found aRouteMatch
for the givenHttpStatus
code.<R> Optional<RouteMatch<R>>
route
(@NonNull Class<?> originatingClass, @NonNull HttpStatus status) Found aRouteMatch
for the givenHttpStatus
code.<R> Optional<RouteMatch<R>>
Match a route to an error.<R> Optional<RouteMatch<R>>
Match a route to an error.@NonNull Stream<UriRouteInfo<?,
?>> Returns all UriRoutes.
-
Constructor Details
-
DefaultRouter
Construct a new router for the given route builders.- Parameters:
builders
- The builders
-
DefaultRouter
Construct a new router for the given route builders.- Parameters:
builders
- The builders
-
-
Method Details
-
getExposedPorts
- Specified by:
getExposedPorts
in interfaceRouter
- Returns:
- The exposed ports.
-
applyDefaultPorts
Description copied from interface:Router
Sets the ports the application will listen to by default.- Specified by:
applyDefaultPorts
in interfaceRouter
- Parameters:
ports
- The default ports
-
find
@NonNull public <T,R> @NonNull Stream<UriRouteMatch<T,R>> find(@NonNull @NonNull HttpRequest<?> request, @NonNull @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 asRouter.find(HttpMethod, CharSequence, HttpRequest)
- Specified by:
find
in interfaceRouter
- Type Parameters:
T
- The target type.R
- The type of what- Parameters:
request
- The request, that can have overriddenHttpRequest.getMethodName()
uri
- The URI route match.- Returns:
- A
Stream
of possibleRoute
instances.
-
find
@NonNull public <T,R> @NonNull Stream<UriRouteMatch<T,R>> find(@NonNull @NonNull HttpRequest<?> request) Description copied from interface:Router
Finds all possible routes for the given HTTP request. -
find
@NonNull public <T,R> @NonNull Stream<UriRouteMatch<T,R>> find(@NonNull @NonNull HttpMethod httpMethod, @NonNull @NonNull CharSequence uri, @Nullable @Nullable HttpRequest<?> context) Description copied from interface:Router
Finds all possible routes for the given HTTP method and URI.- Specified by:
find
in interfaceRouter
- Type Parameters:
T
- The target typeR
- The type- Parameters:
httpMethod
- The HTTP methoduri
- The URI route matchcontext
- The optionalHttpRequest
context information to applyRouteMatchFilter
.- Returns:
- A
Stream
of possibleRoute
instances.
-
uriRoutes
Description copied from interface:Router
Returns all UriRoutes. -
findClosest
Description copied from interface:Router
Finds the closest match for the given request or null if none is found.- Specified by:
findClosest
in interfaceRouter
- Type Parameters:
T
- The target typeR
- The type- Parameters:
request
- The request- Returns:
- A match or null, throws
DuplicateRouteException
on multiple routes. - Throws:
DuplicateRouteException
-
findAllClosest
@NonNull public <T,R> @NonNull List<UriRouteMatch<T,R>> findAllClosest(@NonNull @NonNull HttpRequest<?> request) Description copied from interface:Router
Finds the closest match for the given request.- Specified by:
findAllClosest
in interfaceRouter
- Type Parameters:
T
- The target typeR
- The type- Parameters:
request
- The request- Returns:
- A
List
of possibleRoute
instances.
-
route
@NonNull public <T,R> @NonNull Optional<UriRouteMatch<T,R>> route(@NonNull @NonNull HttpMethod httpMethod, @NonNull @NonNull CharSequence uri) Description copied from interface:Router
Finds the first possible route for the given HTTP method and URI. -
route
Description copied from interface:Router
Found aRouteMatch
for the givenHttpStatus
code.- Specified by:
route
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
status
- The HTTP status- Returns:
- The
RouteMatch
-
route
public <R> Optional<RouteMatch<R>> route(@NonNull @NonNull Class<?> originatingClass, @NonNull @NonNull HttpStatus status) Description copied from interface:Router
Found aRouteMatch
for the givenHttpStatus
code.- Specified by:
route
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
originatingClass
- The class the error originates fromstatus
- The HTTP status- Returns:
- The
RouteMatch
-
route
public <R> Optional<RouteMatch<R>> route(@NonNull @NonNull Class<?> originatingClass, @NonNull @NonNull Throwable error) Description copied from interface:Router
Match a route to an error.- Specified by:
route
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
originatingClass
- The class the error originates fromerror
- The error- Returns:
- The
RouteMatch
-
findErrorRoute
public <R> Optional<RouteMatch<R>> findErrorRoute(@NonNull @NonNull Class<?> originatingClass, @NonNull @NonNull Throwable error, HttpRequest<?> request) Description copied from interface:Router
Match a route to an error.- Specified by:
findErrorRoute
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
originatingClass
- The class the error originates fromerror
- The errorrequest
- The request- Returns:
- The
RouteMatch
-
findErrorRoute
public <R> Optional<RouteMatch<R>> findErrorRoute(@NonNull @NonNull Throwable error, HttpRequest<?> request) Description copied from interface:Router
Match a route to an error.- Specified by:
findErrorRoute
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
error
- The errorrequest
- The request- Returns:
- The
RouteMatch
-
findStatusRoute
public <R> Optional<RouteMatch<R>> findStatusRoute(@NonNull @NonNull Class<?> originatingClass, @NonNull @NonNull HttpStatus status, HttpRequest<?> request) Description copied from interface:Router
Found aRouteMatch
for the givenHttpStatus
code.- Specified by:
findStatusRoute
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
originatingClass
- The class the error originates fromstatus
- The HTTP statusrequest
- The request- Returns:
- The
RouteMatch
-
findStatusRoute
public <R> Optional<RouteMatch<R>> findStatusRoute(@NonNull @NonNull HttpStatus status, HttpRequest<?> request) Description copied from interface:Router
Found aRouteMatch
for the givenHttpStatus
code.- Specified by:
findStatusRoute
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
status
- The HTTP statusrequest
- The request- Returns:
- The
RouteMatch
-
findStatusRoute
public <R> Optional<RouteMatch<R>> findStatusRoute(Class<?> originatingClass, int statusCode, HttpRequest<?> request) Description copied from interface:Router
Found aRouteMatch
for the given status code.- Specified by:
findStatusRoute
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
originatingClass
- The class the error originates fromstatusCode
- The HTTP statusrequest
- The request- Returns:
- The
RouteMatch
-
findStatusRoute
Description copied from interface:Router
Found aRouteMatch
for the given status code.- Specified by:
findStatusRoute
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
statusCode
- The HTTP status coderequest
- The request- Returns:
- The
RouteMatch
-
route
Description copied from interface:Router
Match a route to an error.- Specified by:
route
in interfaceRouter
- Type Parameters:
R
- The matched route- Parameters:
error
- The error- Returns:
- The
RouteMatch
-
findFilters
@NonNull public @NonNull List<GenericHttpFilter> findFilters(@NonNull @NonNull HttpRequest<?> request) Description copied from interface:Router
Build a filteredPublisher
for an action.- Specified by:
findFilters
in interfaceRouter
- Parameters:
request
- The request- Returns:
- A new filtered publisher
-
findAny
@NonNull public <T,R> @NonNull Stream<UriRouteMatch<T,R>> findAny(@NonNull @NonNull CharSequence uri, @Nullable @Nullable HttpRequest<?> request) Description copied from interface:Router
Find anyRouteMatch
regardless of HTTP method.- Specified by:
findAny
in interfaceRouter
- Type Parameters:
T
- The target typeR
- The return type- Parameters:
uri
- The URIrequest
- The optionalHttpRequest
context information to applyRouteMatchFilter
.- Returns:
- A stream of route matches
-
findAny
Description copied from interface:Router
Find anyRouteMatch
regardless of HTTP method. -
resolveFilterEntries
Description copied from interface:HttpFilterResolver
Resolves the initial list of filters.- Specified by:
resolveFilterEntries
in interfaceHttpFilterResolver<RouteMatch<?>>
- Parameters:
routeMatch
- The context- Returns:
- The filters
-
resolveFilters
public List<GenericHttpFilter> resolveFilters(HttpRequest<?> request, List<HttpFilterResolver.FilterEntry> filterEntries) Description copied from interface:HttpFilterResolver
Returns which filters should apply for the given request.- Specified by:
resolveFilters
in interfaceHttpFilterResolver<RouteMatch<?>>
- Parameters:
request
- The requestfilterEntries
- the filter entries- Returns:
- The list of filters
-