Spring3 MVC詳解一

DispatcherServlet 前置控制器

  使用Spring MVC,配置DispatcherServlet是第一步。DispatcherServlet是一個Servlet,所以可以配置多個DispatcherServlet。DispatcherServlet是前置控制器，配置在web.xml文件中的。攔截匹配的請求，Servlet攔截匹配規則要自已定義，把攔截下來的請求，依據某某規則分發到目標Controller(我們寫的Action)來處理

<span style="white-space:pre">  </span><servlet>
        <servlet-name>spring3</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/spring/mvc-config.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>spring3</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

DispatcherServlet是一個Servlet,可以同時配置多個，每個 DispatcherServlet有一個自己的 WebApplicationContext上下文，這個上下文繼承了 根上下文 中所有東西。 保存在 ServletContext中，key是"org.springframework.web.servlet.FrameworkServlet.CONTEXT"+Servlet名稱。當一個Request對象產生時，會把這個WebApplicationContext上下文保存在Request對象中，key是DispatcherServlet.class.getName() + ".CONTEXT"。可以使用工具類取出上下文：RequestContextUtils.getWebApplicationContext(request);


使用listener監聽器來加載配置

<listener>
  <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

Spring會創建一個全局的WebApplicationContext上下文，稱爲根上下文 ，保存在 ServletContext中，key是WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE屬性的值。可以使用工具類取出上下文：WebApplicationContextUtils.getWebApplicationContext(ServletContext);

Spring  mvc-config.xml 配置文件片段講解 

<span style="font-size:10px;">   <!-- 自動掃描的包名 -->
   <context:component-scan base-package="com.app,com.core,JUnit4" ></context:component-scan>

   <!-- 默認的註解映射的支持 -->
   <mvc:annotation-driven />

   <!-- 視圖解釋類 -->
   <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/jsp/"/>
    <property name="suffix" value=".jsp"/><!--可爲空,方便實現自已的依據擴展名來選擇視圖解釋類的邏輯  -->
    <property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />
   </bean>

   <!-- 攔截器 -->
   <mvc:interceptors>
    <bean class="com.core.mvc.MyInteceptor" />
   </mvc:interceptors>

    <!-- 對靜態資源文件的訪問  方案一 （二選一） -->
    <mvc:default-servlet-handler/>

    <!-- 對靜態資源文件的訪問  方案二 （二選一）-->
<mvc:resources mapping="/images/**" location="/images/" cache-period="31556926"/>
<mvc:resources mapping="/js/**" location="/js/" cache-period="31556926"/>
<mvc:resources mapping="/css/**" location="/css/" cache-period="31556926"/>  </span>

<context:component-scan/> 掃描指定的包中的類上的註解，常用的註解有：

@Controller 聲明Action組件
@Service    聲明Service組件    @Service("myMovieLister") 
@Repository 聲明Dao組件
@Component   泛指組件, 當不好歸類時. 
@RequestMapping("/menu")  請求映射
@Resource  用於注入，( j2ee提供的 ) 默認按名稱裝配，@Resource(name="beanName") 
@Autowired 用於注入，(srping提供的) 默認按類型裝配 
@Transactional( rollbackFor={Exception.class}) 事務管理
@ResponseBody
@Scope("prototype")   設定bean的作用域

<mvc:annotation-driven /> 是一種簡寫形式，完全可以手動配置替代這種簡寫形式，簡寫形式可以讓初學都快速應用默認配置方案。
<mvc:annotation-driven /> 會自動註冊DefaultAnnotationHandlerMapping與AnnotationMethodHandlerAdapter 兩個bean,是spring MVC爲@Controllers分發請求所必須的。
並提供了：數據綁定支持，@NumberFormatannotation支持，@DateTimeFormat支持，@Valid支持，讀寫XML的支持（JAXB），讀寫JSON的支持（Jackson）。
後面，我們處理響應ajax請求時，就使用到了對json的支持。
後面，對action寫JUnit單元測試時，要從spring IOC容器中取DefaultAnnotationHandlerMapping與AnnotationMethodHandlerAdapter 兩個bean，來完成測試，取的時候要知道是<mvc:annotation-driven />這一句註冊的這兩個bean。

