HTTP::Server::Response
The response to configure and write to in an HTTP::Server handler.
The response status and headers must be configured before writing
the response body. Once response output is written, changing the status
and headers properties has no effect.
The HTTP::Server::Response is a write-only IO, so all IO methods are available
in it.
A response can be upgraded with the upgrade method. Once invoked, headers
are written and the connection IO (a socket) is yielded to the given block.
This is useful to implement protocol upgrades, such as websockets.
Instance methods
Closes this response, writing headers and body if not done yet. This method must be implemented if wrapping the response output.
Sends status and message as response.
This method calls #reset to remove any previous settings and writes the
given status and message to the response IO. Finally, it closes the
response.
If message is nil, the default message for status is used provided
by HTTP::Status#description.
Raises IO::Error if the response is closed or headers were already
sent.
The status code of this response, which must be set before writing the response body. If not set, the default value is 200 (OK).
Upgrades this response, writing headers and yielding the connection IO (a socket) to the given block.
This is useful to implement protocol upgrades, such as websockets.