整合SSM框架必備基礎—SpringMVC（下）

在上一篇文章《整合SSM框架必備基礎—SpringMVC（上）》中，胖達介紹了關於SpringMVC的誕生、優勢以及執行流程等理論知識點，這篇文章打算在實操中加深一下對SpringMVC的認識，畢竟實踐才是學習技術最有效的方法嘛，Let's Go!

一、 首先來創建一個Web小項目吧

JDK版本：jdk1.7.0_07
開發環境：Intellij IDEA v2018.03

首先需要在IDEA的項目列表頁面新建一個Web項目，這里IDEA給我們提供了眾多的項目模板，只要選擇了相應的模板就可以快速新建一個項目骨架，在這里，我們可以首先通過一個webapp模板新建Web項目，步驟如下：

1.創建新項目

2.通過Maven模板選擇，新建項目骨架

3.為組織和項目新建唯一標志符

4.選擇本地或者默認的Maven及其版本

5.確定項目名稱以及項目新建的位置即可

6.生成的Web項目目錄

在上述步驟完成后，點擊Finish，即可成功利用模板生成了一個簡易的Web項目骨架，其生成的項目目錄如下圖所示：

二、SpringMVC的配置要經歷哪些過程呢？

1.在pom.xml中配置Maven依賴

配置SpringMVC首先需要添加該框架所需的Maven依賴（即jar文件），思考一下SpringMVC的運行需要哪些jar包的支持呢？我們需要把這些依賴都添加到pom.xml文件中，才可進行SpringMVC項目的構建，下面我整理了一份，雖然不是很全但是夠用。

添加依賴之前，首先需要在pom.xml中的properties標簽屬性中標記一下Spring的版本，如果像我一樣額外引入了Hibernate，順便標記一下Hibernate的版本哈，配置如下：

<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <maven.compiler.source>1.7</maven.compiler.source>
  <maven.compiler.target>1.7</maven.compiler.target>
  <spring.version>4.2.6.RELEASE</spring.version>
  <hibernate.version>5.1.0.Final</hibernate.version>
</properties>

然后在這個文件中添加dependency依賴,依賴文件的配置如下：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>4.2.5.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>4.2.5.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>${spring.version}</version>
</dependency>
<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-jpa</artifactId>
    <version>1.10.1.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-entitymanager</artifactId>
    <version>${hibernate.version}</version>
</dependency>
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-c3p0</artifactId>
    <version>${hibernate.version}</version>
</dependency>
<dependency>
    <groupId>com.mchange</groupId>
    <artifactId>c3p0</artifactId>
    <version>0.9.5.2</version>
</dependency>
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.39</version>
</dependency>

另外，如果你pom.xml文件中build屬性標簽中沒有關於maven編譯打包的插件maven-compiler-plugin這一項，你還需要添加一個關於它的配置，因為沒有它你的Maven是沒辦法給你編譯項目源代碼的，但是如果有的話你可以自動忽略掉，配置內容如下：

<build>
    <finalName>springmvcdemo</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
    </plugins>
</build>

2.web.xml文件的配置

對於一個Web項目，web.xml是這個項目的整體配置文件，需要在這個文件中添加相關的一些配置，例如DispatcherServlet配置、字符集編碼設置過濾器、錯誤跳轉頁面等等，其中DispatcherServlet做為框架的入口，是使用SpringMVC必需的配置；encodingFilter過濾器是為了處理請求中的中文，防止出現亂碼。

