Spring思维导图，让Spring不再难懂（mvc篇）

写在前面  

生活就像海洋，只有意志坚强的人才能到达彼岸。已经很久没有发文章了呀，想必大家都挂念我了，哈哈。温故而知新，今天一起来复习一下spring mvc的内容吧。 

spring mvc简介与运行原理  

Spring的模型-视图-控制器（MVC）框架是围绕一个DispatcherServlet来设计的，这个Servlet会把请求分发给各个处理器，并支持可配置的处理器映射、视图渲染、本地化、时区与主题渲染等，甚至还能支持文件上传。 

• (1) Http请求：客户端请求提交到DispatcherServlet。
• (2) 寻找处理器：由DispatcherServlet控制器查询一个或多个HandlerMapping，找到处理请求的Controller。
• (3) 调用处理器：DispatcherServlet将请求提交到Controller。
• (4)(5)调用业务处理和返回结果：Controller调用业务逻辑处理后，返回ModelAndView。
• (6)(7)处理视图映射并返回模型： DispatcherServlet查询一个或多个ViewResoler视图解析器，找到ModelAndView指定的视图。
• (8) Http响应：视图负责将结果显示到客户端。

主要注解  

ContextLoaderListener  

在讲ContextLoaderListener之前，首先来了解一下web.xml的作用。 

• 一个web中可以没有web.xml文件，也就是说，web.xml文件并不是web工程必须的。web.xml文件是用来初始化配置信息：比如Welcome页面、servlet、servlet-mapping、filter、listener、启动加载级别等。当你的web工程没用到这些时，你可以不用web.xml文件来配置你的Application。
• 当要启动某个web项目时，服务器软件或容器如（tomcat）会第一步加载项目中的web.xml文件，通过其中的各种配置来启动项目，只有其中配置的各项均无误时，项目才能正确启动。web.xml有多项标签，在其加载的过程中顺序依次为：context-param >> listener >> fileter >> servlet。（同类多个节点以出现顺序依次加载)

而spring mvc启动过程大致分为两个过程： 

• ContextLoaderListener初始化，实例化IoC容器，并将此容器实例注册到ServletContext中。
• DispatcherServlet初始化。

其中ContextLoaderListener监听器它实现了ServletContextListener这个接口，在web.xml配置这个监听器，启动容器时，就会默认执行它实现的方法。在ContextLoaderListener中关联了ContextLoader这个类，所以整个加载配置过程由ContextLoader来完成。 

ContextLoaderListener在web.xml中的配置 

Java代码

1. <!-- 配置contextConfigLocation初始化参数 -->  
2.   
3. <context-param>  
4.     <param-name>contextConfigLocation</param-name>  
5.   
6.     <param-value>/WEB-INF/applicationContext.xml</param-value>  
7.   
8. </context-param>  
9.   
10. <!-- 配置ContextLoaderListerner -->  
11.   
12. <listener>  
13.   
14.         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
15.   
16. </listener>  

ServletContextListener 接口有两个方法:contextInitialized,contextDestroyed 

DispatcherServlet  

Spring MVC框架，与其他很多web的MVC框架一样：请求驱动；所有设计都围绕着一个中央Servlet来展开，它负责把所有请求分发到控制器；同时提供其他web应用开发所需要的功能。不过Spring的中央处理器，DispatcherServlet，能做的比这更多。 

下图展示了Spring Web MVC的DispatcherServlet处理请求的工作流。熟悉设计模式的朋友会发现，DispatcherServlet应用的其实就是一个“前端控制器”的设计模式（其他很多优秀的web框架也都使用了这个设计模式）。 

流程图  

spring mvc处理请求的流程.jpg

在web.xml中的配置  

Java代码

1. <!-- servlet定义 -->  
2.   
3. <servlet>  
4.     <servlet-name>dispatcher</servlet-name>  
5.     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
6.   
7.     <load-on-startup>1</load-on-startup>  
8.   
9. </servlet>  
10.   
11. <servlet-mapping>  
12.     <servlet-name>dispatcher</servlet-name>  
13.   
14.     <url-pattern>/</url-pattern>  
15.   
16. </servlet-mapping>  

其中 

• load-on-startup：表示启动容器时初始化该Servlet；
• url-pattern：表示哪些请求交给Spring Web MVC处理， “/” 是用来定义默认servlet映射的。也可以如“*.html”表示拦截所有以html为扩展名的请求。

在Spring MVC中，每个DispatcherServlet都持有一个自己的上下文对象WebApplicationContext，它又继承了根（root）WebApplicationContext对象中已经定义的所有bean。这些继承的bean可以在具体的Servlet实例中被重载，在每个Servlet实例中你也可以定义其scope下的新bean。 

WebApplicationContext继承自ApplicationContext，它提供了一些web应用经常需要用到的特性。它与普通的ApplicationContext不同的地方在于，它支持主题的解析，并且知道它关联到的是哪个servlet（它持有一个该ServletContext的引用） 

spring mvc同时提供了很多特殊的注解，用于处理请求和渲染视图等。DispatcherServlet初始化的过程中会默认使用这些特殊bean进行配置。如果你想指定使用哪个特定的bean，你可以在web应用上下文WebApplicationContext中简单地配置它们。 

其中，常用的ViewResolver的配置。以jsp作为视图为例 

Java代码

1. <!-- 对模型视图名称的解析,即在模型视图名称添加前后缀 -->  
2.   
3. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
4.     <property name="prefix" value="/WEB-INF/jsp/" />  
5.   
6.     <property name="suffix" value=".jsp" />  
7.   
8. </bean>  

配置上传文件限制MultipartResolver 

Java代码

