springMVC小專案例項
一、什麼是 Spring MVC
Spring MVC 屬於 SpringFrameWork 的後續產品,已經融合在 Spring Web Flow 裡面,是一個強大靈活的 Web 框架。Spring MVC 提供了一個 DispatcherServlet 作為前端控制器來分配請求。通過策略介面,Spring 框架是高度可配置的。Spring MVC 還包含多種檢視技術,如 Java Server Pages(JSP)、Velocity、Tiles、iText 和 POI 等。Spring MVC 分離了控制器、模型物件、分派器以及處理程式物件的角色,這種分離讓它們更容易進行定製。
Spring MVC 框架主要由 DispatcherServlet、處理器對映器、處理器介面卡、處理器(控制器)、檢視解析器、檢視組成。
二、Spring MVC 執行流程
Spring MVC 高層次的請求處理工作流程如下(圖來自 Spring 官網):
細分後,Spring MVC 執行流程如下,共包括八步:
Spring MVC 相關介面解釋:
(1)DispatcherServlet
前端控制器,所有的請求都有經過它來統一分發,請求會被分發給對應的 Handler。
(2)HandlerMapping(處理器對映器)
解析請求連結,然後根據請求連結找到執行這個請求的類(HandlerMapping 所說的 handler)。
(3)HandlerAdapter(處理器介面卡)
呼叫具體的方法對使用者發來的請求來進行處理。
(4)Controller
Controller 將處理使用者請求,Controller 處理完使用者請求,則返回 ModelAndView 物件給 DispatcherServlet 前端控制器。
從巨集觀角度考慮,DispatcherServlet 是整個 Web 應用的控制器;從微觀考慮,Controller 是單個 Http 請求處理過程中的控制器。
(5)ViewResolver(檢視解析器)
解析 MdoelAndView,將 MdoelAndView 中的邏輯檢視名變為一個真正的 View 物件,並將 MdoelAndView 中的 Model 取出。
前面簡單的介紹了 Spring MVC ,下面以簡單的使用者註冊為例,來了解 Spring MVC 的一些基本原理和運用。
三、專案檔案結構
四、開發準備
Spring MVC 的相關檔案放在實驗樓的伺服器中,請開啟實驗環境桌面上的 Xfce ,輸入下面的程式碼獲取:
wget http://labfile.oss.aliyuncs.com/courses/810/Spring-jars.zip
輸入下面的命令解壓 .zip 檔案:
unzip Spring-jars.zip
五、實驗步驟
1 新建專案工程
在 Eclipse 裡新建一個 Web 工程(Dynamic Web Project),命名為 SpringMVCTest
。
注意勾選 “自動生成 web.xml” 這個選項。
將 /home/shiyanlou/Spring-jars/
路徑下的全部 jar 包拷貝到專案的 WebContent/WEB-INF/lib/
目錄下。
2 配置 web.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" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id="WebApp_ID" version="3.0">
<display-name>SpringMVCTest</display-name>
<!-- 配置 Spring MVC DispatchcerServlet 前端控制器 -->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<!-- contextConfigLocation 是引數名稱,該引數的值包含 Spring MVC 的配置檔案路徑 -->
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/springmvc-config.xml</param-value>
</init-param>
<!-- 在 Web 應用啟動時立即載入 Servlet -->
<load-on-startup>1</load-on-startup>
</servlet>
<!-- Servlet 對映宣告 -->
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<!-- 監聽當前域的所有請求 -->
<url-pattern>/</url-pattern>
</servlet-mapping>
<!-- 新增 register.jsp 為首頁 -->
<welcome-file-list>
<welcome-file>register.jsp</welcome-file>
</welcome-file-list>
</web-app>
在 web.xml 中配置了 DispatchcerServlet
,DispatchcerServlet 載入時需要一個 Spring MVC 的配置檔案,預設會去 WEB-INF
下查詢對應的 [servlet-name]-servlet.xml
檔案,如本例中預設查詢的是 springmvc-servlet.xml
。
Spring MVC 的配置檔案可以放在任何地方,用 servlet 的子元素 init-param
描述即可,見上述示例程式碼,這時 DispatchcerServlet 就會去查詢 /WEB-INF/springmvc-config.xml
。
3 springmvc-config.xml 檔案
在 WebContent/WEB-INF/
目錄下新建 Spring MVC 配置檔案 springmvc-config.xml
,配置 Spring MVC 的 Controller,新增如下程式碼:
<?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-4.2.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd
http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd">
<context:annotation-config />
<!-- 配置自動掃描的包,完成 Bean 的建立和自動依賴注入的功能 -->
<context:component-scan base-package="com.shiyanlou.springmvc.controller" />
<!-- 這兩個類用來配置 annotation 型別的處理器對映器和處理器介面卡 -->
<bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping" />
<bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter" />
<!-- 配置檢視解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
上述配置檔案中, Spring 使用了掃描機制查詢應用程式所有基於註解的控制器類,在本例中,掃描的是 com.shiyanlou.springmvc.controller
包及其子包下的所有 Java 檔案。
同時配置了 annatation 型別的處理器對映器 DefaultAnnotationHandlerMapping 和處理器介面卡 AnnotationMethodHandlerAdapter,DefaultAnnotationHandlerMapping 根據請求查詢對映,AnnotationMethodHandlerAdapter 完成對控制器類的 @RequestMapping 標註方法(下面會介紹)的呼叫。
最後配置的檢視解析器 InternalResourceViewResolver 用來解析檢視,將 View 呈現給使用者。檢視解析器中配置的 prefix
表示檢視的字首, suffix
表示檢視的字尾。
注:在 Spring4.0 之後,如果不配置處理對映器、處理器介面卡和檢視解析器,會使用預設的。
4 實體類 User
在專案目錄 /Java Resources/src
的包 com.shiyanlou.springmvc.entity
下新建類 User.java
,包含 id、username、password 和 age 屬性,程式碼如下:
package com.shiyanlou.springmvc.entity;
import java.io.Serializable;
public class User implements Serializable {
private static final long serialVersionUID = 1L;
private Integer id;
private String username;
private String password;
private Integer age;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
}
5 Controller 類的實現
在包 com.shiyanlou.springmvc.controller
下新建 Controller 類 UserController.java
,具體解釋註釋已經給出,程式碼如下:
package com.shiyanlou.springmvc.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import com.shiyanlou.springmvc.entity.User;
/**
* UserController 是一個基於註解的控制器
* 可以同時處理多個請求動作
*/
@Controller
public class UserController {
/**
* RequestMapping 用來對映一個請求和請求的方法
* value="/register" 表示請求由 register 方法進行處理
*/
@RequestMapping(value="/register")
public String Register(@ModelAttribute("form") User user, Model model) { // user:檢視層傳給控制層的表單物件;model:控制層返回給檢視層的物件
// 在 model 中新增一個名為 "user" 的 user 物件
model.addAttribute("user", user);
// 返回一個字串 " success" 作為檢視名稱
return "success";
}
}
6 JSP 頁面
(1)register.jsp
在 WebContent
目錄下新建一個 JSP 頁面命名為 register.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>register page</title>
</head>
<body>
<form action="register" method="post">
<h5>User registration</h5>
<p>
<label>name </label> <input type="text" id="username" name="username"
tabindex="1">
</p>
<p>
<label>password </label> <input type="text" id="password" name="password"
tabindex="2">
</p>
<p>
<label>age </label> <input type="text" id="age" name="age"
tabindex="3">
</p>
<p id="buttons">
<input id="submit" type="submit" tabindex="4" value="register">
<input id="reset" type="reset" tabindex="5" value="reset">
</p>
</form>
</body>
</html>
(2)success.jsp
在 WebContent/WEB-INF
目錄下新建資料夾 views
,並在該路徑下新建一個 JSP 頁面命名為 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=UTF-8">
<title>success page</title>
</head>
<body>
<h5>login was successful</h5>
<p>
name:${requestScope.user.username}<br /> password:${requestScope.user.password}<br /> age:${requestScope.user.age}<br />
</p>
</body>
</html>
7 執行測試
注:由於線上環境的資源問題,這裡啟動 tomcat 比較慢,需要大家耐心等待幾分鐘。如果遇到 Tomcat 啟動超時的問題,請按照下圖的方法延長 Tomcat 的啟動時間。
右擊 SpringMVCTest 工程,Run As->Run on Server,保持預設選項不變,點選 Finish,一會兒即可看到結果:
輸入註冊資訊,點選註冊按鈕,結果如下: