DispatcherServlet
Spring MVC,与许多其他 Web 框架一样,是围绕前端控制器模式设计的,其中一个中央Servlet
(DispatcherServlet
)提供了一个用于请求处理的共享算法,而实际工作则由可配置的委托组件执行。此模型灵活且支持各种工作流。
DispatcherServlet
,作为任何Servlet
,都需要根据 Servlet 规范使用 Java 配置或在web.xml
中进行声明和映射。反过来,DispatcherServlet
使用 Spring 配置来发现它需要的委托组件,用于请求映射、视图解析、异常处理等等。
以下 Java 配置示例注册并初始化DispatcherServlet
,该 Servlet 会被 Servlet 容器自动检测(请参阅Servlet 配置)
-
Java
-
Kotlin
public class MyWebApplicationInitializer implements WebApplicationInitializer {
@Override
public void onStartup(ServletContext servletContext) {
// Load Spring web application configuration
AnnotationConfigWebApplicationContext context = new AnnotationConfigWebApplicationContext();
context.register(AppConfig.class);
// Create and register the DispatcherServlet
DispatcherServlet servlet = new DispatcherServlet(context);
ServletRegistration.Dynamic registration = servletContext.addServlet("app", servlet);
registration.setLoadOnStartup(1);
registration.addMapping("/app/*");
}
}
class MyWebApplicationInitializer : WebApplicationInitializer {
override fun onStartup(servletContext: ServletContext) {
// Load Spring web application configuration
val context = AnnotationConfigWebApplicationContext()
context.register(AppConfig::class.java)
// Create and register the DispatcherServlet
val servlet = DispatcherServlet(context)
val registration = servletContext.addServlet("app", servlet)
registration.setLoadOnStartup(1)
registration.addMapping("/app/*")
}
}
除了直接使用 ServletContext API 外,您还可以扩展AbstractAnnotationConfigDispatcherServletInitializer 并覆盖特定方法(请参阅上下文层次结构下的示例)。 |
对于编程用例,GenericWebApplicationContext 可以用作AnnotationConfigWebApplicationContext 的替代方案。有关详细信息,请参阅GenericWebApplicationContext javadoc。 |
以下web.xml
配置示例注册并初始化DispatcherServlet
<web-app>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/app-context.xml</param-value>
</context-param>
<servlet>
<servlet-name>app</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value></param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>app</servlet-name>
<url-pattern>/app/*</url-pattern>
</servlet-mapping>
</web-app>
Spring Boot 遵循不同的初始化顺序。Spring Boot 不会挂接到 Servlet 容器的生命周期中,而是使用 Spring 配置来引导自身和嵌入式 Servlet 容器。Filter 和Servlet 声明在 Spring 配置中被检测到,并向 Servlet 容器注册。有关更多详细信息,请参阅Spring Boot 文档。 |