ktor-server-core/io.ktor.server.routing

Package-level declarations

Types

AndRouteSelector

data class AndRouteSelector(val first: RouteSelector, val second: RouteSelector) : RouteSelector

Evaluates a route as a result of the AND operation using two other selectors.

ConstantParameterRouteSelector

data class ConstantParameterRouteSelector(val name: String, val value: String) : RouteSelector

Evaluates a route against a constant query parameter value.

HostRouteSelector

data class HostRouteSelector(val hostList: List<String>, val hostPatterns: List<Regex>, val portsList: List<Int>) : RouteSelector

Evaluates a route against a request's host and port.

HttpAcceptRouteSelector

data class HttpAcceptRouteSelector(val contentType: ContentType) : RouteSelector

Evaluates a route against a Content-Type in the HttpHeaders.Accept request header.

HttpHeaderRouteSelector

data class HttpHeaderRouteSelector(val name: String, val value: String) : RouteSelector

Evaluates a route against a header in the request.

HttpMethodRouteSelector

data class HttpMethodRouteSelector(val method: HttpMethod) : RouteSelector

Evaluates a route against an HttpMethod.

LocalPortRouteSelector

data class LocalPortRouteSelector(val port: Int) : RouteSelector

Evaluates a route against the port on which a call is received.

OptionalParameterRouteSelector

data class OptionalParameterRouteSelector(val name: String) : RouteSelector

Evaluates a route against an optional query parameter value and captures its value, if found.

OrRouteSelector

data class OrRouteSelector(val first: RouteSelector, val second: RouteSelector) : RouteSelector

Evaluates a route as a result of the OR operation using two other selectors.

ParameterRouteSelector

data class ParameterRouteSelector(val name: String) : RouteSelector

Evaluates a route against a query parameter value and captures its value.

PathSegmentConstantRouteSelector

data class PathSegmentConstantRouteSelector(val value: String) : RouteSelector

Evaluates a route against a constant path segment.

PathSegmentOptionalParameterRouteSelector

data class PathSegmentOptionalParameterRouteSelector(val name: String, val prefix: String? = null, val suffix: String? = null) : RouteSelector

Evaluates a route against an optional parameter path segment and captures its value, if any.

PathSegmentParameterRouteSelector

data class PathSegmentParameterRouteSelector(val name: String, val prefix: String? = null, val suffix: String? = null) : RouteSelector

Evaluates a route against a parameter path segment and captures its value.

PathSegmentSelectorBuilder

object PathSegmentSelectorBuilder

A helper object for building instances of RouteSelector from path segments.

PathSegmentTailcardRouteSelector

data class PathSegmentTailcardRouteSelector(val name: String = "", val prefix: String = "") : RouteSelector

Evaluates a route against any number of trailing path segments, and captures their values.

PathSegmentWildcardRouteSelector

object PathSegmentWildcardRouteSelector : RouteSelector

Evaluates a route against any single path segment.

RootRouteSelector

class RootRouteSelector(rootPath: String = "") : RouteSelector

A selector for a routing root.

Route

open class Route(val parent: Route?, val selector: RouteSelector, val developmentMode: Boolean = false, val environment: ApplicationEnvironment? = null) : ApplicationCallPipeline

Describes a node in a routing tree.

RouteSelector

abstract class RouteSelector constructor(val quality: Double)

Serves as the base type for routing selectors.

RouteSelectorEvaluation

sealed class RouteSelectorEvaluation

A result of a route evaluation against a call.

Routing

class Routing(val application: Application) : Route

A root routing node of an Application. You can learn more about routing in Ktor from Routing.

RoutingApplicationCall

class RoutingApplicationCall(val engineCall: ApplicationCall, val route: Route, val coroutineContext: CoroutineContext, receivePipeline: ApplicationReceivePipeline, responsePipeline: ApplicationSendPipeline, parameters: Parameters) : ApplicationCall, CoroutineScope

An application call handled by Routing.

RoutingApplicationRequest

class RoutingApplicationRequest(val call: RoutingApplicationCall, val pipeline: ApplicationReceivePipeline, val engineRequest: ApplicationRequest) : ApplicationRequest

An application request handled by Routing.

RoutingApplicationResponse

class RoutingApplicationResponse(val call: RoutingApplicationCall, val pipeline: ApplicationSendPipeline, val engineResponse: ApplicationResponse) : ApplicationResponse

An application response handled by Routing.

RoutingPath

class RoutingPath

A parsed routing path. Consist of number of segments parts.

RoutingPathSegment

data class RoutingPathSegment(val value: String, val kind: RoutingPathSegmentKind)

A single routing path segment.

RoutingPathSegmentKind

enum RoutingPathSegmentKind : Enum<RoutingPathSegmentKind>

Possible routing path segment kinds.

RoutingResolveContext

class RoutingResolveContext(val routing: Route, val call: ApplicationCall, tracers: List<(RoutingResolveTrace) -> Unit>)

Represents a context in which routing resolution is being performed

RoutingResolveResult

sealed class RoutingResolveResult

Represents a result of routing resolution.

RoutingResolveTrace

class RoutingResolveTrace(val call: ApplicationCall, val segments: List<String>)

Represents the trace of routing resolution process for diagnostics.

RoutingResolveTraceEntry

open class RoutingResolveTraceEntry(val route: Route, val segmentIndex: Int, var result: RoutingResolveResult? = null)

Represents a single entry in the RoutingResolveTrace.

TrailingSlashRouteSelector

object TrailingSlashRouteSelector : RouteSelector

