Spring學習筆記 使用SpringMVC搭建第一個專案
近來公司沒什麼新的專案,於是打算抽時間看看java著名的三大框架Struts、Hibernate、Spring;之前看了Struts,從今天起,準備好好審視並學習Spring mvc,學習Spring mvc的第一步,當然是環境的搭建以及一個可以執行的最簡單的helloworld專案了。
什麼是Spring MVC
Spring MVC屬於SpringFrameWork的後續產品,已經融合在Spring Web Flow裡面。Spring 框架提供了構建 Web 應用程式的全功能 MVC 模組。使用 Spring 可插入的 MVC 架構,從而在使用Spring進行WEB開發時,可以選擇使用Spring的SpringMVC框架或整合其他MVC開發框架,如Struts1,Struts2等。
環境配置
Eclipse:Mars Release (4.5.0)
Apache-Tomcat:8.0.38
JDK:1.8
Spring-framework: 4.2.6.RELEASE
- 搭建專案
1.新建專案:File-New,選擇Dynamic web project,並取專案名稱為MySpringMvc
2.新增配置檔案:在WEB-INF資料夾下面新增web.xml和springmvc.xml檔案:
web.xml檔案:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
id="WebApp_ID" version="2.5">
<!-- 配置DispatchcerServlet -->
<servlet>
<servlet-name >springDispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 配置Spring mvc下的配置檔案的位置和名稱 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/springmvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springDispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</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檔案:
<?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:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
<!-- 配置自動掃描的包 -->
<context:component-scan base-package="com.shi.springmvc"></context:component-scan>
<!-- 配置檢視解析器 如何把handler 方法返回值解析為實際的物理檢視 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name = "prefix" value="/WEB-INF/views/"></property>
<property name = "suffix" value = ".jsp"></property>
</bean>
</beans>
注意:1. line12表示spring監聽的範圍,這裡是在com.shi.springmvc下
2. line15-18,是添加了一個檢視解析器,用於把在控制器中handler的結構解析為實際的物理檢視,這個要配合controller類來解析。
3.新增Spring-framework框架相關jar包:
4.在WebContent資料夾下面新增index.jsp檔案:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>介面標題</title>
</head>
<body>
<a href="helloworld">hello world</a>
</body>
</html>
4.在WEB-INF/views/下面新增success.jsp檔案:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>成功介面</title>
</head>
<body>
<h4>恭喜您成功了</h4>
</body>
</html>
5.建立helloworld類(包名com.shi.springmvc.handlers下):
package com.shi.springmvc.handlers;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HelloWorld {
/**
* 1. 使用RequestMapping註解來對映請求的URL 2. 返回值會通過檢視解析器解析為實際的物理檢視,
* 對於InternalResourceViewResolver檢視解析器,會做如下解析 通過prefix+returnVal+suffix
* 這樣的方式得到實際的物理檢視,然後會轉發操作 "/WEB-INF/views/success.jsp"
*
* @return
*/
@RequestMapping("/helloworld")
public String hello() {
System.out.println("hello world");
return "success";
}
}
注意:1. 首先要在類的前面新增“Controller”註解,表示是spring的控制器,這裡會寫一個方法hello()
2. hello方法上方有一個@RequestMapping, 是用於匹配請求的路徑,比如這裡匹配的請求路徑就是“http://localhost:8080/MySpringMvc/helloworld”,即當tomcat服務啟動後,在瀏覽器輸入這個url時,如果在這個方法打斷點了,就會跳入該方法。
3. 這個return的結果不是亂寫的,這個返回的字串就是與上面springmvc.xml中line15-18進行配合的,springmvc.xml中聲明瞭prefix和suffix,而夾在這兩者之間的就是這裡返回的字串,所以執行完這個方法後,我們可以得到這樣的請求資源路徑“/WEB-INF/views/success.jsp”,這個success.jsp是需要我們建立的。
-兩個值得注意的問題
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即可
spring mvc如何訪問靜態資源
關於使用spring mvc處理靜態資源,比如html(發現之前的springmvc.xml中定義為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中只有
<servlet-mapping>
<servlet-name>springDispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
其匹配的都是controller中類似@RequestMapping(“/springmvc/helloworld”)這樣的註解配置的請求,而對於類似html/css/jpg等資源的訪問就會得不到,所以需要在web.xml中加入以下型別的支援
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.css</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.gif</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.png</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.js</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.html</url-pattern>
</servlet-mapping>
這樣就可以保證spring 能夠攔截並處理靜態資源了。
這裡將HelloWorld.java中的hello方法改為:
@RequestMapping("/helloworld")
public String hello(){
System.out.println("hello world");
return "success";
}
Springmvc.xml改為:
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name = "prefix" value="/WEB-INF/views/"></property>
<property name = "suffix" value = ".png"></property>
</bean>
這樣我們就能夠訪問png靜態圖片資源了