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

時間  2019-11-08
標籤 整合 ssm 框架 必備 基礎 springmvc 欄目 Spring 简体版
原文   原文鏈接

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

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

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

首先須要在IDEA的項目列表頁面新建一個Web項目，這裏IDEA給咱們提供了衆多的項目模板，只要選擇了相應的模板就能夠快速新建一個項目骨架，在這裏，咱們能夠首先經過一個webapp模板新建Web項目，步驟以下：mysql

1.建立新項目

在這裏插入圖片描述

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

在這裏插入圖片描述

3.爲組織和項目新建惟一標誌符

在這裏插入圖片描述

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

在這裏插入圖片描述

5.肯定項目名稱以及項目新建的位置便可

在這裏插入圖片描述

6.生成的Web項目目錄

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

在這裏插入圖片描述

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

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

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

添加依賴以前，首先須要在pom.xml中的properties標籤屬性中標記一下Spring的版本，若是像我同樣額外引入了Hibernate，順便標記一下Hibernate的版本哈，配置以下：sql

<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依賴,依賴文件的配置以下：apache

<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是沒辦法給你編譯項目源代碼的，可是若是有的話你能夠自動忽略掉，配置內容以下：json

<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過濾器是爲了處理請求中的中文，防止出現亂碼。後端

配置代碼以下：spring-mvc

<?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對象，這樣的話，後臺會將數據和視圖通過渲染後一併呈現給用戶，如上圖黑色字體爲後臺傳遞到前臺的數據。

3、 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使用。

4、總結

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

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程