0
Fork 0
mirror of https://github.com/ninenines/cowboy.git synced 2025-07-16 05:00:24 +00:00

Add sendfile support to cowboy_req:stream_body

It is now possible to stream one or more sendfile tuples.
A simple example of what can now be done would be for
example to build a tar file on the fly using the sendfile
syscall for sending the files, or to support Range requests
with more than one range with the sendfile syscall.

When using cowboy_compress_h unfortunately we have to read
the file in order to send it. More options will be added
at a later time to make sure users don't read too much
into memory. This is a new feature however so existing
code is not affected.

Also rework cowboy_http's data sending to be flatter.
This commit is contained in:
Loïc Hoguin 2018-11-09 17:42:37 +01:00
parent 29043aa7b4
commit d7b7580b39
No known key found for this signature in database
GPG key ID: 8A9DF795F6FED764
12 changed files with 219 additions and 100 deletions

View file

@ -10,7 +10,7 @@ cowboy_req:stream_body - Stream the response body
----
stream_body(Data, IsFin, Req :: cowboy_req:req()) -> ok
Data :: iodata()
Data :: cowboy_req:resp_body()
IsFin :: fin | nofin
----
@ -58,6 +58,7 @@ The atom `ok` is always returned. It can be safely ignored.
== Changelog
* *2.6*: The `Data` argument can now be a sendfile tuple.
* *2.0*: Function introduced. Replaces `chunk/2`.
== Examples

View file

@ -133,7 +133,7 @@ Send data to the client.
[source,erlang]
----
{data, fin(), iodata()}
{data, fin(), cowboy_req:resp_body()}
----
[[trailers_command]]
@ -420,6 +420,7 @@ tuple.
== Changelog
* *2.6*: The data command can now contain a sendfile tuple.
* *2.6*: The `{stop, {exit, any()}, HumanReadable}` terminate reason was added.
* *2.2*: The trailers command was introduced.
* *2.0*: Module introduced.