<mvc:interceptors/> 是一種簡寫形式。可以配置多個HandlerMapping。<mvc:interceptors/>會爲每一個HandlerMapping，注入一個攔截器。其實我們也可以手動配置爲每個HandlerMapping注入一個攔截器。

<mvc:default-servlet-handler/> 使用默認的Servlet來響應靜態文件。

<mvc:resources mapping="/images/**" location="/images/" cache-period="31556926"/> 匹配URL  /images/**  的URL被當做靜態資源，由Spring讀出到內存中再響應http。

 

訪問到靜態的文件，如jpg,js,css

  

如何你的DispatcherServlet攔截 *.do這樣的URL，就不存在訪問不到靜態資源的問題。如果你的DispatcherServlet攔截“/”，攔截了所有的請求，同時對*.js,*.jpg的訪問也就被攔截了。

目的：可以正常訪問靜態文件，不要找不到靜態文件報404。

方案一：激活Tomcat的defaultServlet來處理靜態文件

<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>*.jpg</url-pattern>
</servlet-mapping>
<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>*.js</url-pattern>
</servlet-mapping>
<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>*.css</url-pattern>
</servlet-mapping>
要配置多個，每種文件配置一個

要寫在DispatcherServlet的前面， 讓 defaultServlet先攔截，這個就不會進入Spring了 

Tomcat, Jetty, JBoss, and GlassFish  默認 Servlet的名字 -- "default"
Google App Engine 默認 Servlet的名字 -- "_ah_default"
Resin 默認 Servlet的名字 -- "resin-file"
WebLogic 默認 Servlet的名字  -- "FileServlet"
WebSphere  默認 Servlet的名字 -- "SimpleFileServlet" 

方案二： 在spring3.0.4以後版本提供了mvc:resources 
mvc:resources 的使用方法：

<!-- 對靜態資源文件的訪問 -->
<mvc:resources mapping="/images/**" location="/images/" />

<span style="font-weight: normal;">mapping<span style="font-family: Arial; line-height: 1.5em; ">映射到ResourceHttpRequestHandler進行處理
location指定靜態資源的位置.可以是web application根目錄下、jar包裏面，這樣可以把靜態資源壓縮到jar包中
cache-period 可以使得靜態資源進行web cache </span></span>

如果出現下面的錯誤，可能是沒有配置<mvc:annotation-driven />的原因。 
報錯WARNING: No mapping found for HTTP request with URI [/mvc/user/findUser/lisi/770] in DispatcherServlet with name 'springMVC'

 

使用<mvc:resources/>元素,把mapping的URI註冊到SimpleUrlHandlerMapping的urlMap中,key爲mapping的URI pattern值,而value爲ResourceHttpRequestHandler,這樣就巧妙的把對靜態資源的訪問由HandlerMapping轉到ResourceHttpRequestHandler處理並返回,所以就支持classpath目錄,jar包內靜態資源的訪問.另外需要注意的一點是,不要對SimpleUrlHandlerMapping設置defaultHandler.因爲對static uri的defaultHandler就是ResourceHttpRequestHandler,否則無法處理static resources request.

方案三 ，使用<mvc:default-servlet-handler/>

<mvc:default-servlet-handler/>

會把"/**" url,註冊到SimpleUrlHandlerMapping的urlMap中,把對靜態資源的訪問由HandlerMapping轉到org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler處理並返回.DefaultServletHttpRequestHandler使用就是各個Servlet容器自己的默認Servlet.

 

補充說明：多個HandlerMapping的執行順序問題：

DefaultAnnotationHandlerMapping的order屬性值是：0
<mvc:resources/ >自動註冊的 SimpleUrlHandlerMapping的order屬性值是： 2147483646

<mvc:default-servlet-handler/>自動註冊 的SimpleUrlHandlerMapping 的order屬性值是： 2147483647

spring會先執行order值比較小的。當訪問一個a.jpg圖片文件時，先通過 DefaultAnnotationHandlerMapping 來找處理器，一定是找不到的，我們沒有叫a.jpg的Action。再按order值升序找，由於最後一個 SimpleUrlHandlerMapping 是匹 "/**"的，所以一定會匹配上，再響應圖片。

 請求如何映射到具體的Action中的方法

方案一：基於xml配置映射，可以利用SimpleUrlHandlerMapping、BeanNameUrlHandlerMapping進行Url映射和攔截請求。
 
方案二：基於註解映射，可以使用DefaultAnnotationHandlerMapping。

<bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping">  </bean>
簡寫
<span style="font-family: Arial; line-height: 24px; text-align: left; "><span style="font-size:10px;"><mvc:annotation-driven /></span></span>

 並在action類上使用：
@Controller
@RequestMapping("/user")

Spring中的攔截器：
Spring爲我們提供了：org.springframework.web.servlet.HandlerInterceptor接口，org.springframework.web.servlet.handler.HandlerInterceptorAdapter適配器，實現這個接口或繼承此類，可以非常方便的實現自己的攔截器。

public boolean preHandle(HttpServletRequest request,HttpServletResponse response, Object handler);

public void postHandle(HttpServletRequest request,HttpServletResponse response, Object handler,ModelAndView modelAndView);

public void afterCompletion(HttpServletRequest request,HttpServletResponse response, Object handler, Exception ex)

分別實現預處理、後處理（調用了Service並返回ModelAndView，但未進行頁面渲染）、返回處理（已經渲染了頁面） 

在preHandle中，可以進行編碼、安全控制等處理； 
在postHandle中，有機會修改ModelAndView； 
在afterCompletion中，可以根據ex是否爲null判斷是否發生了異常，進行日誌記錄。 
參數中的Object handler是下一個攔截器。

自定義一個攔截器，要實現HandlerInterceptor接口：

public class MyInteceptor implements HandlerInterceptor

Spring MVC並沒有總的攔截器，不能對所有的請求進行前後攔截。Spring MVC的攔截器，是屬於HandlerMapping級別的，可以有多個HandlerMapping ，每個HandlerMapping可以有自己的攔截器。

在spring MVC的配置文件中配置有三種方法：

方案一  （近似）總攔截器，攔截所有url

<mvc:interceptors>
    <bean class="com.app.mvc.MyInteceptor" />
</mvc:interceptors>

<mvc:interceptors/>會爲每一 個HandlerMapping，注入一個攔截器。總有一個HandlerMapping是可以找到處理器的，最多也只找到一個處理器，所以這個攔截器總會被執行的。起到了總攔截器的作用。

方案二  （近似） 總攔截器， 攔截匹配的URL。比方案一多一個URL匹配。

<mvc:interceptors >
  <mvc:interceptor>
        <mvc:mapping path="/user/*" /> <!-- /user/*  -->
        <bean class="com.mvc.MyInteceptor"></bean>
    </mvc:interceptor>
</mvc:interceptors>

方案三   HandlerMapping上的攔截器

<bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping">
 <property name="interceptors">
     <list>
         <bean class="com.mvc.MyInteceptor"></bean>
     </list>
 </property>
</bean>

<mvc:annotation-driven />會自動註冊DefaultAnnotationHandlerMapping 與AnnotationMethodHandlerAdapter 這兩個bean,所以就沒有機會再給它注入interceptors屬性，就無法指定攔截器。

如果我們手動配置上面的兩個Bean，不使用 <mvc:annotation-driven />，就可以 給interceptors屬性 注入攔截器了。

實現全局的異常處理

<!-- 總錯誤處理-->
<bean id="exceptionResolver" class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
    <property name="defaultErrorView">
        <value>/error/error</value>
    </property>
    <property name="defaultStatusCode">
        <value>500</value>
    </property>
    <property name="warnLogCategory">
        <value>org.springframework.web.servlet.handler.SimpleMappingExceptionResolver</value>
    </property>
</bean>

通過SimpleMappingExceptionResolver我們可以將不同的異常映射到不同的jsp頁面（通過exceptionMappings屬性的配置）。如果所拋出的異常在exceptionMappings中沒有對應的映射，則Spring將用此默認配置顯示異常信息（通過defaultErrorView屬性的配置）。

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=GBK">
<title>錯誤頁面</title>
</head>
<body>
<h1>出錯了</h1>
<%
Exception e = (Exception)request.getAttribute("exception");
out.print(e.getMessage());
%>
</body>
</html>

其中一句：request.getAttribute("exception")，key是exception，也是在SimpleMappingExceptionResolver類默認指定的，是可能通過配置文件修改這個值的。