配置代碼如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app>
  <display-name>Archetype Created Web Application</display-name>
  <!--根目錄跳轉-歡迎頁面-->
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  <!--編碼過濾器-->
  <filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
      <param-name>encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
      <param-name>forceEncoding</param-name>
      <param-value>true</param-value>
    </init-param>
  </filter>
  <filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
  <!--錯誤頁面跳轉-->
  <error-page>
    <!-- 路徑不正確 -->
    <error-code>404</error-code>
    <location>/WEB-INF/errorpage/404.jsp</location>
  </error-page>
  <error-page>
    <!-- 沒有訪問權限，訪問被禁止 -->
    <error-code>405</error-code>
    <location>/WEB-INF/errorpage/405.jsp</location>
  </error-page>
  <error-page>
    <!-- 內部錯誤 -->
    <error-code>500</error-code>
    <location>/WEB-INF/errorpage/500.jsp</location>
  </error-page>
  <!--SpringMVC入口配置-->
  <servlet>
    <servlet-name>spring-mvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--此處后面會有說明-->
      <!--<init-param>
          <param-name>contextConfigLocation</param-name>
          <param-value>/WEB-INF/springmvc-servlet.xml</param-value>
      </init-param>-->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>spring-mvc</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

3.SpringMVC自身xml文件配置

SprignMVC自身也存在一個配置文件，如果你的項目中不包含這個配置文件，可以通過IDEA自帶的方式去生成，步驟如下圖所示：

（1）在WEB-INF根目錄下點擊右鍵

（2）點擊New在右側找到XML Configuration File

（3）點擊后找到Spring Config

（4）為XML配置文件命名，例如：XXX-servlet.xml即可,命名時需要注意SpringMVC會默認去找/WEB-INF/XXX-servlet.xml這個XML，其中XXX是上述Web.xml中所配置的servlet-name名稱，如果不想用這個作為配置文件的名稱，且不想用-servlet為后綴，就需要在Web.xml中配置contextConfigLocation來指定文件路徑,例如：

<!--SpringMVC入口配置-->
<servlet>
  <servlet-name>spring-mvc</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  <!--此處就必須添加了-->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/springmvc-servlet.xml</param-value>
    </init-param>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>spring-mvc</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>

新建了配置文件，IDEA並不會默認生成所有配置，我們最終還是看到一個空空的XML文件，需要對其配置進行手動添加，添加之前首先搞清楚這個配置文件到底能有啥用途呢？

（1）配置自動掃描的包路徑，通過這項配置，自動掃描某個包下的Controller控制器，方便管理Bean,並在請求的時候快速定位Controller並訪問。

（2）注解映射支持配置即注解開關，只有配置了這一項，注解才能有效果。

（3）配置視圖解析器，通過視圖解析器可以給請求頁面添加前綴和后綴，而不用每次SpringMVC返回視圖的時候再去單獨指定前綴、后綴，例如：

<bean id="viewResolver" class="org.springframework.web.servlet.view.UrlBasedViewResolver">
    <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
    <property name="prefix" value="/WEB-INF/pages/"/>
    <property name="suffix" value=".jsp"/>
</bean>

（4）配置靜態資源文件的訪問，如果 DispatcherServlet 攔截了所有的請求，同時對.js,.jpg的訪問也會被攔截，導致運行時跳轉后的頁面無法加載靜態資源文件，這時需要對靜態資源文件的訪問進行配置。

（5）配置上傳文件數據解析器，方便管理上傳數據的信息，包括文件的格式、最大最小數據量等等，例如：

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  <property name="maxUploadSize" value="10485760"/>
  <property name="defaultEncoding" value="UTF-8"/>
</bean>

（6）配置全局異常處理器，針對異常處理做統一的處理和維護，並對一些特殊異常做特殊處理，例如：

<!-- 全局異常處理器，實現HandlerExceptionResolver接口就是全局異常處理器-->
<bean class="com.eurasia.exception.CustomExceptionResolver"></bean>

（7）自定義參數類型綁定，SpringMVC框架可以實現傳參到Controller請求方法中返回視圖和參數的功能，在Controller中可以完成對於參數的處理，例如你的參數是一個實體類，其中的某個字段需要轉換為Date，這時可以通過配置自定義轉換器來實現參數轉換,例如：