1. <!-- 上传限制 -->  
2.   
3. <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">  
4.      <!-- 上传文件大小限制为31M，31*1024*1024 -->  
5.   
6.      <property name="maxUploadSize" value="32505856"/>  
7.   
8. </bean>  

applicationContext.xml中的标签  

文件上传  

前面说到DispatcherServlet中有个特殊的Bean叫MultipartResolver，可用于限制文件的上传大小等。当解析器MultipartResolver完成处理时，请求便会像其他请求一样被正常流程处理。 

表单  

Java代码

1. <form method="post" action="/form" enctype="multipart/form-data">  
2.      <input type="text" name="name"/>  
3.      <input type="file" name="file"/>  
4.      <input type="submit"/>  
5. </form>  

控制器  

Java代码

1. @RequestMapping(path = "/form", method = RequestMethod.POST) public String handleFormUpload(@RequestParam("name") String name,   
2.   
3.             @RequestParam("file") MultipartFile file) {  
4.   
5.    if (!file.isEmpty()) {  
6.   
7.           byte[] bytes = file.getBytes();  
8.   
9.           // store the bytes somewhere  
10.           return "redirect:uploadSuccess";  
11.   
12.     }  
13.   
14.     return "redirect:uploadFailure";  
15. }  

异常处理  

先来说下常见的异常处理有几种方式，如下图： 

Spring的处理器异常解析器HandlerExceptionResolver接口的实现负责处理各类控制器执行过程中出现的异常。也是上面提到的，是DispatcherServlet中的特殊bean，可以自定义配置处理。 

某种程度上讲，HandlerExceptionResolver与你在web应用描述符web.xml文件中能定义的异常映射（exception mapping）很相像，不过它比后者提供了更灵活的方式。比如它能提供异常被抛出时正在执行的是哪个处理器这样的信息。 

HandlerExceptionResolver 提供resolveException接口 

Java代码

1. public interface HandlerExceptionResolver {    
2.     ModelAndView resolveException(    
3.             HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex);    
4. }  

在BaseController中使用 @ExceptionHandler注解处理异常 

Java代码

1. @ExceptionHandler(Exception.class)  
2. public Object exceptionHandler(Exception ex, HttpServletResponse response,   
3.           HttpServletRequest request) throws IOException {  
4.     String url = "";  
5.     String msg = ex.getMessage();  
6.     Object resultModel = null;  
7.     try {  
8.         if (ex.getClass() == HttpRequestMethodNotSupportedException.class) {  
9.             url = "admin/common/500";  
10.             System.out.println("--------毛有找到对应方法---------");  
11.         } else if (ex.getClass() == ParameterException.class) {//自定义的异常  
12.   
13.         } else if (ex.getClass() == UnauthorizedException.class) {  
14.             url = "admin/common/unauth";  
15.             System.out.println("--------毛有权限---------");  
16.         }  
17.   
18.         String header = req.getHeader("X-Requested-With");  
19.         boolean isAjax = "XMLHttpRequest".equalsIgnoreCase(header);  
20.         String method = req.getMethod();  
21.         boolean isPost = "POST".equalsIgnoreCase(method);  
22.   
23.         if (isAjax || isPost) {  
24.             return Message.error(msg);  
25.         } else {  
26.             ModelAndView view = new ModelAndView(url);  
27.             view.addObject("error", msg);  
28.             view.addObject("class", ex.getClass());  
29.             view.addObject("method", request.getRequestURI());  
30.             return view;  
31.         }  
32.     } catch (Exception exception) {  
33.         logger.error(exception.getMessage(), exception);  
34.         return resultModel;  
35.     } finally {  
36.         logger.error(msg, ex);  
37.         ex.printStackTrace();  
38.     }  
39. }  

在web.xml中处理异常  

Java代码

1. <!-- 默认的错误处理页面 -->  
2.   
3. <error-page>  
4.     <error-code>403</error-code>  
5.   
6.     <location>/403.html</location>  
7.   
8. </error-page>  
9.   
10. <error-page>  
11.     <error-code>404</error-code>  
12.   
13.     <location>/404.html</location>  
14.   
15. </error-page>  
16.   
17. <!-- 仅仅在调试的时候注视掉,在正式部署的时候不能注释 --><!-- 这样配置也是可以的，表示发生500错误的时候，转到500.jsp页面处理。 -->  
18.   
19. <error-page>   
20.     <error-code>500</error-code>   
21.   
22.     <location>/500.html</location>   
23.   
24. </error-page>   
25.   
26. <!-- 这样的配置表示如果jsp页面或者servlet发生java.lang.Exception类型（当然包含子类）的异常就会转到500.jsp页面处理。 -->  
27.   
28. <error-page>   
29.     <exception-type>java.lang.Exception</exception-type>   
30.   
31.     <location>/500.jsp</location>   
32.   
33. </error-page>   
34.   
35. <error-page>   
36.     <exception-type>java.lang.Throwable</exception-type>   
37.   
38.     <location>/500.jsp</location>   
39.   
40. </error-page>  
41.   
42. <!-- 当error-code和exception-type都配置时，exception-type配置的页面优先级高及出现500错误，发生异常Exception时会跳转到500.jsp-->  

来一个问题：HandlerExceptionResolver和web.xml中配置的error-page会有冲突吗？  

解答：如果resolveException返回了ModelAndView，会优先根据返回值中的页面来显示。不过，resolveException可以返回null，此时则展示web.xml中的error-page的500状态码配置的页面。 
当web.xml中有相应的error-page配置，则可以在实现resolveException方法时返回null。 
API文档中对返回值的解释： 
return a corresponding ModelAndView to forward to, or null for default processing. 

写在最后  

下篇文章将会写Spring aop的内容，同样以思维导图的方式编写。可视化学习，让java不再难懂。