Skip to content

Commit

Permalink
Correct WebFlux docs on BindingResult with @requestbody
Browse files Browse the repository at this point in the history
Backport of 70a0c93

Closes gh-22997
  • Loading branch information
rstoyanchev committed Dec 13, 2019
1 parent 2576aa4 commit 59e4755
Showing 1 changed file with 17 additions and 25 deletions.
42 changes: 17 additions & 25 deletions src/docs/asciidoc/web/webflux.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -1661,9 +1661,8 @@ and others) and is equivalent to `required=false`.
See "`Any other argument`" later in this table.

| `Errors`, `BindingResult`
| For access to errors from validation and data binding for a command object
(that is, a `@ModelAttribute` argument) or errors from the validation of a `@RequestBody` or
`@RequestPart` argument. An `Errors`, or `BindingResult` argument must be declared
| For access to errors from validation and data binding for a command object, i.e. a
`@ModelAttribute` argument. An `Errors`, or `BindingResult` argument must be declared
immediately after the validated method argument.

| `SessionStatus` + class-level `@SessionAttributes`
Expand Down Expand Up @@ -2318,24 +2317,19 @@ you can declare a concrete target `Object`, instead of `Part`, as the following
<1> Using `@RequestPart` to get the metadata.
====

You can use `@RequestPart` combination with `javax.validation.Valid` or Spring's
`@Validated` annotation, which causes Standard Bean Validation to be applied.
By default, validation errors cause a `WebExchangeBindException`, which is turned
into a 400 (`BAD_REQUEST`) response. Alternatively, you can handle validation errors locally
within the controller through an `Errors` or `BindingResult` argument, as the following example shows:
You can use `@RequestPart` in combination with `javax.validation.Valid` or Spring's
`@Validated` annotation, which causes Standard Bean Validation to be applied. Validation
errors lead to a `WebExchangeBindException` that results in a 400 (BAD_REQUEST) response.
The exception contains a `BindingResult` with the error details and can also be handled
in the controller method by declaring the argument with an async wrapper and then using
error related operators:

====
[source,java,indent=0]
[subs="verbatim,quotes"]
----
@PostMapping("/")
public String handle(@Valid @RequestPart("meta-data") MetaData metadata, <1>
BindingResult result) { <2>
// ...
}
----
<1> Using a `@Valid` annotation.
<2> Using a `BindingResult` argument.
public String handle(@Valid @RequestPart("meta-data") Mono<MetaData> metadata) {
// use one of the onError* operators...
====

To access all multipart data as a `MultiValueMap`, you can use `@RequestBody`,
Expand Down Expand Up @@ -2407,20 +2401,18 @@ You can use the <<webflux-config-message-codecs>> option of the <<webflux-config
configure or customize message readers.

You can use `@RequestBody` in combination with `javax.validation.Valid` or Spring's
`@Validated` annotation, which causes Standard Bean Validation to be applied.
By default, validation errors cause a `WebExchangeBindException`, which is turned
into a 400 (`BAD_REQUEST`) response. Alternatively, you can handle validation errors locally
within the controller through an `Errors` or a `BindingResult` argument. The following
example uses a `BindingResult` argument`:
`@Validated` annotation, which causes Standard Bean Validation to be applied. Validation
errors cause a `WebExchangeBindException`, which results in a 400 (BAD_REQUEST) response.
The exception contains a `BindingResult` with error details and can be handled in the
controller method by declaring the argument with an async wrapper and then using error
related operators:

====
[source,java,indent=0]
[subs="verbatim,quotes"]
----
@PostMapping("/accounts")
public void handle(@Valid @RequestBody Account account, BindingResult result) {
// ...
}
public void handle(@Valid @RequestBody Mono<Account> account) {
// use one of the onError* operators...
----
====

Expand Down

0 comments on commit 59e4755

Please sign in to comment.