三分鐘學會用SpringMVC搭建最小系統（超詳細）

前言

作 Java Web 開發的你，必定據說過SpringMVC的大名，做爲如今運用最普遍的Java框架，它到目前爲止依然保持着強大的活力和普遍的用戶羣。

本文介紹如何用eclipse一步一步搭建SpringMVC的最小系統，所謂最小系統，就是足以使項目在SpringMVC框架下成功跑起來，而且可以作一些簡單的事情（好比訪問頁面）的系統。

話很少說，讓咱們開始吧。全部的源代碼和jar包都會在最後給出。

正文

1. 新建一個項目

Paste_Image.png

咱們用eclipse新建項目，選擇Dynamic Web Project(動態的Web項目)。

點擊Next

Paste_Image.png

Project name裏面寫上 springmvc，這就是咱們項目的名稱，其餘不用改，直接點擊Finish 。

Paste_Image.png

OK，項目就建好了。

接下來必定要將項目的字符集改成UTF-8

右鍵項目——properties

Paste_Image.png

改成UTF-8，點擊OK。

2. 編寫 web.xml

當咱們打開WebContent/WEB-INF目錄的時候，發現裏面只有一個lib目錄，這是存放各類jar包的地方。咱們知道一個web項目必需要有一個web.xml文件才行。

既然沒有，咱們本身寫一個咯。

右鍵WEB-INF——new——file，新建一個web.xml文件。

點擊Finish

將如下內容填進去便可。

springmvc

這樣就完成了基本的配置，個人意思是說，如今這個項目就已是一個標準的web項目了。

3. 驗證web項目是否搭建成功

爲了驗證到目前爲止的正確性，咱們在WebContent目錄下面新建一個jsp文件。

名字就叫index.jsp

Paste_Image.png

內容以下：

<%@ page language="java"contentType="text/html; charset=UTF-8"pageEncoding="UTF-8"%>恭喜，web項目已經成功搭建！

咱們如今就將這個項目部署到Tomcat,來驗證是否能夠跑起來。

在項目上右鍵——Debug As——Debug on Server

直接點擊Finish

通過一段時間，控制檯開始打印日誌信息，當咱們看到這些信息的時候，說明Tomcat已經啓動完畢了。

Paste_Image.png

讓咱們打開瀏覽器，在地址欄輸入如下信息

http://localhost:8088/springmvc/index.jsp

我電腦上Tomcat配置的端口號是8088，具體狀況視你本身的Tomcat決定，多是8080等。

Paste_Image.png

可見，可以成功訪問頁面了，這說明咱們到目前爲止的操做是正確的。

3. 集成SpringMVC

咱們在web.xml文件裏面添加下面的配置

3.1 配置監聽器

org.springframework.web.context.ContextLoaderListenerorg.springframework.web.util.IntrospectorCleanupListener

3.2 配置過濾器，解決POST亂碼問題

