mirror of
https://github.com/ninenines/cowboy.git
synced 2025-07-15 04:30:25 +00:00
a45813c60f
Before this commit we had an issue where configuring a
Websocket connection was simply not possible without
doing magic, adding callbacks or extra return values.
The init/2 function only allowed setting hibernate
and timeout options.
After this commit, when switching to a different
type of handler you can either return
{module, Req, State}
or
{module, Req, State, Opts}
where Opts is any value (as far as the sub protocol
interface is concerned) and is ultimately checked
by the custom handlers.
A large protocol like Websocket would accept only
a map there, with many different options, while a
small interface like loop handlers would allow
passing hibernate and nothing else.
For Websocket, hibernate must be set from the
websocket_init/1 callback, because init/2 executes
in a separate process.
Sub protocols now have two callbacks: one with the
Opts value, one without.
The loop handler code was largely reworked and
simplified. It does not need to manage a timeout
or read from the socket anymore, it's the job of
the protocol code. A lot of unnecessary stuff was
therefore removed.
Websocket compression must now be enabled from
the handler options instead of per listener. This
means that a project can have two separate Websocket
handlers with different options. Compression is
still disabled by default, and the idle_timeout
value was changed from inifnity to 60000 (60 seconds),
as that's safer and is also a good value for mobile
devices.
|
||
|---|---|---|
| .. | ||
| architecture.asciidoc | ||
| book.asciidoc | ||
| broken_clients.asciidoc | ||
| constraints.asciidoc | ||
| cookies.asciidoc | ||
| cowboy.sty | ||
| erlang_web.asciidoc | ||
| flow_diagram.asciidoc | ||
| getting_started.asciidoc | ||
| handlers.asciidoc | ||
| hooks.asciidoc | ||
| http_req_resp.png | ||
| http_req_resp.svg | ||
| introduction.asciidoc | ||
| listeners.asciidoc | ||
| loop_handlers.asciidoc | ||
| middlewares.asciidoc | ||
| modern_web.asciidoc | ||
| multipart.asciidoc | ||
| overview.asciidoc | ||
| req.asciidoc | ||
| req_body.asciidoc | ||
| resource_design.asciidoc | ||
| resp.asciidoc | ||
| rest_cond.png | ||
| rest_cond.svg | ||
| rest_conneg.png | ||
| rest_conneg.svg | ||
| rest_delete.png | ||
| rest_delete.svg | ||
| rest_flowcharts.asciidoc | ||
| rest_get_head.png | ||
| rest_get_head.svg | ||
| rest_handlers.asciidoc | ||
| rest_options.png | ||
| rest_options.svg | ||
| rest_principles.asciidoc | ||
| rest_put_post_patch.png | ||
| rest_put_post_patch.svg | ||
| rest_start.png | ||
| rest_start.svg | ||
| routing.asciidoc | ||
| static_files.asciidoc | ||
| streams.asciidoc | ||
| sub_protocols.asciidoc | ||
| ws_handlers.asciidoc | ||
| ws_protocol.asciidoc | ||
