ParameterDirectives
When to use which parameter directive?
Usually, you want to use the high-level parameter directive. When you need more low-level access you can use the table below to decide which directive to use which shows properties of different parameter directives.
| directive | level | ordering | multi |
|---|---|---|---|
| parameter | high | no | no |
| parameterMap | low | no | no |
| parameterMultiMap | low | no | yes |
| parameterList | low | yes | yes |
- level
- high-level parameter directives extract subset of all parameters by name and allow conversions and automatically report errors if expectations are not met, low-level directives give you all parameters at once, leaving all further processing to you
- ordering
- original ordering from request URL is preserved
- multi
- multiple values per parameter name are possible
Note
If you need to extract multiple parameters, apply the parameter directive multiple times.