SpringMVC处理静态文件源码分析

时间 2019-11-07

原文原文链接

SpringMVC处理静态资源，主要是两个标签，mvc:resources和mvc:default-servlet-handler。在详细说明他们的原理以前，须要先简单说明下SpringMVC中请求处理机制：HandlerMapping和HandlerAdapter。css

#1 HandlerMapping和HandlerAdapter的来由html

用过python Django框架的都知道Django对于访问方式的配置就是，一个url路径和一个函数配对，你访问这个url，就会直接调用这个函数，简单明了java

然而对于SpringMVC框架来讲，因为java的面向对象,就要找到对应的类以及对应的方法，因此就须要分红2步走python

第一步先找到url对应的处理类，叫handler,这里就用到HandlerMapping来寻找web
第二步找到了对应的handler以后，咱们该调用这个handler的哪一个方法呢？这就须要HandlerAdapter来决定spring

#2 经常使用的HandlerMapping和HandlerAdapter简单介绍tomcat

##2.1 HandlerMapping接口设计和实现mvc

public interface HandlerMapping {
	HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception;
}

根据request请求，找到对应的HandlerExecutionChain，HandlerExecutionChain是handler和拦截器的结合。以下：app

public class HandlerExecutionChain {
	private final Object handler;
	private List<HandlerInterceptor> interceptorList;
}

即针对某个请求，会有对应的handler和拦截器来处理。HandlerMapping仅仅是找到对应的handler和拦截器罢了，它并不限制handler的类型，任何一个存在于Spring的IOC容器中的bean均可以成为handler，因此这个handler是Object。框架

下面来看下常见的几个HandlerMapping实现：

BeanNameUrlHandlerMapping ：对url直接配置一个bean做为这个url的handler。如在xml中以下配置
```
<bean name="/index" class="com.lg.mvc.HomeAction"></bean>
```
当咱们访问 http://localhost:8080/index 时，就直接找到这个bean做为handler。

SimpleUrlHandlerMapping ：上述只能配置一个url对应的bean，SimpleUrlHandlerMapping就能够配置多个，功能上更强大，它内部有一个Map<String, Object> urlMap，存放着各个url对应的handler，以下

<bean id="handler1" class="XXXX"/>
<bean id="handler2" class="XXXXX"/>
<bean id="handlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
	 <property name="urlMap">
         <map>
            <entry key="/user/login.do" value-ref="handler1"/>
			<entry key="/admin/admin.do" value-ref="handler2"/>
         </map>
     </property>
</bean>

##2.2 HandlerAdapter接口设计和实现

public interface HandlerAdapter {
	boolean supports(Object handler);
	ModelAndView handle(HttpServletRequest request, HttpServletResponse response,
			 Object handler) throws Exception;
}

根据HandlerMapping找到了handler以后，咱们该调用handler的哪一个方法呢？handler又有哪些方法呢？这里就须要采用适配器的模式，对不一样的handler进行不一样的处理。所以HandlerAdapter的supports方法首先判断这个handler是不是我能支持的，若是能支持，那我就按照个人处理模式来处理，即调用上述的handle方法。

下面来看下常见的几个HandlerAdapter的实现：

SimpleServletHandlerAdapter ：它支持的handler必须是Servlet，这样的话该handler就必然有service(request, response)方法，因此就会调用handler的service(request, response)方法来处理请求，源码以下

public class SimpleServletHandlerAdapter implements HandlerAdapter {
	@Override
	public boolean supports(Object handler) {
		return (handler instanceof Servlet);
	}
	@Override
	public ModelAndView handle(HttpServletRequest request, HttpServletResponse response
			, Object handler)throws Exception {
		((Servlet) handler).service(request, response);
		return null;
	}
}

SimpleControllerHandlerAdapter ：它支持的handler必须是Controller，Controller接口定义了一个ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response)方法，因此咱们知道该handler必然有一个handleRequest方法，就调用它来处理请求，源码以下

