io.micronaut.web.router

Interface RouteMatch<R>

Type Parameters:

R - The route

All Superinterfaces:

AnnotationMetadataProvider, AnnotationSource, Callable<R>, Predicate<HttpRequest>

All Known Subinterfaces:

MethodBasedRouteMatch<T,R>, UriRouteMatch<T,R>

All Known Implementing Classes:

BasicObjectRouteMatch

public interface RouteMatch<R>
extends Callable<R>, Predicate<HttpRequest>, AnnotationMetadataProvider

A Route that is executable.

Since:

1.0

Author:

Graeme Rocher

Field Summary

Fields inherited from interface io.micronaut.core.annotation.AnnotationSource

EMPTY

Method Summary

Modifier and Type	Method and Description
boolean	accept(MediaType contentType) Whether the specified content type is an accepted type.
default R	call() Same as execute().
RouteMatch<R>	decorate(Function<RouteMatch<R>,R> executor) Decorates the execution of the route with the given executor.
default R	execute() Execute the route with the given values.
R	execute(Map<String,Object> argumentValues) Execute the route with the given values.
default boolean	explicitAccept(MediaType contentType) Whether the specified content type is explicitly an accepted type.
RouteMatch<R>	fulfill(Map<String,Object> argumentValues) Returns a new RouteMatch fulfilling arguments required by this route to execute.
Optional<Argument<?>>	getBodyArgument()
Class<?>	getDeclaringType() The declaring type of the route.
List<MediaType>	getProduces() The media types able to produced by this route.
default Collection<Argument>	getRequiredArguments() Returns the required arguments for this RouteMatch.
Optional<Argument<?>>	getRequiredInput(String name) Return whether the given named input is required by this route.
ReturnType<? extends R>	getReturnType()
Map<String,Object>	getVariableValues()
default boolean	isExecutable()
default boolean	isRequiredInput(String name) Return whether the given named input is required by this route.
default boolean	isSatisfied(String name) Is the given input satisfied.

Methods inherited from interface java.util.function.Predicate

and, isEqual, negate, or, test

Methods inherited from interface io.micronaut.core.annotation.AnnotationMetadataProvider

findAnnotation, findAnnotation, findDeclaredAnnotation, findDeclaredAnnotation, getAnnotationMetadata, isAnnotationPresent, isDeclaredAnnotationPresent, synthesize, synthesizeAll, synthesizeAnnotationsByType, synthesizeDeclared, synthesizeDeclared, synthesizeDeclaredAnnotationsByType

Methods inherited from interface io.micronaut.core.annotation.AnnotationSource

getAnnotation, getAnnotation, getDeclaredAnnotation, getDeclaredAnnotation

Method Detail

getDeclaringType

Class<?> getDeclaringType()

The declaring type of the route.

Returns:

The declaring type

getVariableValues

Map<String,Object> getVariableValues()

Returns:

The variable values following a successful match.

execute

R execute(Map<String,Object> argumentValues)

Execute the route with the given values. The passed map should contain values for every argument returned by getRequiredArguments().

Parameters:

argumentValues - The argument values

Returns:

The result

fulfill

RouteMatch<R> fulfill(Map<String,Object> argumentValues)

Returns a new RouteMatch fulfilling arguments required by this route to execute. The new route will not return the given arguments from the getRequiredArguments() method.

Parameters:

argumentValues - The argument values

Returns:

The fulfilled route

decorate

RouteMatch<R> decorate(Function<RouteMatch<R>,R> executor)

Decorates the execution of the route with the given executor.

Parameters:

executor - The executor

Returns:

A new route match

getRequiredInput

Optional<Argument<?>> getRequiredInput(String name)

Return whether the given named input is required by this route.

Parameters:

name - The name of the input

Returns:

True if it is

getBodyArgument

Optional<Argument<?>> getBodyArgument()

Returns:

The argument that represents the body

getProduces

List<MediaType> getProduces()

The media types able to produced by this route.

Returns:

A list of MediaType that this route can produce

getRequiredArguments

default Collection<Argument> getRequiredArguments()

Returns the required arguments for this RouteMatch.

Returns:

The required arguments in order to invoke this route

getReturnType

ReturnType<? extends R> getReturnType()

Returns:

The return type

execute

default R execute()

Execute the route with the given values. Note if there are required arguments returned from getRequiredArguments() this method will throw an IllegalArgumentException.

Returns:

The result

call

default R call()
        throws Exception

Same as execute().

Specified by:

call in interface Callable<R>

Returns:

The result

Throws:

Exception - When an exception occurs

isExecutable

default boolean isExecutable()

Returns:

Whether the route match can be executed without passing any additional arguments ie. via execute()

isRequiredInput

default boolean isRequiredInput(String name)

Return whether the given named input is required by this route.

Parameters:

name - The name of the input

Returns:

True if it is

accept

boolean accept(@Nullable
               MediaType contentType)

Whether the specified content type is an accepted type.

Parameters:

contentType - The content type

Returns:

True if it is

explicitAccept

default boolean explicitAccept(@Nullable
                               MediaType contentType)

Whether the specified content type is explicitly an accepted type.

Parameters:

contentType - The content type

Returns:

True if it is

isSatisfied

default boolean isSatisfied(String name)

Is the given input satisfied.

Parameters:

name - The name of the input

Returns:

True if it is