Default Servlet

Spring MVC允许将DispatcherServlet映射到/（从而覆盖容器默认Servlet的映射），同时仍允许容器的默认Servlet处理静态资源请求。它配置一个DefaultServletHttpRequestHandler，其URL映射为**/，并且相对于其他URL映射其优先级最低。

此处理程序将所有请求转发到默认Servlet。因此，它在所有其他URL HandlerMapping中必须保持为最后一个。如果你使用<mvc:annotation-driven>，便是如此。或者，如果你设置自己的定制HandlerMapping实例，请务必将它的order属性设置为低于DefaultServletHttpRequestHandler（即Integer.MAX_VALUE）的值。

以下示例显示如何使用默认设置启用此功能：

  • Java

  • Kotlin

  • Xml

@Configuration
public class WebConfiguration implements WebMvcConfigurer {

	@Override
	public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
		configurer.enable();
	}
}
@Configuration
class WebConfiguration : WebMvcConfigurer {

	override fun configureDefaultServletHandling(configurer: DefaultServletHandlerConfigurer) {
		configurer.enable()
	}
}
<mvc:default-servlet-handler/>

覆盖/Servlet映射唯一的注意事项是，必须按名称而不是按路径检索默认Servlet的RequestDispatcher。DefaultServletHttpRequestHandler尝试在启动时间自动检测容器的默认Servlet，使用已知的大多数主要Servlet容器（包括Tomcat、Jetty、GlassFish、JBoss、Resin、WebLogic和WebSphere）的名称列表。如果默认Servlet已使用其他名称自定义配置，或者使用的是默认Servlet名称未知的不同Servlet容器，那么你必须明确提供默认Servlet的名称，如下例所示：

  • Java

  • Kotlin

  • Xml

@Configuration
public class CustomDefaultServletConfiguration implements WebMvcConfigurer {

	@Override
	public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
		configurer.enable("myCustomDefaultServlet");
	}
}
@Configuration
class CustomDefaultServletConfiguration : WebMvcConfigurer {

	override fun configureDefaultServletHandling(configurer: DefaultServletHandlerConfigurer) {
		configurer.enable("myCustomDefaultServlet")
	}
}
<mvc:default-servlet-handler default-servlet-name="myCustomDefaultServlet"/>