前言:
時隔十二年,中國女排最終過關斬將,用3:1的成績證明了自己的實力,霸氣奪冠,為中國贏得了一枚意義非常的金牌。這是一次全民的狂歡,一場視聽盛宴,帶給我們不僅是熠熠生輝的金牌,更傳遞出的是一種女排精神。
每每得分的時候,總能看到球員們歇斯底里的咆哮和歡呼,因為每一分都來的太不容易。
其實碼農也是如此,每每解決掉一個bug的時候,內心的舒暢和激動,好似經歷了沒有盡頭的爬坡,幾度已經快精疲力盡或是達到了精神崩潰的邊緣之后,陡然迎來了下坡,這種感覺好比賽場上女將們得分后已經無法用言語來表達心情,而只能靠咆哮來傳遞內心的喜悅。
話不多說,從今天起,准備好好審視並學習Spring mvc。
雖然從學java的第一個程序——helloworld至今,已經有好幾個年頭了。當時自己找資料,看視頻,學習了java的輸入輸出流,多線程,網絡編程等等, 而三大框架(Struts、Hibernate、Spring)基本只是開了個頭就出來實習了,尤其對於Spring更是沒有進行系統的學習, 雖然在實習的時候通過看項目,基本明白了spring mvc編程的框架是怎么回事,遇到需求知道如何寫代碼,在哪寫代碼,但是還是缺乏一個系統的認識。對於涉及到一些spring的文件配置或工作原理的問題時,就顯得有些局促。所以,最近准備好好來學習下現如今在企業級開發中大行其道的Spring MVC。
什么是Spring MVC
Spring MVC屬於SpringFrameWork的后續產品,已經融合在Spring Web Flow里面。Spring 框架提供了構建 Web 應用程序的全功能 MVC 模塊。使用 Spring 可插入的 MVC 架構,從而在使用Spring進行WEB開發時,可以選擇使用Spring的SpringMVC框架或集成其他MVC開發框架,如Struts1,Struts2等。
今天先從寫一個Spring MVC的HelloWorld開始,讓我們看看如何搭建起一個Spring mvc的環境並運行程序。
軟件參數
Eclipse:Mars.1 Release (4.5.1)
Tomcat: 8.0.36
JDK:1.8.0_60
Spring-framework: 4.0.4.RELEASE
新建項目
File-New-Other,選擇Dynamic web project
項目建好之后,目錄結構如下:
導入jar包
我們基於Spring mvc框架進行開發,需要依賴一下的spring jar包:
- spring-aop-4.0.4.RELEASE.jar
- spring-beans-4.0.4.RELEASE.jar
- spring-context-4.0.4.RELEASE.jar
- spring-core-4.0.4.RELEASE.jar
- spring-expression-4.0.4.RELEASE.jar
- spring-web-4.0.4.RELEASE.jar
- spring-webmvc-4.0.4.RELEASE.jar
- commons-logging-1.1.1.jar(用來打印log)
在WEB-INF目錄下新建lib文件夾,並將上面的jar包放入其中。
jar包可以點擊這里下載。
配置文件及編寫代碼
web.xml(WEB-INF下)
1 <?xml version="1.0" encoding="UTF-8"?> 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 3 xmlns="http://java.sun.com/xml/ns/javaee" 4 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 5 id="WebApp_ID" version="2.5"> 6 7 <!-- 配置DispatchcerServlet --> 8 <servlet> 9 <servlet-name>springDispatcherServlet</servlet-name> 10 <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 11 <!-- 配置Spring mvc下的配置文件的位置和名稱 --> 12 <init-param> 13 <param-name>contextConfigLocation</param-name> 14 <param-value>classpath:springmvc.xml</param-value> 15 </init-param> 16 <load-on-startup>1</load-on-startup> 17 </servlet> 18 19 <servlet-mapping> 20 <servlet-name>springDispatcherServlet</servlet-name> 21 <url-pattern>/</url-pattern> 22 </servlet-mapping> 23 24 </web-app>
注意:1. line12-15用於配置spring mvc的配置文件的位置和名稱,這里說明會新建一個springmvc.xml的配置文件
2. 我們也可以不新建springmvc.xml,而是用默認的,默認的配置文件格式為/WEB-INF/[servlet-name]-servlet.xml,對應這里的就是springDispatcherServlet-servlet.xml
3. 這里的servlet-mapping表示攔截的模式,這里是“/”,表示對於所有的請求的攔截,包括靜態資源如html, js, jpg等。這時候對於靜態資源的訪問就會報404的錯誤。關於如何解決后面會介紹
Springmvc.xml(scr下)
在src目錄下新建springmvc.xml
1 <?xml version="1.0" encoding="UTF-8"?> 2 <beans xmlns="http://www.springframework.org/schema/beans" 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 xmlns:context="http://www.springframework.org/schema/context" 5 xmlns:mvc="http://www.springframework.org/schema/mvc" 6 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd 7 http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd 8 http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd"> 9 10 11 <!-- 配置自動掃描的包 --> 12 <context:component-scan base-package="com.jackie.springmvc"></context:component-scan> 13 14 <!-- 配置視圖解析器 如何把handler 方法返回值解析為實際的物理視圖 --> 15 <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 16 <property name = "prefix" value="/WEB-INF/views/"></property> 17 <property name = "suffix" value = ".jsp"></property> 18 </bean> 19 </beans>
注意:1. line12表示spring監聽的范圍,這里是在com.jackie.springmvc下
2. line15-18,是添加了一個視圖解析器,用於把在控制器中handler的結構解析為實際的物理視圖,這個要配合controller類來解析,詳見下面。
HelloWorld.java(com.jackie.springmvc.handlers下)
1 package com.jackie.springmvc.handlers; 2 3 import org.springframework.stereotype.Controller; 4 import org.springframework.web.bind.annotation.RequestMapping; 5 6 @Controller 7 public class HelloWorld { 8 9 /** 10 * 1. 使用RequestMapping注解來映射請求的URL 11 * 2. 返回值會通過視圖解析器解析為實際的物理視圖, 對於InternalResourceViewResolver視圖解析器,會做如下解析 12 * 通過prefix+returnVal+suffix 這樣的方式得到實際的物理視圖,然后會轉發操作 13 * "/WEB-INF/views/success.jsp" 14 * @return 15 */ 16 @RequestMapping("/helloworld") 17 public String hello(){ 18 System.out.println("hello world"); 19 return "success"; 20 } 21 }
注意:1. 首先要在類的前面添加“Controller”注解,表示是spring的控制器,這里會寫一個方法hello()
2. hello方法上方有一個@RequestMapping, 是用於匹配請求的路徑,比如這里匹配的請求路徑就是“http://localhost:8080/springTest/springmvc/helloworld”,即當tomcat服務啟動后,在瀏覽器輸入這個url時,如果在這個方法打斷點了,就會跳入該方法。
3. 這個return的結果不是亂寫的,這個返回的字符串就是與上面springmvc.xml中line15-18進行配合的,springmvc.xml中聲明了prefix和suffix,而夾在這兩者之間的就是這里返回的字符串,所以執行完這個方法后,我們可以得到這樣的請求資源路徑“/WEB-INF/views/success.jsp”,這個success.jsp是需要我們新建的
index.jsp(WebContent下)
在新建success.jsp之前,我們需要有一個入口,也就是這里的index.jsp
1 <%@ page language="java" contentType="text/html; charset=UTF-8" 2 pageEncoding="UTF-8"%> 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 4 <html> 5 <head> 6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7 <title>Insert title here</title> 8 </head> 9 <body> 10 11 <a href="helloworld">hello world</a> 12 13 </body> 14 </html>
當訪問index.jsp時,頁面上會展示一個超鏈接,點擊超鏈后,url中的地址就會發生跳轉,由“http://localhost:8080/springTest/index.jsp”跳轉到“http://localhost:8080/springTest/helloworld”,而這個url請求就會進入HelloWorld中的hello方法,因為其與該方法上的“/helloworld”匹配。
success.jsp(WEB-INF/views下)
該頁面是作為請求成功后的相應頁面

