aboutsummaryrefslogtreecommitdiffstats
path: root/Makefile
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2011-10-10 17:27:52 +0200
committerLoïc Hoguin <[email protected]>2011-10-10 17:27:52 +0200
commit5e006be01fb9af2cbb6b62bec695a2c160733cf4 (patch)
tree3e8cac6cd23f0db2024aad3d4d6758d2ac6860e7 /Makefile
parent25ae2028d6a9ce516b01f0ec126abeab00eb329d (diff)
downloadcowboy-5e006be01fb9af2cbb6b62bec695a2c160733cf4.tar.gz
cowboy-5e006be01fb9af2cbb6b62bec695a2c160733cf4.tar.bz2
cowboy-5e006be01fb9af2cbb6b62bec695a2c160733cf4.zip
Add support for loops in standard HTTP handlers
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.
Diffstat (limited to 'Makefile')
0 files changed, 0 insertions, 0 deletions