Spring MVC 和其他许多 Web 框架一样,是围绕前台控制器(front controller)模式设计的,其中一个 中央 Servlet,即 DispatcherServlet,为请求处理提供了一个共享算法,而实际工作则由可配置的委托组件执行。这种模式很灵活,支持不同的工作流程。
DispatcherServlet 和其他 Servlet 一样,需要通过使用 Java 配置或在 web.xml 中根据 Servlet 规范进行声明和映射。反过来,DispatcherServlet 使用 Spring 配置来发现它在请求映射、视图解析、异常处理等方面需要的委托组件。
下面这个 Java 配置(这种方式可以配合内嵌 tomcat 实现 SpringBoot 那种方式启动)的例子注册并初始化了 DispatcherServlet,它是由 Servlet 容器自动检测出来的(见 Servlet 配置):
public class MyWebApplicationInitializer implements WebApplicationInitializer {@Overridepublic void onStartup(ServletContext servletContext) {// 加载 Spring web application configurationAnnotationConfigWebApplicationContext context = new AnnotationConfigWebApplicationContext();context.register(AppConfig.class);// 创建和注册 DispatcherServletDispatcherServlet servlet = new DispatcherServlet(context);ServletRegistration.Dynamic registration = servletContext.addServlet("app", servlet);registration.setLoadOnStartup(1);registration.addMapping("/app/*");}}
:::info 除了直接使用 ServletContext API 外,你还可以扩展 AbstractAnnotationConfigDispatcherServletInitializer 并覆盖特定的方法(见 Context Hierarchy 下的例子)。 :::
以下是 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>
:::info Spring Boot 遵循不同的初始化顺序。Spring Boot 不是挂入 Servlet 容器的生命周期,而是使用 Spring 配置来启动自己和嵌入式 Servlet 容器。过滤器和 Servlet 声明在 Spring 配置中被检测到,并在 Servlet 容器中注册。更多细节请参见 Spring Boot 文档。 :::