encodingorg.springframework.web.filter.CharacterEncodingFilterencodingUTF-8encoding/*

3.3 配置SpringMVC分發器，攔截全部請求

springmvcorg.springframework.web.servlet.DispatcherServletnamespacedispatcher-servletspringmvc/

在這個配置中，咱們規定了DispatcherServlet的關聯 XML 文件名稱叫作dispatcher-servlet。

注意，這裏的路徑是相對於web.xml來講的，也就是說，這個文件也在WEB-INF的根目錄下。

因此，咱們須要在WEB-INF的根目錄下新建一個dispatcher-servlet.xml文件。

Paste_Image.png

至此，web.xml文件的編寫就告一段落了。

3.4 編寫dispatcher-servlet.xml

dispatcher-servlet.xml 的做用就是配置SpringMVC分發器。

配置以下：

根據配置，有三個須要注意的地方。

它會掃描 com.springmvc 包下全部的Java類，但凡是遇到有註解的，好比@Controller，@Service， @Autowired ，就會將它們加入到Spring的bean工廠裏面去。

全部的靜態資源文件，好比說 js ， css ， images 都須要放在/resources目錄下，這個目錄如今咱們尚未建。

全部的展現頁面，好比jsp文件，都須要放置在/WEB-INF/pages目錄下，這個目錄如今咱們也沒有建。

OK，咱們把對應的目錄加上。

首先是Java文件的目錄。

Paste_Image.png

咱們在這個地方右鍵，新建一個 com 包,再在裏面建一個 springmvc 包，或者用 . 的方式一塊兒建。

Paste_Image.png

點擊Finish

Paste_Image.png

根據SpringMVC的分層，咱們在springmvc 包下面建三個包，分別是controller ， service ， dao

Paste_Image.png

這樣的話， 當咱們項目一旦啓動，springmvc就會掃描這三個包，將裏面但凡有註解的類都提取起來，放進Spring容器（或者說Spring的bean工廠），藉由Spring容器來統一管理。這也就是你歷來沒有去new一個Controller的緣由。

接下來，咱們來建靜態資源的目錄。

在WebContent目錄下新建一個resources文件夾。

而後順便把js，css，img的文件夾都建一下，這裏就存放咱們的靜態資源文件。

Paste_Image.png

最後，咱們在WEB-INF目錄下建一個pages文件夾，做爲展現頁面的存放目錄。

Paste_Image.png

將以前的index.jsp拷貝進來。

Paste_Image.png

這樣就配置的差很少了。

5. 導包和驗證

咱們將jar包放到lib目錄：

Paste_Image.png

而後啓動項目，驗證一下到目前爲止的構建是否正確。

打開Servers視圖，點擊如圖像是甲蟲同樣的圖標。

Paste_Image.png

發現報錯了，錯誤信息以下：

Paste_Image.png

錯誤：

Could not open ServletContext resource [/WEB-INF/applicationContext.xml]

它說咱們在WEB-INF下面少了一個applicationContext.xml 這個文件，原來，咱們少了對SpringBean工廠的配置，它的意思就是說，咱們要規定一下，在Spring容器啓動的時候，須要自動加載哪些東西？

因而，咱們把 applicationContext.xml 加上。

Paste_Image.png

裏面咱們啥也不配置，再次啓動Tomcat。

Paste_Image.png

這回不報錯了。

5. 配置ViewController

咱們知道，WEB-INF目錄下的任何資源都是沒法直接經過瀏覽器的url地址去訪問的，保證了安全性。這也是咱們爲何把頁面都放在該目錄下的緣由。

爲了有所區分，咱們還單獨創建了一個pages文件夾，將這些頁面保存起來。

Paste_Image.png

如今，爲了訪問這個頁面，咱們須要用到SpringMVC的頁面跳起色制。

咱們在Controller包下新建一個ViewController

Paste_Image.png

點擊Finish

Paste_Image.png

ViewController 代碼：

packagecom.springmvc.controller;importjavax.servlet.http.HttpServletRequest;importorg.springframework.stereotype.Controller;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.servlet.ModelAndView;@ControllerpublicclassViewController{@RequestMapping("/view")publicModelAndView view(HttpServletRequest request){        String path = request.getParameter("path") +"";        ModelAndView mav = new ModelAndView();        mav.setViewName(path);returnmav;    }}

我只須要將想要訪問的頁面放在path裏面，經過url傳進來就好了。

由於添加了java類，所以咱們從新啓動Tomcat。

啓動完成後，在地址欄輸入：

http://localhost:8088/springmvc/view?path=index

結果：

Paste_Image.png

不要緊，咱們看他報什麼錯。

message/springmvc/WEB-INF/pagesindex.jsp

pagesindex.jsp是什麼鬼？？

原來，在dispatcher-servlet.xml中，咱們少寫了一個 "/"

Paste_Image.png

添上去就好了。

Paste_Image.png

保存後，由於修改了XML配置文件，所以咱們仍是須要從新啓動Tomcat。

啓動完成後，繼續！

Paste_Image.png

成功了。

6. 引入靜態資源

好比，我在resources/img目錄下放了一張圖片，怎麼引入到index.jsp呢？

Paste_Image.png

background: url(http://localhost:8088/springmvc/resources/img/bg.jpg);background-size:100%100%;

的確，這是一種方式。但是，它有一個缺點就是根路徑寫死了，咱們確定不但願這樣的。

其實，咱們能夠在viewController裏面拿到項目根路徑，而後傳遞到jsp頁面就OK了。

Paste_Image.png

咱們把調試信息 「恭喜，web項目已經成功搭建！」 刪掉。

<%@ page language="java"contentType="text/html; charset=UTF-8"pageEncoding="UTF-8"%>body{background:url(${contextPath}/resources/img/bg.jpg);background-size:100%100%;

}

${contextPath} 能夠取到Controller傳過來的contextPath值。

 

-----------------------------------------------------------------------------------

完整的項目源碼   歡迎你們一塊兒學習研究相關技術，源碼獲取請加求求:2670716182