前言
在 Servlet 3.0 标准之前,配置Spring MVC 要在 web.xml 中配置 前端控制器DispatcherServlet
、Web容器启动监听器ContextLoaderListener
。配置的东西倒是不多,但是由于 XML 文件的特性,即使是简单的配置上述两项也会有一大堆的 XML 节点要写,例如下面这样
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<!--配置Spring IOC容器的启动监听器-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring/springApplication.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!--配置Spring MVC的前端控制器-->
<servlet>
<servlet-name>SpringMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>SpringMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
本来记住几个类名还不太难,可是要记住这么多XML节点,就有点费劲了。
Servlet 3.0 (及以上版本)
自从 Servlet 3.0 问世之后,我们可以通过 Java 的方式配置 Servlet 容器了,摆脱了繁琐的 XML 文件,瞬间起飞~~ 芜湖!!!
使用 Java 配置的原理
所有实现了 Servlet3.0 的 Web 容器,都会在 jar/war 包下面搜索一个文件,这个文件的名字必须叫 javax.servlet.ServletContainerInitializer ,而且必须放在 jar/war 包的类路径下面的 META-INF/services 文件夹里面。这个文件的内容也非常简单,是某个实现了 javax.servlet.ServletContainerInitializer
接口的实现类的全限定类名。
(PS : 在 IDEA 中,蓝色的文件夹就代表项目的类路径。)
现在看一下这个类的实现
@HandlesTypes(Color.class)
public class MyServletContainerInit implements ServletContainerInitializer {
/**
* Servlet 容器启动时调用该方法
* @param set 上面的 @HandlersTypes 注解中 classes 方法指明的接口/抽象类的所有子类
* @param servletContext Application 作用域,可以用来注册 Servlet 、Listener、Filter
* @throws ServletException
*/
@Override
public void onStartup(Set<Class<?>> set, ServletContext servletContext) throws ServletException {
// 注册 servlet
ServletRegistration.Dynamic userServlet = servletContext.addServlet