Module H1.ReqdSource

Request Descriptor

Sourcetype t
Sourceval request : t -> Request.t
Sourceval request_body : t -> Body.Reader.t
Sourceval response : t -> Response.t option
Sourceval response_exn : t -> Response.t

Responding

The following functions will initiate a response for the corresponding request in t. Depending on the state of the current connection, and the header values of the response, this may cause the connection to close or to persist for reuse by the client.

See RFC7230§6.3 for more details.

Sourceval respond_with_string : t -> Response.t -> string -> unit
Sourceval respond_with_bigstring : t -> Response.t -> Bigstringaf.t -> unit
Sourceval respond_with_streaming : ?flush_headers_immediately:bool -> t -> Response.t -> Body.Writer.t
Sourceval respond_with_upgrade : ?reason:string -> t -> Headers.t -> unit

Initiate an HTTP upgrade. Server_connection.next_write_request and next_read_request will begin returning `Upgrade once the response headers have been written, which indicates that the runtime should take over direct control of the socket rather than shuttling bytes through httpaf.

The headers must indicate a valid upgrade message, e.g. must include "Connection: upgrade". See Request.is_upgrade.

Exception Handling

Sourceval report_exn : t -> exn -> unit
Sourceval try_with : t -> (unit -> unit) -> (unit, exn) result