Spring/spring-boot
Spring/spring-boot
1
0
Fork 0
mirror of https://github.com/spring-projects/spring-boot.git synced 2024-07-15 01:07:30 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add warning when downgrading to Servlet 5.0 to docs

Browse Source 
Closes gh-33044
This commit is contained in:
Moritz Halbritter 2023-10-27 13:28:10 +02:00
parent b4721c9d62
commit 8a27326ba6
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/webserver.adoc
View File

@ -43,6 +43,18 @@ The following Maven example shows how to exclude Tomcat and include Jetty for Sp
NOTE: The version of the Jakarta Servlet API has been overridden as, unlike Tomcat 10 and Undertow 2.3, Jetty 11 does not support Servlet 6.0.
[WARNING]
====
Downgrading the Servlet API to 5.0 breaks Spring Framework's Servlet-related mocks!
As Jetty needs the Servlet API 5.0, this leaves you with two working arrangements:
* Tests use the Servlet 5.0 API and avoid using Framework's Servlet mocks by only using a full-blown web environment
* Tests use the Servlet 6.0 API and avoid starting Jetty by only using a mock web environment
If a mixture of web environments is required by your application's tests, your test setup may require some structural changes to strictly separate the two web environments.
====
The following Gradle example configures the necessary dependencies and a {gradle-docs}/resolution_rules.html#sec:module_replacement[module replacement] to use Undertow in place of Reactor Netty for Spring WebFlux:
[source,gradle,indent=0,subs="verbatim"]