Skip to content

Commit c441baf

Browse files
ionascustefancipriansnicoll
authored andcommitted
Document the DefaultServlet is no longer being enabled by default
See gh-32004
1 parent 22a5ccf commit c441baf

File tree

1 file changed

+11
-1
lines changed
  • spring-boot-project/spring-boot-docs/src/docs/asciidoc/web

1 file changed

+11
-1
lines changed

spring-boot-project/spring-boot-docs/src/docs/asciidoc/web/servlet.adoc

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,17 @@ If you set the configprop:spring.mvc.message-codes-resolver-format[] property `P
127127
By default, Spring Boot serves static content from a directory called `/static` (or `/public` or `/resources` or `/META-INF/resources`) in the classpath or from the root of the `ServletContext`.
128128
It uses the `ResourceHttpRequestHandler` from Spring MVC so that you can modify that behavior by adding your own `WebMvcConfigurer` and overriding the `addResourceHandlers` method.
129129

130-
In a stand-alone web application, the default servlet from the container is also enabled and acts as a fallback, serving content from the root of the `ServletContext` if Spring decides not to handle it.
130+
In a stand-alone web application, default servlet is not enabled. It can be enabled as follows:
131+
132+
133+
[source,yaml,indent=0,subs="verbatim",configprops,configblocks]
134+
----
135+
server:
136+
servlet:
137+
register-default-servlet: true
138+
----
139+
140+
If the default servlet is enablend it acts as a fallback, serving content from the root of the `ServletContext` if Spring decides not to handle it.
131141
Most of the time, this does not happen (unless you modify the default MVC configuration), because Spring can always handle requests through the `DispatcherServlet`.
132142

133143
By default, resources are mapped on `+/**+`, but you can tune that with the configprop:spring.mvc.static-path-pattern[] property.

0 commit comments

Comments
 (0)