public class SimpleControllerHandlerAdapter implements HandlerAdapter {
	@Override
	public boolean supports(Object handler) {
		return (handler instanceof Controller);
	}
	@Override
	public ModelAndView handle(HttpServletRequest request, HttpServletResponse response
			, Object handler)throws Exception {
		return ((Controller) handler).handleRequest(request, response);
	}
}

HttpRequestHandlerAdapter ：它支持的handler必须是HttpRequestHandler，HttpRequestHandler接口定义了一个void handleRequest(HttpServletRequest request, HttpServletResponse response)方法，因此就知道该调用这个handler的handleRequest方法，源码以下：

public class HttpRequestHandlerAdapter implements HandlerAdapter {
	@Override
	public boolean supports(Object handler) {
		return (handler instanceof HttpRequestHandler);
	}
	@Override
	public ModelAndView handle(HttpServletRequest request, HttpServletResponse response
			, Object handler)throws Exception {
		((HttpRequestHandler) handler).handleRequest(request, response);
		return null;
	}
}

以上的几个HandlerMapping和HandlerAdapter属于SpringMVC最初的设计思路。即HandlerMapping和HandlerAdapter毫无关系，HandlerMapping只负责找到对应的handler，HandlerAdapter负责找到handler的哪一个方法。然而随着注解的兴起，即@RequestMapping注解直接标注请求对应某个类的某个方法，使得后来的HandlerMapping和HandlerAdapter即 DefaultAnnotationHandlerMapping、AnnotationMethodHandlerAdapter 、RequestMappingHandlerMapping 、RequestMappingHandlerAdapter（前二者已被后二者取代）再也不像以前的思路那样，开始争夺权力了，RequestMappingHandlerMapping 在寻找对应的handler时，不只要匹配到对应的handler，还要找到对应的方法。它们具体详细的内容，能够参考个人以前的博客 mvc:annotation-driven以及@Controller和@RequestMapping的那些事

接下来就轮到重点了（上面的铺垫够长的了，哈哈） #3 mvc:resources源码分析

来看下通常的mvc:resources的使用，以下：

<mvc:resources location="/WEB-INF/views/css/**" mapping="/css/**"/>

而后来看源码。首先要再次声明下，全部在xml中配置的标签，都会有对应的BeanDefinitionParser的实现类来进行处理，对于mvc:resources标签，对应的实现类是ResourcesBeanDefinitionParser，查看其中的源码（这里再也不列出，自行去查看），能够知道

注册了一个SimpleUrlHandlerMapping（上文已提到）。它是拥有一个Map<String, Object> urlMap的，它把mvc:resources标签中的mapping属性做为key,把ResourceHttpRequestHandler做为handler。即/css/**相似的url请求，会由这个SimpleUrlHandlerMapping匹配到ResourceHttpRequestHandler上。

再看下，到底调用ResourceHttpRequestHandler的哪一个方法来处理请求呢？

ResourceHttpRequestHandler实现了HttpRequestHandler，便是上文提到的HttpRequestHandlerAdapter支持的handler类型，因此就会调用ResourceHttpRequestHandler的void handleRequest(HttpServletRequest request, HttpServletResponse response)方法

其实很容易就明白了，ResourceHttpRequestHandler会根据mvc:resources标签中的location属性做为目录，去寻找对应的资源，而后返回资源的内容。这里就再也不详细说明了，能够自行查看ResourceHttpRequestHandler的所实现的handleRequest方法。

#4 mvc:default-servlet-handler 源码分析

同理，mvc:default-servlet-handler标签对应的BeanDefinitionParser的实现类是DefaultServletHandlerBeanDefinitionParser。

这里注册了SimpleUrlHandlerMapping，它的Map<String, Object> urlMap中存放了一个 key为/** ，对应的handler为DefaultServletHttpRequestHandler。即请求路径匹配 /* * 的时候，这个SimpleUrlHandlerMapping会交给DefaultServletHttpRequestHandler来处理。这种状况通常是其余HandlerMapping没法匹配处理，最后才无奈交给DefaultServletHttpRequestHandler。

来看下DefaultServletHttpRequestHandler是怎么处理的：

它一样实现了HttpRequestHandler接口，拥有void handleRequest(HttpServletRequest request, HttpServletResponse response)方法，以下：

@Override
public void handleRequest(HttpServletRequest request, HttpServletResponse response)
		throws ServletException, IOException {

	RequestDispatcher rd = this.servletContext.getNamedDispatcher(this.defaultServletName);
	if (rd == null) {
		throw new IllegalStateException("A RequestDispatcher could not be located for the default servlet '" +
				this.defaultServletName +"'");
	}
	rd.forward(request, response);
}

咱们能够看到，这里其实就是转发给了web容器自身的servlet。这个servlet名称能够在mvc:default-servlet-handler标签中进行配置，若是没有配置，采用默认的配置，以下：

/** Default Servlet name used by Tomcat, Jetty, JBoss, and GlassFish */
private static final String COMMON_DEFAULT_SERVLET_NAME = "default";

