ktor-client-core/io.ktor.client.call/HttpClientCall

HttpClientCall

open class HttpClientCall(val client: HttpClient) : CoroutineScope

A pair of a request and response for a specific HttpClient.

Constructors

HttpClientCall

fun HttpClientCall(client: HttpClient, requestData: HttpRequestData, responseData: HttpResponseData)

HttpClientCall

fun HttpClientCall(client: HttpClient)

Types

Companion

object Companion

Functions

body

suspend fun body(info: TypeInfo): Any

Tries to receive the payload of the response as a specific expected type provided in info. Returns response if info corresponds to HttpResponse.

bodyNullable

suspend fun bodyNullable(info: TypeInfo): Any?

Tries to receive the payload of the response as a specific expected type provided in info. Returns response if info corresponds to HttpResponse.

toString

open override fun toString(): String

Properties

attributes

val attributes: Attributes

Typed Attributes associated to this call serving as a lightweight container.

client

val client: HttpClient

the client that executed the call.

coroutineContext

open override val coroutineContext: CoroutineContext

request

lateinit var request: HttpRequest

The request sent by the client.

response

lateinit var response: HttpResponse

The response sent by the server.

Extensions

body

inline suspend fun <T> HttpClientCall.body(): T

Tries to receive the payload of the response as a specific type T.

mapEngineExceptions

fun CoroutineScope.mapEngineExceptions(input: ByteReadChannel, request: HttpRequestData): ByteReadChannel

Returns ByteReadChannel with ByteChannel.close handler that returns SocketTimeoutException instead of SocketTimeoutException.

fun CoroutineScope.mapEngineExceptions(output: ByteWriteChannel, request: HttpRequestData): ByteWriteChannel

Returns ByteWriteChannel with ByteChannel.close handler that returns SocketTimeoutException instead of SocketTimeoutException.

receive

inline suspend fun <T> HttpClientCall.~~receive~~(): T

Tries to receive the payload of the response as a specific type T.

suspend fun HttpClientCall.~~receive~~(info: TypeInfo): Any

Tries to receive the payload of the response as a specific expected type provided in info. Returns response if info corresponds to HttpResponse.

save

suspend fun HttpClientCall.save(): HttpClientCall

Fetch data for HttpClientCall and close the origin.

wrapWithContent

fun HttpClientCall.~~wrapWithContent~~(content: ByteReadChannel, shouldCloseOrigin: Boolean): HttpClientCall

fun HttpClientCall.wrapWithContent(content: ByteReadChannel): HttpClientCall

Wrap existing HttpClientCall with new content.