io.micronaut.web.router

Interface RouteMatch<R>

Type Parameters:

R - The route

All Superinterfaces:

AnnotationMetadataProvider, AnnotationSource, java.util.concurrent.Callable<R>, java.util.function.Predicate<HttpRequest>, RouteInfo<R>

All Known Subinterfaces:

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

All Known Implementing Classes:

BasicObjectRouteMatch

public interface RouteMatch<R>
extends java.util.concurrent.Callable<R>, java.util.function.Predicate<HttpRequest>, RouteInfo<R>

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
default R	call() Same as execute().
RouteMatch<R>	decorate(java.util.function.Function<RouteMatch<R>,R> executor) Decorates the execution of the route with the given executor.
boolean	doesConsume(MediaType contentType) Whether the specified content type is an accepted type.
boolean	doesProduce(java.util.Collection<MediaType> acceptableTypes) Whether the route does produce any of the given types.
boolean	doesProduce(MediaType acceptableType) Whether the route does produce any of the given types.
default R	execute() Execute the route with the given values.
R	execute(java.util.Map<java.lang.String,java.lang.Object> argumentValues) Execute the route with the given values.
default boolean	explicitlyConsumes(MediaType contentType) Whether the specified content type is explicitly an accepted type.
default boolean	explicitlyProduces(MediaType contentType) Whether the specified content type is explicitly a producing type.
RouteMatch<R>	fulfill(java.util.Map<java.lang.String,java.lang.Object> argumentValues) Returns a new RouteMatch fulfilling arguments required by this route to execute.
java.util.Optional<Argument<?>>	getBodyArgument()
java.util.List<MediaType>	getProduces() The media types able to produced by this route.
default java.util.Collection<Argument>	getRequiredArguments() Returns the required arguments for this RouteMatch.
java.util.Optional<Argument<?>>	getRequiredInput(java.lang.String name) Return whether the given named input is required by this route.
ReturnType<? extends R>	getReturnType()
java.util.Map<java.lang.String,java.lang.Object>	getVariableValues()
default boolean	isExecutable()
default boolean	isRequiredInput(java.lang.String name) Return whether the given named input is required by this route.
default boolean	isSatisfied(java.lang.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.web.router.RouteInfo

findStatus, getBodyType, getConsumes, getDeclaringType, isAsync, isAsyncOrReactive, isCompletable, isErrorRoute, isReactive, isSingleResult, isSpecifiedSingle, isSuspended, isVoid, isWebSocketRoute

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, isAnnotationPresent, isDeclaredAnnotationPresent, synthesize, synthesizeDeclared

Method Detail

getVariableValues

java.util.Map<java.lang.String,java.lang.Object> getVariableValues()

Returns:

The variable values following a successful match.

execute

R execute(java.util.Map<java.lang.String,java.lang.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(java.util.Map<java.lang.String,java.lang.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(java.util.function.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

java.util.Optional<Argument<?>> getRequiredInput(java.lang.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

java.util.Optional<Argument<?>> getBodyArgument()

Returns:

The argument that represents the body

getProduces

java.util.List<MediaType> getProduces()

The media types able to produced by this route.

Specified by:

getProduces in interface RouteInfo<R>

Returns:

A list of MediaType that this route can produce

getRequiredArguments

default java.util.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()

Specified by:

getReturnType in interface RouteInfo<R>

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 java.lang.Exception

Same as execute().

Specified by:

call in interface java.util.concurrent.Callable<R>

Returns:

The result

Throws:

java.lang.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(java.lang.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

doesConsume

boolean doesConsume(@Nullable
                    MediaType contentType)

Whether the specified content type is an accepted type.

Parameters:

contentType - The content type

Returns:

True if it is

doesProduce

boolean doesProduce(@Nullable
                    java.util.Collection<MediaType> acceptableTypes)

Whether the route does produce any of the given types.

Parameters:

acceptableTypes - The acceptable types

Returns:

True if it is

doesProduce

boolean doesProduce(@Nullable
                    MediaType acceptableType)

Whether the route does produce any of the given types.

Parameters:

acceptableType - The acceptable type

Returns:

True if it is

explicitlyConsumes

default boolean explicitlyConsumes(@Nullable
                                   MediaType contentType)

Whether the specified content type is explicitly an accepted type.

Parameters:

contentType - The content type

Returns:

True if it is

explicitlyProduces

default boolean explicitlyProduces(@Nullable
                                   MediaType contentType)

Whether the specified content type is explicitly a producing type.

Parameters:

contentType - The content type

Returns:

True if it is

Since:

2.5.0

isSatisfied

default boolean isSatisfied(java.lang.String name)

Is the given input satisfied.

Parameters:

name - The name of the input

Returns:

True if it is