Package akka.http.scaladsl.server

Class Route

java.lang.Object

akka.http.scaladsl.server.Route

public class Route
extends java.lang.Object

Constructor Summary

Constructors

Constructor	Description
Route()

Method Summary

Modifier and Type	Method	Description
static scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>>	apply(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> f)	Helper for constructing a Route from a function literal.
static scala.Function1<HttpRequest,scala.concurrent.Future<HttpResponse>>	asyncHandler(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route, RoutingSettings routingSettings, ParserSettings parserSettings, akka.stream.Materializer materializer, RoutingLog routingLog, scala.concurrent.ExecutionContextExecutor executionContext, RejectionHandler rejectionHandler, ExceptionHandler exceptionHandler)	Deprecated. Use `toFunction` instead, which only requires an implicit ActorSystem and no rejection/exception handlers.
static scala.Function1<HttpRequest,scala.concurrent.Future<HttpResponse>>	createAsyncHandler(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> sealedRoute, RoutingLog routingLog, RoutingSettings routingSettings, ParserSettings parserSettings, scala.concurrent.ExecutionContextExecutor ec, akka.stream.Materializer mat)
static akka.stream.scaladsl.Flow<HttpRequest,HttpResponse,akka.NotUsed>	handlerFlow(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route, RoutingSettings routingSettings, ParserSettings parserSettings, akka.stream.Materializer materializer, RoutingLog routingLog, scala.concurrent.ExecutionContextExecutor executionContext, RejectionHandler rejectionHandler, ExceptionHandler exceptionHandler)	Deprecated. Replaced by `toFlow` that takes an implicit ActorSystem.
static scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>>	seal(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route, RoutingSettings routingSettings, ParserSettings parserSettings, RejectionHandler rejectionHandler, ExceptionHandler exceptionHandler)	"Seals" a route by wrapping it with default exception handling and rejection conversion.
static akka.stream.scaladsl.Flow<HttpRequest,HttpResponse,akka.NotUsed>	toFlow(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route, akka.actor.ClassicActorSystemProvider system)	Turns a Route into a server flow.
static scala.Function1<HttpRequest,scala.concurrent.Future<HttpResponse>>	toFunction(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route, akka.actor.ClassicActorSystemProvider system)

Methods inherited from class java.lang.Object

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

Constructor Detail

Route

public Route()

Method Detail

apply

public static scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> apply(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> f)

Helper for constructing a Route from a function literal.

Parameters:

f - (undocumented)

Returns:

(undocumented)

seal

public static scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> seal(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route,
                                                                                              RoutingSettings routingSettings,
                                                                                              ParserSettings parserSettings,
                                                                                              RejectionHandler rejectionHandler,
                                                                                              ExceptionHandler exceptionHandler)

"Seals" a route by wrapping it with default exception handling and rejection conversion.

A sealed route has these properties: - The result of the route will always be a complete response, i.e. the result of the future is a Success(RouteResult.Complete(response)), never a failed future and never a rejected route. These will be already be handled using the implicitly given RejectionHandler and ExceptionHandler (or the default handlers if none are given or can be found implicitly). - Consequently, no route alternatives will be tried that were combined with this route using the ~ on routes or the {@link Directive.|} operator on directives.

Parameters:

route - (undocumented)

routingSettings - (undocumented)

parserSettings - (undocumented)

rejectionHandler - (undocumented)

exceptionHandler - (undocumented)

Returns:

(undocumented)

toFlow

public static akka.stream.scaladsl.Flow<HttpRequest,HttpResponse,akka.NotUsed> toFlow(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route,
                                                                                                  akka.actor.ClassicActorSystemProvider system)

Turns a Route into a server flow.

This conversion is also implicitly available wherever a Route is used through RouteResult#routeToFlow.

Parameters:

route - (undocumented)

system - (undocumented)

Returns:

(undocumented)

handlerFlow

public static akka.stream.scaladsl.Flow<HttpRequest,HttpResponse,akka.NotUsed> handlerFlow(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route,
                                                                                                       RoutingSettings routingSettings,
                                                                                                       ParserSettings parserSettings,
                                                                                                       akka.stream.Materializer materializer,
                                                                                                       RoutingLog routingLog,
                                                                                                       scala.concurrent.ExecutionContextExecutor executionContext,
                                                                                                       RejectionHandler rejectionHandler,
                                                                                                       ExceptionHandler exceptionHandler)

Deprecated.

Replaced by `toFlow` that takes an implicit ActorSystem. Since 10.2.0.

Turns a Route into a server flow.

Parameters:

route - (undocumented)

routingSettings - (undocumented)

parserSettings - (undocumented)

materializer - (undocumented)

routingLog - (undocumented)

executionContext - (undocumented)

rejectionHandler - (undocumented)

exceptionHandler - (undocumented)

Returns:

(undocumented)

toFunction

public static scala.Function1<HttpRequest,scala.concurrent.Future<HttpResponse>> toFunction(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route,
                                                                                                  akka.actor.ClassicActorSystemProvider system)

asyncHandler

public static scala.Function1<HttpRequest,scala.concurrent.Future<HttpResponse>> asyncHandler(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> route,
                                                                                                    RoutingSettings routingSettings,
                                                                                                    ParserSettings parserSettings,
                                                                                                    akka.stream.Materializer materializer,
                                                                                                    RoutingLog routingLog,
                                                                                                    scala.concurrent.ExecutionContextExecutor executionContext,
                                                                                                    RejectionHandler rejectionHandler,
                                                                                                    ExceptionHandler exceptionHandler)

Deprecated.

Use `toFunction` instead, which only requires an implicit ActorSystem and no rejection/exception handlers. Use directives to specify custom exceptions or rejection handlers. Since 10.2.0.

Turns a Route into an async handler function.

Parameters:

route - (undocumented)

routingSettings - (undocumented)

parserSettings - (undocumented)

materializer - (undocumented)

routingLog - (undocumented)

executionContext - (undocumented)

rejectionHandler - (undocumented)

exceptionHandler - (undocumented)

Returns:

(undocumented)

createAsyncHandler

public static scala.Function1<HttpRequest,scala.concurrent.Future<HttpResponse>> createAsyncHandler(scala.Function1<RequestContext,scala.concurrent.Future<RouteResult>> sealedRoute,
                                                                                                          RoutingLog routingLog,
                                                                                                          RoutingSettings routingSettings,
                                                                                                          ParserSettings parserSettings,
                                                                                                          scala.concurrent.ExecutionContextExecutor ec,
                                                                                                          akka.stream.Materializer mat)