<bean id="objectMapper" class="com.fasterxml.jackson.databind.ObjectMapper">
  <property name="dateFormat">
    <bean class="java.text.SimpleDateFormat">
      <constructor-arg type="java.lang.String" value="yyyy-MM-dd HH:mm:ss" />
    </bean>
  </property>
</bean>

明確了這些用途，在來看看文件中應該如何具體的進行配置，配置內容如下（上述某些用途的配置在當前小項目中沒有用到，所以未提供相關配置）：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans

    http://www.springframework.org/schema/beans/spring-beans.xsd

    http://www.springframework.org/schema/context

    http://www.springframework.org/schema/context/spring-context.xsd

    http://www.springframework.org/schema/mvc

    http://www.springframework.org/schema/mvc/spring-mvc.xsd">

        <!--指明 controller 所在包，並掃描其中的注解-->
        <context:component-scan base-package="hello"/>
        <!-- 靜態資源(js、image等)的訪問 -->
        <mvc:default-servlet-handler/>
        <!-- 開啟注解 -->
        <mvc:annotation-driven/>
        <!--ViewResolver 視圖解析器-->
        <!--用於支持Servlet、JSP視圖解析-->
        <bean id="jspViewResolver"

        class="org.springframework.web.servlet.view.UrlBasedViewResolver"

            <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
            <property name="prefix" value="/WEB-INF/pages/"/>
            <property name="suffix" value=".jsp"/>
        </bean>
</beans>

注意：如果你生成的配置文件在加入 這些標簽時報錯，記得檢查你的xmlns:mvc和xmlns:context頭信息，把它們補全即可

4.創建我們的Controller控制器

在src/main目錄下新建包名，例如com.hello這樣，然后在下面新建一個java文件HiController.java，這個就是我們新建的第一個Contrller控制器，通過這個控制器，就可以向前台傳遞ModelAndView,當然你也可以指定view路徑最終呈現給用戶一個展示的界面。

前面我們已經啟用了SpringMVC提供的注解功能，那我們在這里就可以直接用注解來注釋我們的控制器，這樣才能識別到這個控制器，代碼呈上：

@Controller
@RequestMapping("/hello")
public class HiController {

    /**
     * 測試返回指定的view文件名
     * @return
     */
    @RequestMapping("/welcome")
    public String helloWorld() {
        return "welcome";
    }

    /**
     * 測試返回帶有數據的ModelAndView對象
     * @return
     */
    @RequestMapping("/view")
    public ModelAndView getView() {
        String message = "<br><div style='text-align:center;'>"
                + "<h3>我叫胖達，來自HiController.java(公眾號：Java知識共享)</h3>";
        return new ModelAndView("welcome", "message", message);
    }
}

這里Controller最終是要向前台的界面返回數據或者調起某個界面的，所以必須在前台也要指定一個頁面，我在webapp下的WEB-INF中創建了一個pages文件夾專門存放前台的頁面，這里暫時先放一個welcome.jsp頁面，給大家打個招呼，頁面內容如下：

<%@ page language="java" contentType="text/html; charset=UTF-8"
         pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Insert title here</title>
</head>
<body>
Hi!
${message}</body>
</html>

根據前台和后台的這兩段代碼，看懂的小伙伴應該知道了我的演示效果，等我啟動起來項目再展示哈。

5.配置Tomcat，啟動小項目

我已經迫不及待的要啟動我的項目了，IDEA中配置tomcat的步驟其實很簡單，如果你pom.xml中引入maven-tomcat插件，可能會更簡單，這里我用傳統外部tomcat的方式吧。

首先點擊右上角的edit Configurations按鈕：

這樣就打開了run/debug Configurations窗口，在這個窗口繼續操作如下：

特別注意：第四個步驟是為了選擇本地的tomcat路徑哈，直接選擇自己的外部tomcat，選擇根路徑即可。

然后還有一步就是需要選擇tomcat啟動的時候需要Deployment也就是要發布的應用，按照下述步驟1-6即可：

