超詳細(xì)：三分鐘學(xué)會(huì)用SpringMVC搭建最小系統(tǒng)
前言
做 Java Web 開發(fā)的你，一定聽說過SpringMVC的大名，作為現(xiàn)在運(yùn)用最廣泛的Java框架，它到目前為止依然保持著強(qiáng)大的活力和廣泛的用戶群。
本文介紹如何用eclipse一步一步搭建SpringMVC的最小系統(tǒng)，所謂最小系統(tǒng)，就是足以使項(xiàng)目在SpringMVC框架下成功跑起來(lái)，并且能夠做一些簡(jiǎn)單的事情（比如訪問頁(yè)面）的系統(tǒng)。
話不多說，讓我們開始吧。所有的源代碼和jar包都會(huì)在最后給出。
其他環(huán)境：
操作系統(tǒng)：Windos 10
Tomcat ： v7.0
JDK : 1.7
正文
1. 新建一個(gè)項(xiàng)目
我們用eclipse新建項(xiàng)目，選擇Dynamic Web Project(動(dòng)態(tài)的Web項(xiàng)目)。
點(diǎn)擊Next
Project name里面寫上 springmvc，這就是我們項(xiàng)目的名稱，其他不用改，直接點(diǎn)擊Finish 。
OK，項(xiàng)目就建好了。
接下來(lái)一定要將項(xiàng)目的字符集改為UTF-8
右鍵項(xiàng)目——properties
改為UTF-8，點(diǎn)擊OK。
2. 編寫 web.xml
當(dāng)我們打開WebContent/WEB-INF目錄的時(shí)候，發(fā)現(xiàn)里面只有一個(gè)lib目錄，這是存放各種jar包的地方。我們知道一個(gè)web項(xiàng)目必須要有一個(gè)web.xml文件才行。
既然沒有，我們自己寫一個(gè)咯。
右鍵WEB-INF——new——file，新建一個(gè)web.xml文件。
點(diǎn)擊Finish
將以下內(nèi)容填進(jìn)去即可。
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID"> <!-- 這是項(xiàng)目的名稱 --> <display-name>springmvc</display-name> </web-app>
這樣就完成了基本的配置，我的意思是說，現(xiàn)在這個(gè)項(xiàng)目就已經(jīng)是一個(gè)標(biāo)準(zhǔn)的web項(xiàng)目了。
3. 驗(yàn)證web項(xiàng)目是否搭建成功
為了驗(yàn)證到目前為止的正確性，我們?cè)赪ebContent目錄下面新建一個(gè)jsp文件。
名字就叫index.jsp
內(nèi)容如下：
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <html> <head> <meta charset="UTF-8" /> </head> <body> 恭喜，web項(xiàng)目已經(jīng)成功搭建！ </body> </html>
我們現(xiàn)在就將這個(gè)項(xiàng)目部署到Tomcat,來(lái)驗(yàn)證是否可以跑起來(lái)。
在項(xiàng)目上右鍵——Debug As——Debug on Server
直接點(diǎn)擊Finish
經(jīng)過一段時(shí)間，控制臺(tái)開始打印日志信息，當(dāng)我們看到這些信息的時(shí)候，說明Tomcat已經(jīng)啟動(dòng)完畢了。
讓我們打開瀏覽器，在地址欄輸入以下信息
http://localhost:8088/springmvc/index.jsp
我電腦上Tomcat配置的端口號(hào)是8088，具體情況視你自己的Tomcat決定，可能是8080等。
可見，能夠成功訪問頁(yè)面了，這說明我們到目前為止的操作是正確的。
3. 集成SpringMVC
我們?cè)趙eb.xml文件里面添加下面的配置
3.1 配置監(jiān)聽器
<listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <listener> <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class> </listener>
3.2 配置過濾器，解決POST亂碼問題
<filter> <filter-name>encoding</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> </filter> <filter-mapping> <filter-name>encoding</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
3.3 配置SpringMVC分發(fā)器，攔截所有請(qǐng)求
<servlet> <servlet-name>springmvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>namespace</param-name> <param-value>dispatcher-servlet</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>
在這個(gè)配置中，我們規(guī)定了?DispatcherServlet?的關(guān)聯(lián) XML 文件名稱叫做?dispatcher-servlet。
注意，這里的路徑是相對(duì)于web.xml來(lái)說的，也就是說，這個(gè)文件也在WEB-INF的根目錄下。
所以，我們需要在WEB-INF的根目錄下新建一個(gè)dispatcher-servlet.xml文件。
至此，web.xml文件的編寫就告一段落了。
3.4 編寫dispatcher-servlet.xml
dispatcher-servlet.xml 的作用就是配置SpringMVC分發(fā)器。
配置如下：
<?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:p="http://www.springframework.org/schema/p" xmlns:context="http://www.springframework.org/schema/context" xmlns:util="http://www.springframework.org/schema/util" xmlns:mvc="http://www.springframework.org/schema/mvc" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd "> <!-- 開啟注解模式驅(qū)動(dòng) --> <mvc:annotation-driven></mvc:annotation-driven> <!-- 掃包 --> <context:component-scan base-package="com.springmvc.*"></context:component-scan> <!-- 靜態(tài)資源過濾 --> <mvc:resources location="/resources/" mapping="/resources/**"/> <!-- 視圖渲染 jsp/freemaker/velocity--> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <!-- 制定頁(yè)面存放的路徑 --> <property name="prefix" value="/WEB-INF/pages"></property> <!-- 文件的后綴 --> <property name="suffix" value=".jsp"></property> </bean> </beans>
根據(jù)配置，有三個(gè)需要注意的地方。
它會(huì)掃描 com.springmvc 包下所有的Java類，但凡是遇到有注解的，比如@Controller ， @Service ， @Autowired ，就會(huì)將它們加入到Spring的bean工廠里面去。
所有的靜態(tài)資源文件，比如說 js ， css ， images 都需要放在/resources目錄下，這個(gè)目錄現(xiàn)在我們還沒有建。
所有的展示頁(yè)面，比如jsp文件，都需要放置在/WEB-INF/pages目錄下，這個(gè)目錄現(xiàn)在我們也沒有建。
OK，我們把對(duì)應(yīng)的目錄加上。
首先是Java文件的目錄。
我們?cè)谶@個(gè)地方右鍵，新建一個(gè) com 包,再在里面建一個(gè) springmvc 包，或者用 . 的方式一起建。
點(diǎn)擊Finish
根據(jù)SpringMVC的分層，我們?cè)趕pringmvc 包下面建三個(gè)包，分別是controller ， service ， dao
這樣的話， 當(dāng)我們項(xiàng)目一旦啟動(dòng)，springmvc就會(huì)掃描這三個(gè)包，將里面但凡是有注解的類都提取起來(lái)，放進(jìn)Spring容器（或者說Spring的bean工廠），借由Spring容器來(lái)統(tǒng)一管理。這也就是你從來(lái)沒有去new一個(gè)Controller的原因。
接下來(lái)，我們來(lái)建靜態(tài)資源的目錄。
在WebContent目錄下新建一個(gè)resources文件夾。
然后順便把js，css，img的文件夾都建一下，這里就存放我們的靜態(tài)資源文件。
最后，我們?cè)赪EB-INF目錄下建一個(gè)pages文件夾，作為展示頁(yè)面的存放目錄。
將之前的index.jsp拷貝進(jìn)來(lái)。
這樣就配置的差不多了。
5. 導(dǎo)包和驗(yàn)證
我們將jar包放到lib目錄：
然后啟動(dòng)項(xiàng)目，驗(yàn)證一下到目前為止的構(gòu)建是否正確。
打開Servers視圖，點(diǎn)擊如圖像是甲蟲一樣的圖標(biāo)。
發(fā)現(xiàn)報(bào)錯(cuò)了，錯(cuò)誤信息如下：
錯(cuò)誤：
Could not open ServletContext resource [/WEB-INF/applicationContext.xml]
它說我們?cè)赪EB-INF下面少了一個(gè)applicationContext.xml 這個(gè)文件，原來(lái)，我們少了對(duì)SpringBean工廠的配置，它的意思就是說，我們要規(guī)定一下，在Spring容器啟動(dòng)的時(shí)候，需要自動(dòng)加載哪些東西？
于是，我們把 applicationContext.xml 加上。
<?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:aop="http://www.springframework.org/schema/aop" xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx" xmlns:util="http://www.springframework.org/schema/util" xmlns:p="http://www.springframework.org/schema/p" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-4.0.xsd "> </beans>
里面我們啥也不配置，再次啟動(dòng)Tomcat。
這回不報(bào)錯(cuò)了。
5. 配置ViewController
我們知道，WEB-INF目錄下的任何資源都是無(wú)法直接通過瀏覽器的url地址去訪問的，保證了安全性。這也是我們?yōu)槭裁窗秧?yè)面都放在該目錄下的原因。
為了有所區(qū)分，我們還單獨(dú)建立了一個(gè)pages文件夾，將這些頁(yè)面保存起來(lái)。
現(xiàn)在，為了訪問這個(gè)頁(yè)面，我們需要用到SpringMVC的頁(yè)面跳轉(zhuǎn)機(jī)制。
我們?cè)贑ontroller包下新建一個(gè)ViewController
點(diǎn)擊Finish
ViewController 代碼：
package com.springmvc.controller; import javax.servlet.http.HttpServletRequest; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.servlet.ModelAndView; @Controller public class ViewController { @RequestMapping("/view") public ModelAndView view(HttpServletRequest request){ String path = request.getParameter("path") + ""; ModelAndView mav = new ModelAndView(); mav.setViewName(path); return mav; } }
我只需要將想要訪問的頁(yè)面放在path里面，通過url傳進(jìn)來(lái)就行了。
因?yàn)樘砑恿薺ava類，因此我們重新啟動(dòng)Tomcat。
啟動(dòng)完成后，在地址欄輸入：
http://localhost:8088/springmvc/view?path=index
結(jié)果：
沒關(guān)系，我們看他報(bào)什么錯(cuò)。
message?/springmvc/WEB-INF/pagesindex.jsp
pagesindex.jsp是什么鬼？？
原來(lái)，在dispatcher-servlet.xml中，我們少寫了一個(gè) "/"
添上去就行了。
保存后，因?yàn)樾薷牧薠ML配置文件，因此我們還是需要重新啟動(dòng)Tomcat。
啟動(dòng)完成后，繼續(xù)！
成功了。
6. 引入靜態(tài)資源
比如，我在resources/img目錄下放了一張圖片，怎么引入到index.jsp呢？
Paste_Image.png
background : url(http://localhost:8088/springmvc/resources/img/bg.jpg); background-size : 100% 100%;
的確，這是一種方式?？墒?，它有一個(gè)缺點(diǎn)就是根路徑寫死了，我們肯定不希望這樣的。
其實(shí)，我們可以在viewController里面拿到項(xiàng)目根路徑，然后傳遞到j(luò)sp頁(yè)面就OK了。
我們把調(diào)試信息 “恭喜，web項(xiàng)目已經(jīng)成功搭建！” 刪掉。
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <html> <head> <meta charset="UTF-8" /> </head> <style> body { background : url(${contextPath}/resources/img/bg.jpg); background-size : 100% 100%; } </style> <body> </body> </html>
${contextPath} 可以取到Controller傳過來(lái)的contextPath值。
成功了！
