Spring/spring-framework
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update docs for ASYNC dispatch config

Browse Source 
Closes gh-23958
This commit is contained in:
Rossen Stoyanchev
2019-11-11 14:31:36 +00:00
parent d03ab79531
commit 51b43496f4
1 changed files with 16 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
src/docs/asciidoc/web/webmvc.adoc
View File

@@ -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 <<mvc-ann-async,asynchronous requests>> 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 <<mvc-container-config>>)
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 <<mvc-ann-async,asynchronous requests>> 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 <<mvc-container-config>>)
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]]