Exchange

Documentation

data Exception

An exception that occurs during an HTTP exchange.

Constructors

Http !HttpException

The response was not a valid HTTP response

Send !SendException

Transport exception while sending. When backed by stream sockets, exceptions like ECONNRESET show up here.

Receive !ReceiveException

Transport exception while receiving. Depending on the backend, this may or may not include an end-of-input exception. For stream sockets, end-of-input is not presented as an exception. It is presented as a zero-length result.

Instances

Exception Exception

Defined in Exchange

Methods

toException :: Exception -> SomeException

fromException :: SomeException -> Maybe Exception

displayException :: Exception -> String

Show Exception

Defined in Exchange

Methods

showsPrec :: Int -> Exception -> ShowS

show :: Exception -> String

showList :: [Exception] -> ShowS

data HttpException

Constructors

ChunkTooLarge

ChunkedBodyEndOfInput

NonchunkedBodyEndOfInput

ContentLengthDuplicated

ContentLengthMalformed

ContentLengthTooLarge

ExpectedCrlfAfterChunk

ExpectedCrlfAfterChunkLength

ExpectedCrlfBeforeChunkLength

HeadersMalformed

HeadersEndOfInput

HeadersTooLarge

ImplementationMistake

NonNumericChunkLength

PipelinedResponses

TransferEncodingUnrecognized

TransferEncodingDuplicated

Instances

Exception HttpException

Defined in Http.Exchange.Types

Methods

toException :: HttpException -> SomeException

fromException :: SomeException -> Maybe HttpException

displayException :: HttpException -> String

Show HttpException

Defined in Http.Exchange.Types

Methods

showsPrec :: Int -> HttpException -> ShowS

show :: HttpException -> String

showList :: [HttpException] -> ShowS

exchange :: Resource -> Bodied Request -> M (Either Exception (Bodied Response))

Send an HTTP request and await a response. This function takes responsibility for encoding the request and decoding the response. It deals with the Transfer-Encoding of the response and supports both chunked and nonchunked responses.