raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 10

Merge pull request #18893 from johanandren/wip-18471-metadata-plus-file-upload-johanandren

Browse source 
=doc WIP #18471 examples for file uploads
This commit is contained in:
Konrad Malawski 2015-11-18 14:33:10 +01:00
commit 00a7ecd1f0
2 changed files with 118 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

22
akka-docs-dev/rst/scala/http/routing-dsl/index.rst
View file

@ -74,3 +74,25 @@ Failures and exceptions inside the Routing DSL
Exception handling within the Routing DSL is done by providing :class:`ExceptionHandler` s which are documented in-depth
in the :ref:`exception-handling-scala` section of the documtnation. You can use them to transform exceptions into
:class:`HttpResponse` s with apropriate error codes and human-readable failure descriptions.
File uploads
^^^^^^^^^^^^
Handling a simple file upload from for example a browser form with a `file` input can be done
by accepting a `Multipart.FormData` entity, note that the body parts are `Source` rather than
all available right away, and so is the individual body part payload so you will need to consume
those streams both for the file and for the form fields.
Here is a simple example which just dumps the uploaded file into a temporary file on disk, collects
some form fields and saves an entry to a fictive database:
.. includecode2:: ../../code/docs/http/scaladsl/server/FileUploadExamplesSpec.scala
:snippet: simple-upload
You can transform the uploaded files as they arrive rather than storing then in a temporary file as
in the previous example. In this example we accept any number of ``.csv`` files, parse those into lines
and split each line before we send it to an actor for further processing:
.. includecode2:: ../../code/docs/http/scaladsl/server/FileUploadExamplesSpec.scala
:snippet: stream-csv-upload