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

+htp extract multiple occurrences in the parameters/formFields directives by suffixing with .*

Browse source
This commit is contained in:
Alek Storm 2015-03-30 10:33:46 -07:00
parent 632868b868
commit d3742c577a
9 changed files with 171 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

9
akka-docs-dev/rst/scala/http/routing-dsl/directives/form-field-directives/formFields.rst
View file

@ -25,7 +25,7 @@ Description
Form fields can be either extracted as a String or can be converted to another type. The parameter name
can be supplied either as a String or as a Symbol. Form field extraction can be modified to mark a field
as required or optional or to filter requests where a form field has a certain value:
as required, optional, or repeated, or to filter requests where a form field has a certain value:
``"color"``
extract value of field "color" as ``String``
@ -40,6 +40,13 @@ as required or optional or to filter requests where a form field has a certain v
(see also :ref:`http-unmarshalling-scala`)
``"amount".as(deserializer)``
extract value of field "amount" with an explicit ``Deserializer``
``"distance".*``
extract multiple occurrences of field "distance" as ``Iterable[String]``
``"distance".as[Int].*``
extract multiple occurrences of field "distance" as ``Iterable[Int]``, you need a matching implicit ``Deserializer`` in scope for that to work
(see also :ref:`unmarshalling`)
``"distance".as(deserializer).*``
extract multiple occurrences of field "distance" with an explicit ``Deserializer``
You can use :ref:`Case Class Extraction` to group several extracted values together into a case-class
instance.

2
akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/index.rst
View file

@ -25,7 +25,7 @@ to use which shows properties of different parameter directives.
directive level ordering multi
========================== ====== ======== =====
:ref:`-parameter-` high no no
:ref:`-parameters-` high no no
:ref:`-parameters-` high no yes
:ref:`-parameterMap-` low no no
:ref:`-parameterMultiMap-` low no yes
:ref:`-parameterSeq-` low yes yes

21
akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameters.rst
View file

@ -24,7 +24,7 @@ Description
-----------
Query parameters can be either extracted as a String or can be converted to another type. The parameter name
can be supplied either as a String or as a Symbol. Parameter extraction can be modified to mark a query parameter
as required or optional or to filter requests where a parameter has a certain value:
as required, optional, or repeated, or to filter requests where a parameter has a certain value:
``"color"``
extract value of parameter "color" as ``String``
@ -39,6 +39,13 @@ as required or optional or to filter requests where a parameter has a certain va
(see also :ref:`http-unmarshalling-scala`)
``"amount".as(deserializer)``
extract value of parameter "amount" with an explicit ``Deserializer``
``"distance".*``
extract multiple occurrences of parameter "distance" as ``Iterable[String]``
``"distance".as[Int].*``
extract multiple occurrences of parameter "distance" as ``Iterable[Int]``, you need a matching ``Deserializer`` in scope for that to work
(see also :ref:`unmarshalling`)
``"distance".as(deserializer).*``
extract multiple occurrences of parameter "distance" with an explicit ``Deserializer``
You can use :ref:`Case Class Extraction` to group several extracted values together into a case-class
instance.
@ -80,3 +87,15 @@ Deserialized parameter
... includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
:snippet: mapped-value
Repeated parameter
+++++++++++++++++++++++++++++
... includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
:snippet: repeated
Repeated, deserialized parameter
++++++++++++++++++++++
... includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
:snippet: mapped-repeated