/** Default Servlet name used by Google App Engine */
private static final String GAE_DEFAULT_SERVLET_NAME = "_ah_default";

/** Default Servlet name used by Resin */
private static final String RESIN_DEFAULT_SERVLET_NAME = "resin-file";

/** Default Servlet name used by WebLogic */
private static final String WEBLOGIC_DEFAULT_SERVLET_NAME = "FileServlet";

/** Default Servlet name used by WebSphere */
private static final String WEBSPHERE_DEFAULT_SERVLET_NAME = "SimpleFileServlet";

即tomcat、Jetty等，在容器启动的时候，自身就默认注册了一个name叫default的servlet，能够从个人上一篇文章进行了解tomcat的url-pattern的源码分析。DefaultServletHttpRequestHandler就是转发给这些servlet。

其实这个时候，请求先通过tomcat的servlet的url-pattern的匹配，进入到了SpringMVC,而后通过SpringMVC的HandlerMapping的一系列匹配，没有对应的handler匹配，致使又再次转发给tomcat等默认的servlet上了，绕了很大的弯，因此要尽可能避免这样的操做。

#5 结合tomcat的url-pattern来综合案例

这里举一个案例进行分析，在tomcat发布的根目录中，有一个a.html和a.jsp文件，以及一个SpringMVC项目，以下：

其中SpringMVC项目配置了mvc:default-servlet-handler标签，接下来以SpringMVC的DispatcherServlet的两种配置进行说明，分别是

/ 和 /* 两种方式

结果分别是：

DispatcherServlet配置为 / 的时候，a.html和a.jsp均可以正常访问到，以下
DispatcherServlet配置为 /* 的时候,a.html能够正常访问到，a.jsp就不行了，以下

分析以下：

咱们知道 /* 的优先级大于 .jsp的优先级，.jsp的优先级大于 / （能够由个人上一篇文章了解到tomcat的url-pattern的源码分析），在这个前提下

访问a.html时：

当DispatcherServlet配置为 / 的时候，tomcat仍会选择SpringMVC的DispatcherServlet来处理a.html-》它也处理不了，交给默认配置的mvc:default-servlet-handler来处理-》转发到tomcat默认的servlet的，即DefaultServlet来处理-》DefaultServlet去寻找有没有该文件，找到了，返回文件内容
当DispatcherServlet配置为 /* 的时候，tomcat仍然是选择SpringMVC的DispatcherServlet来处理a.html，同上面是同样的过程

访问a.jsp时：

当DispatcherServlet配置为 / 的时候，tomcat会优先选择本身已经默认注册的JspServlet来处理-》JspServlet翻译文件内容，返回
当DispatcherServlet配置为 /* 的时候，tomcat会选择SpringMVC的DispatcherServlet来处理a.jsp-》发现SpringMVC找不到匹配的handler，交给配置的mvc:default-servlet-handler来处理-》转发到tomcat默认的servlet的，即DefaultServlet来处理-》DefaultServlet仅仅将a.jsp的源码内容进行返回