SpringMVC入門案例:HelloWorld
本文摘自:http://www.cnblogs.com/bigdataZJ/p/springmvc1.html
軟件參數
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包放入其中。
配置文件及編寫代碼
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. [email protected]， 是用於匹配請求的路徑，比如這裏匹配的請求路徑就是“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>
[email protected]("/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靜態圖片資源了
SpringMVC入門案例:HelloWorld