1 <%@ page language="java" contentType="text/html; charset=ISO-8859-1" 2 pageEncoding="ISO-8859-1"%> 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 4 <html> 5 <head> 6 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 7 <title>Insert title here</title> 8 </head> 9 <body> 10 11 <h4>Success Page</h4> 12 13 </body> 14 </html>
至此,我們完成了基於Spring mvc框架的HelloWorld程序的開發,包括要依賴的jar包,配置的文件,控制器代碼的編寫和展示頁面的編寫等。
除此以外,再介紹下整個配置過程中遇到的一些小問題:
1. tomcat服務器的添加
從前面的介紹可以看出,我們的程序是通過瀏覽器發請求來獲取想要的頁面,那么這里就免不了要有一個web服務器,這里就是tomcat。
首先你需要下載個tomcat,然后在eclipse->windows->preference->servers中綁定這個tomcat服務器;
其次你需要在你新建的spring mvc項目中添加tomcat的支持,否則在新建的jsp文件中會提示報錯“The superclass javax.servlet.http.HttpServlet was not found on the Java Build Path”
右鍵項目->build path->configure build path->add library->server runtime, 選擇你的tomcat即可
有了tomcat服務器,你就可以在index.jsp上右鍵run on server,選擇你的tomcat服務器,這樣就可以啟動tomcat服務,幫助你完成網頁的請求和響應操作。
2. spring mvc如何訪問靜態資源
關於使用spring mvc處理靜態資源,比如html(發現之前的springmvc.xml中<property name = "suffix" value = ".jsp"></property>定義為jsp結尾就可以成功跳轉,但是如果改為html並在web-inf下面新建了html文件后,並將suffix這里的".jsp"改為".html",無法跳轉到想要的html頁面,並且給出404錯誤,同時console給出錯誤信息為:No mapping found for HTTP request with URI [/springTest/WEB-INF/views/result.html] in DispatcherServ)
最后發現是需要讓spring明確要處理靜態資源,原來的web.xml中只有
1 <servlet-mapping> 2 <servlet-name>springDispatcherServlet</servlet-name> 3 <url-pattern>/</url-pattern> 4 </servlet-mapping>
其匹配的都是controller中類似@RequestMapping("/springmvc/helloworld")這樣的注解配置的請求,而對於類似html/css/jpg等資源的訪問就會得不到,所以需要在web.xml中加入以下類型的支持
1 <servlet-mapping> 2 <servlet-name>default</servlet-name> 3 <url-pattern>*.css</url-pattern> 4 </servlet-mapping> 5 6 <servlet-mapping> 7 <servlet-name>default</servlet-name> 8 <url-pattern>*.gif</url-pattern> 9 </servlet-mapping> 10 11 <servlet-mapping> 12 <servlet-name>default</servlet-name> 13 <url-pattern>*.jpg</url-pattern> 14 </servlet-mapping> 15 16 <servlet-mapping> 17 <servlet-name>default</servlet-name> 18 <url-pattern>*.js</url-pattern> 19 </servlet-mapping> 20 21 <servlet-mapping> 22 <servlet-name>default</servlet-name> 23 <url-pattern>*.html</url-pattern> 24 </servlet-mapping>
這樣就可以保證spring 能夠攔截並處理靜態資源
這里將HelloWorld.java中的hello方法改為:
@RequestMapping("/helloworld") public String hello(){ System.out.println("hello world"); return "Jackie"; }
Springmvc.xml改為:
class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name = "prefix" value="/WEB-INF/views/"></property> <property name = "suffix" value = ".jpg"></property> </bean>
表示我們可以訪問jpg靜態圖片資源了
(看到圖片如有不適,請通過點贊來緩解症狀~~~)
如果您覺得閱讀本文對您有幫助,請點一下“推薦”按鈕,您的“推薦”將是我最大的寫作動力!如果您想持續關注我的文章,請掃描二維碼,關注JackieZheng的微信公眾號,我會將我的文章推送給您,並和您一起分享我日常閱讀過的優質文章。