class type http_response =object..end
Encapsultation of the HTTP response for a single request
This class has an internal
queue of response tokens that are not yet processed. One can easily add
new tokens to the end of the queue (send).
The class is responsible for determining the transfer encoding:
Currently, the TE request header is not taken into account. The trailer
is always empty.
The following headers are set (or removed) by this class:
Transfer-EncodingTrailerDateConnectionUpgradeServer (it is appended to this field)Responses for HEAD requests have the special behaviour that the body is silently dropped. The calculation of header fields is not affected by this. This means that HEAD can be easily implemented by doing the same as for GET.
Responses for other requests that must not include a body must set
Content-Length to 0.
method state : resp_stateReports the state. The initial state is `Inhibited
method bidirectional_phase : boolThe bidrectional phase starts after "100 Continue" has been sent to the client, and stops when the response body begins. The bidirectional phase is special for the calculation of timeout values (input determines the timeout although the response has started).
method send : resp_token -> unitAdd token to the end of the send queue
method send_queue_empty : boolReturn whether the send queue is empty. When the state is `Inhibited, this
method fakes an empty queue.
method protocol : Nethttp.protocolThe HTTP version of the response. This is currently always HTTP/1.1, but maybe we need to fake lower versions for buggy clients. Let's see what comes.
method close_connection : boolReturns whether the connection should be closed after this response.
This flag should be evaluated when the `Resp_end front token has been
reached.
method transfer_encoding : transfer_codingReturns the selected transfer encoding. This is valid after the header
has been passed to this object with send.
method front_token : front_tokenThe first token of the queue, represented as data_chunk. Raises
Send_queue_empty when there is currently no front token, or the state
is `Inhibited.
If there is a front token, it will never have length 0.
Note that Unix_error exceptions can be raised when `Resp_action
tokens are processed.
method set_callback : (unit -> unit) -> unitThe function will be called when either set_state changes the state,
or when the send queue becomes empty. Note that the callback must never
fail, it is called in situations that make it hard to recover from errors.
method body_size : int64Accumulated size of the response body
method set_state : resp_state -> unitSets the state
method advance : int -> unitTell this object that n bytes of the front token could be really
sent using Unix.write. If this means that the whole front token
has been sent, the next token is pulled from the queue and is made
the new front token. Otherwise, the data chunk representing the
front token is modified such that the position is advanced by
n, and the length is reduced by n.