Evaluates a route against a single trailing slash.

Functions

fun Route.accept(contentType: ContentType, build: Route.() -> Unit): Route

Builds a route to match requests with the HttpHeaders.Accept header matching the specified contentType.

contentType

fun Route.contentType(contentType: ContentType, build: Route.() -> Unit): Route

Builds a route to match requests with the HttpHeaders.ContentType header matching the specified contentType.

createRouteFromPath

fun Route.createRouteFromPath(path: String): Route

Creates a routing entry for specified path.

delete

fun Route.delete(body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match DELETE requests.

fun Route.delete(path: String, body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match DELETE requests with the specified path.

get

fun Route.get(body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match GET requests.

fun Route.get(path: String, body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match GET requests with the specified path.

getAllRoutes

fun Route.getAllRoutes(): List<Route>

Return list of endpoints with handlers under this route.

head

fun Route.head(body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match HEAD requests.

fun Route.head(path: String, body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match HEAD requests with the specified path.

header

fun Route.header(name: String, value: String, build: Route.() -> Unit): Route

Builds a route to match a header with the specified name and value.

host

fun Route.host(host: String, port: Int = 0, build: Route.() -> Unit): Route

Creates a route to match a request's host and port. There are no any host resolutions/transformations applied to a host: a request host is treated as a string.

fun Route.host(hosts: List<String>, ports: List<Int> = emptyList(), build: Route.() -> Unit): Route

fun Route.host(hostPattern: Regex, port: Int = 0, build: Route.() -> Unit): Route

Creates a route to match a request host and port. There are no any host resolutions/transformations applied to a host: a request host is treated as a string.

fun Route.host(hosts: List<String>, hostPatterns: List<Regex>, ports: List<Int> = emptyList(), build: Route.() -> Unit): Route

Creates a route to match s request host and port. There are no any host resolutions/transformations applied to a host: a request host is treated as a string.

localPort

fun Route.localPort(port: Int, build: Route.() -> Unit): Route

Creates a route to match a port on which a call was received.

method

fun Route.method(method: HttpMethod, body: Route.() -> Unit): Route

Builds a route to match the specified HTTP method.

optionalParam

fun Route.optionalParam(name: String, build: Route.() -> Unit): Route

Builds a route to capture an optional parameter with specified name, if it exists.

options

fun Route.options(body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match OPTIONS requests.

fun Route.options(path: String, body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match OPTIONS requests with the specified path.

param

fun Route.param(name: String, build: Route.() -> Unit): Route

Builds a route to match a parameter with the specified name and captures its value.

fun Route.param(name: String, value: String, build: Route.() -> Unit): Route

Builds a route to match a parameter with the specified name and value.

patch

@JvmName(name = "patchTyped")

inline fun <R : Any> Route.patch(crossinline body: suspend PipelineContext<Unit, ApplicationCall>.(R) -> Unit): Route

Builds a route to match PATCH requests receiving a request body as content of the R type.

fun Route.patch(body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match PATCH requests.

@JvmName(name = "patchTypedPath")

inline fun <R : Any> Route.patch(path: String, crossinline body: suspend PipelineContext<Unit, ApplicationCall>.(R) -> Unit): Route

Builds a route to match PATCH requests with the specified path receiving a request body as content of the R type.

fun Route.patch(path: String, body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match PATCH requests with the specified path.

port

fun Route.port(vararg ports: Int, build: Route.() -> Unit): Route

Creates a route to match a request port.

post

@JvmName(name = "postTyped")

inline fun <R : Any> Route.post(crossinline body: suspend PipelineContext<Unit, ApplicationCall>.(R) -> Unit): Route

Builds a route to match POST requests receiving a request body as content of the R type.

fun Route.post(body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match POST requests.

@JvmName(name = "postTypedPath")

inline fun <R : Any> Route.post(path: String, crossinline body: suspend PipelineContext<Unit, ApplicationCall>.(R) -> Unit): Route

Builds a route to match POST requests with the specified path receiving a request body as content of the R type.

fun Route.post(path: String, body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match POST requests with the specified path.

put

@JvmName(name = "putTyped")

inline fun <R : Any> Route.put(crossinline body: suspend PipelineContext<Unit, ApplicationCall>.(R) -> Unit): Route

Builds a route to match PUT requests receiving a request body as content of the R type.

fun Route.put(body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match PUT requests.

@JvmName(name = "putTypedPath")

inline fun <R : Any> Route.put(path: String, crossinline body: suspend PipelineContext<Unit, ApplicationCall>.(R) -> Unit): Route

Builds a route to match PUT requests with the specified path receiving a request body as content of the R type.

fun Route.put(path: String, body: PipelineInterceptor<Unit, ApplicationCall>): Route

Builds a route to match PUT requests with the specified path.

route

fun Route.route(path: String, build: Route.() -> Unit): Route

Builds a route to match the specified path.

fun Route.route(path: String, method: HttpMethod, build: Route.() -> Unit): Route

Builds a route to match the specified HTTP method and path.

routing

fun Application.routing(configuration: Routing.() -> Unit): Routing

Installs a Routing plugin for the this Application and runs a configuration script on it. You can learn more about routing in Ktor from Routing.

Properties

application

val Route.application: Application

Gets an Application for this Route by scanning the hierarchy to the root.

IgnoreTrailingSlash

val IgnoreTrailingSlash: ApplicationPlugin<Unit>

A plugin that enables ignoring a trailing slash when resolving URLs.

RoutingFailureStatusCode

val RoutingFailureStatusCode: AttributeKey<HttpStatusCode>