到此，tomcat配置成功，直接點擊右上角，啟動我們的小項目即可。

由於前面配置了歡迎界面，當系統啟動成功后我會自動訪問index.jsp歡迎頁面，並成功展示HelloWorld字樣，接下來我們要依次訪問一下我們控制器中寫的兩個方法：

第一個方法

訪問路徑：

http://localhost:8088/SpringMVCStarter/hello/welcome

訪問結果：

結論：在上面后端的代碼中會發現，我只是指定了一個view的路徑welcome，結果會自動跳轉出welcome.jsp的原有內容，說明我們的調用成功了

第二個方法

訪問路徑：

http://localhost:8088/SpringMVCStarter/hello/view

訪問結果：

結論：與第一個不同的是，這個方法會跳轉同一個界面welcome.jsp，但是后台我返回的是ModelAndView對象，這樣的話，后台會將數據和視圖經過渲染后一並呈現給用戶，如上圖黑色字體為后台傳遞到前台的數據。

三、 SpringMVC的幾種注解

提及SpringMVC,不得不順便啰嗦一下它的注解，確實非常好用，常用的幾個重要注解如下：

1.Controller

這個可以說是最重要的一個注解了，主要用於標識是Controller處理器類.表示把我的控制器對象交給Spring來創建。

2.RequestMapping

請求映射的注解，也就是標記請求路徑名的重要注解，就比如我們小項目中的hello和welcome用法，當然還有指定其他參數的用法，例如請求方式是post還是get，都可以在這個注解中標明。

3.RequestParam

這個注解的功能主要是給參數設置默認值，或者給參數定義別名,只要別名和頁面傳遞參數匹配即可傳遞成功，例如：

@RequestParam(defaultValue="1",value="myid")

它的配置項主要包含：
(1) value：參數名字，即入參的請求參數名字，如value=“studentid”表示請求的參數區中的名字為studentid的參數的值將傳入；

(2) required：是否必須，默認是true，表示請求中一定要有相應的參數，否則將報400錯誤碼；

(3) defaultValue：默認值，表示如果請求中沒有同名參數時的默認值

4.Redirect

通過這個注解，Contrller方法返回結果重定向到一個url地址，例如redirect:/user/add.do即可跳轉到這個add.do指定的相應頁面。

5.Forward

利用這個注解，Controller方法執行后還會繼續執行另一個controller方法，例如return “forward:/user/userlist.do”;，就會去執行其他的userlist這個方法

6.RequestBody/ResponseBody

如果要用到json傳遞數據，那這個注解是非常重要的，其實也是日常開發必須的一個注解。

其中@RequestBody注解用於讀取http請求的內容(字符串)，通過springmvc提供的HttpMessageConverter接口將讀到的內容轉換為json、xml等格式的數據並綁定到controller方法的參數上。

@RequestBody注解實現接收http請求的json數據，將json數據轉換為java對象，但是@RequestBody/@ResponseBody一般要依賴Jackson使用。

四、總結

關於SpringMVC的整個訪問流程在上篇文章中簡單介紹了一下，這篇文章也通過搭建流程、創建配置文件的方式做了一個簡單的介紹，假想我們從訪問一個Controller控制器的url出發，首先通過web.xml中的入口DispatchServlet進入了SpringMVC這個框架的流程，再通過框架內的HandlerMapping、HandlerAdapter找到我們提前通過注解注入的Controller方法，執行完成后返回帶着數據的ModelAndView對象，在通過我們配置的ViewResolver給我們view路徑添加上前綴后綴，最終做一些數據和視圖的渲染工作，就可以將一個期待的效果頁面展現給我們了，這個過程是不是很清晰？其實雖然寫了那么多，但是對於SpringMVC內部的處理情況還是有一點點疑問，以后有機會我會帶着疑問跟大家一起去擼一遍源碼，或許通過源碼才能更加深入的了解到SpringMVC這個神奇的框架，期待ING!!!