mirror of
https://github.com/ninenines/cowboy.git
synced 2025-07-15 04:30:25 +00:00
5e006be01f
Now init/3 can return one of the following values to enable loops:
- {loop, Req, State}
- {loop, Req, State, hibernate}
- {loop, Req, State, Timeout}
- {loop, Req, State, Timeout, hibernate}
Returning one of these tuples will activate looping in the HTTP handler.
When looping, handle/2 is never called. Instead, Cowboy will listen
for Erlang messages and forward them to the info/3 function of the
handler. If a timeout is defined, Cowboy will also close the connection
when no message has been received for Timeout milliseconds.
The info/3 function is defined as info(Msg, Req, State). It can return
either of the following tuples:
- {ok, Req, State}
- {loop, Req, State}
- {loop, Req, State, hibernate}
The first one ends the connection, calling terminate/2 before closing.
The others continue the loop.
Loops are useful when writing long-polling handlers that need to wait
and don't expect to receive anything. Therefore it is recommended to
set a timeout to close the connection if nothing arrives after a while
and to enable hibernate everywhere.
Normal HTTP handlers shouldn't need to use this and as such info/3
was made optional.
|
||
|---|---|---|
| .. | ||
| http_SUITE_data | ||
| chunked_handler.erl | ||
| dispatcher_prop.erl | ||
| http_handler.erl | ||
| http_handler_init_shutdown.erl | ||
| http_handler_long_polling.erl | ||
| http_SUITE.erl | ||
| proper_SUITE.erl | ||
| websocket_handler.erl | ||
| websocket_handler_init_shutdown.erl | ||
| ws_timeout_hibernate_handler.erl | ||