From 51b43496f41c6fd5745e88b0edcba53a88e4bb84 Mon Sep 17 00:00:00 2001 From: Rossen Stoyanchev Date: Mon, 11 Nov 2019 14:31:36 +0000 Subject: [PATCH] Update docs for ASYNC dispatch config Closes gh-23958 --- src/docs/asciidoc/web/webmvc.adoc | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/src/docs/asciidoc/web/webmvc.adoc b/src/docs/asciidoc/web/webmvc.adoc index 375d5a4dfd0..59fbbc2dbb1 100644 --- a/src/docs/asciidoc/web/webmvc.adoc +++ b/src/docs/asciidoc/web/webmvc.adoc @@ -1292,6 +1292,14 @@ a proxy at the boundary of trust should be configured to remove untrusted `Forwa headers that come from the outside. You can also configure the `ForwardedHeaderFilter` with `removeOnly=true`, in which case it removes but does not use the headers. +In order to support <> this filter must be mapped +with `DispatcherType.ASYNC` so that the filter can delay and successfully generate the an +ETag to the end of the last async dispatch. If using Spring Framework's +`AbstractAnnotationConfigDispatcherServletInitializer` (see <>) +all filters are automatically registered for all dispatch types. However if registering +the filter via web.xml or in Spring Boot via a `FilterRegistrationBean` be sure to include +`DispatcherType.ASYNC`. + [[filters-shallow-etag]] @@ -1310,6 +1318,14 @@ This filter has a `writeWeakETag` parameter that configures the filter to write similar to the following: `W/"02a2d595e6ed9a0b24f027f2b63b134d6"` (as defined in https://tools.ietf.org/html/rfc7232#section-2.3[RFC 7232 Section 2.3]). +In order to support <> this filter must be mapped +with `DispatcherType.ASYNC` so that the filter can delay and successfully generate the an +ETag to the end of the last async dispatch. If using Spring Framework's +`AbstractAnnotationConfigDispatcherServletInitializer` (see <>) +all filters are automatically registered for all dispatch types. However if registering +the filter via web.xml or in Spring Boot via a `FilterRegistrationBean` be sure to include +`DispatcherType.ASYNC`. + [[filters-cors]]