作 Java Web 開發的你,必定據說過SpringMVC的大名,做爲如今運用最普遍的Java框架,它到目前爲止依然保持着強大的活力和普遍的用戶羣。css
本文介紹如何用eclipse一步一步搭建SpringMVC的最小系統,所謂最小系統,就是足以使項目在SpringMVC框架下成功跑起來,而且可以作一些簡單的事情(好比訪問頁面)的系統。html
話很少說,讓咱們開始吧。全部的源代碼和jar包都會在最後給出。java
其餘環境:
操做系統:Windos 10
Tomcat : v7.0
JDK : 1.7web
Paste_Image.pngspring
咱們用eclipse新建項目,選擇Dynamic Web Project(動態的Web項目)。瀏覽器
點擊Nextspring-mvc
Paste_Image.png安全
Project name裏面寫上 springmvc,這就是咱們項目的名稱,其餘不用改,直接點擊Finish 。mvc
Paste_Image.pngapp
OK,項目就建好了。
接下來必定要將項目的字符集改成UTF-8
右鍵項目——properties
Paste_Image.png
改成UTF-8,點擊OK。
當咱們打開WebContent/WEB-INF目錄的時候,發現裏面只有一個lib目錄,這是存放各類jar包的地方。咱們知道一個web項目必需要有一個web.xml文件才行。
既然沒有,咱們本身寫一個咯。
右鍵WEB-INF——new——file,新建一個web.xml文件。
點擊Finish
將如下內容填進去便可。
<?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"> <!-- 這是項目的名稱 --> <display-name>springmvc</display-name> </web-app>
這樣就完成了基本的配置,個人意思是說,如今這個項目就已是一個標準的web項目了。
爲了驗證到目前爲止的正確性,咱們在WebContent目錄下面新建一個jsp文件。
名字就叫index.jsp
Paste_Image.png
內容以下:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <html> <head> <meta charset="UTF-8" /> </head> <body> 恭喜,web項目已經成功搭建! </body> </html>
咱們如今就將這個項目部署到Tomcat,來驗證是否能夠跑起來。
在項目上右鍵——Debug As——Debug on Server
直接點擊Finish
通過一段時間,控制檯開始打印日誌信息,當咱們看到這些信息的時候,說明Tomcat已經啓動完畢了。
Paste_Image.png
讓咱們打開瀏覽器,在地址欄輸入如下信息
http://localhost:8088/springmvc/index.jsp
我電腦上Tomcat配置的端口號是8088,具體狀況視你本身的Tomcat決定,多是8080等。
Paste_Image.png
可見,可以成功訪問頁面了,這說明咱們到目前爲止的操做是正確的。
咱們在web.xml文件裏面添加下面的配置
3.1 配置監聽器
<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分發器,攔截全部請求
<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>
在這個配置中,咱們規定了 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分發器。
配置以下:
<?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 "> <!-- 開啓註解模式驅動 --> <mvc:annotation-driven></mvc:annotation-driven> <!-- 掃包 --> <context:component-scan base-package="com.springmvc.*"></context:component-scan> <!-- 靜態資源過濾 --> <mvc:resources location="/resources/" mapping="/resources/**"/> <!-- 視圖渲染 jsp/freemaker/velocity--> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <!-- 制定頁面存放的路徑 --> <property name="prefix" value="/WEB-INF/pages"></property> <!-- 文件的後綴 --> <property name="suffix" value=".jsp"></property> </bean> </beans>
根據配置,有三個須要注意的地方。
它會掃描 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
這樣就配置的差很少了。
咱們將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
<?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>
裏面咱們啥也不配置,再次啓動Tomcat。
Paste_Image.png
這回不報錯了。
咱們知道,WEB-INF目錄下的任何資源都是沒法直接經過瀏覽器的url地址去訪問的,保證了安全性。這也是咱們爲何把頁面都放在該目錄下的緣由。
爲了有所區分,咱們還單獨創建了一個pages文件夾,將這些頁面保存起來。
Paste_Image.png
如今,爲了訪問這個頁面,咱們須要用到SpringMVC的頁面跳起色制。
咱們在Controller包下新建一個ViewController
Paste_Image.png
點擊Finish
Paste_Image.png
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; } }
我只須要將想要訪問的頁面放在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
成功了。
好比,我在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"%> <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傳過來的contextPath值。
成功了!
源碼已經上傳,資源帖地址:【資源】文章和素材彙總
本章結束 ...
做者:剽悍一小兔 連接:http://www.jianshu.com/p/0ccaa4af05fc 來源:簡書 著做權歸做者全部。商業轉載請聯繫做者得到受權,非商業轉載請註明出處。