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

RoutingPipelineResponse

class RoutingPipelineResponse(val call: RoutingPipelineCall, val pipeline: ApplicationSendPipeline, val engineResponse: PipelineResponse) : PipelineResponse

An application response handled by RoutingRoot.

Constructors

constructor(call: RoutingPipelineCall, pipeline: ApplicationSendPipeline, engineResponse: PipelineResponse)

Properties

call

open override val call: RoutingPipelineCall

An PipelineCall instance this PipelineResponse is attached to.

open override val cookies: ResponseCookies

Provides access to cookies for this response.

engineResponse

val engineResponse: PipelineResponse

headers

open override val headers: ResponseHeaders

Provides access to headers for the current response.

isCommitted

open override val isCommitted: Boolean

Indicates that this response is already committed and no further changes are allowed.

isSent

open override val isSent: Boolean

Indicates that this response is already fully sent to the client.

pipeline

open override val pipeline: ApplicationSendPipeline

A pipeline for sending content.

responseType

var ApplicationResponse.responseType: TypeInfo?

A type of response object that is passed in the respond function. Can be useful for custom serializations.

Functions

cacheControl

fun ApplicationResponse.cacheControl(value: CacheControl)

Appends the Cache-Control header with the specified value to a response.

contentRange

fun ApplicationResponse.contentRange(range: LongRange?, fullLength: Long? = null, unit: RangeUnits)

fun ApplicationResponse.contentRange(range: LongRange?, fullLength: Long? = null, unit: String = RangeUnits.Bytes.unitToken)

Appends the Content-Range header with the specified range and fullLength to a response.

etag

fun ApplicationResponse.etag(value: String)

Appends the E-Tag header with the specified value to a response.

header

fun ApplicationResponse.header(name: String, value: Int)

fun ApplicationResponse.header(name: String, value: Long)

fun ApplicationResponse.header(name: String, value: String)

Appends a header with the specified name and value to a response.

link

fun ApplicationResponse.link(header: LinkHeader)

Append Link header to HTTP response

fun ApplicationResponse.link(uri: String, vararg rel: String)

Append Link header to HTTP response with specified uri and rel

push

open override fun push(builder: ResponsePushBuilder)

Produces HTTP/2 push from a server to a client or sets an HTTP/1.x hint header or does nothing. Exact behaviour is up to engine implementation.

status

open override fun status(): HttpStatusCode?

Returns a response status code or null if a status code is not set.

open override fun status(value: HttpStatusCode)

Specifies a status code for a response.