在上一篇文章 "《整合SSM框架必備基礎—SpringMVC(上)》" 中,胖達介紹了關於SpringMVC的誕生、優勢以及執行流程等理論知識點,這篇文章打算在實操中加深一下對SpringMVC的認識,畢竟實踐才是學習技術最有效的方法嘛,Let's Go! 一、 首先來創建一個Web小項目吧 JDK ...
在上一篇文章《整合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>
註意:如果你生成的配置文件在加入
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!!!