硬核！學會SpringMVC從這篇開始

作者：蔡不菜丶 2020-08-21 08:22:24

開發架構

Spring 為展現層提供的基于 MVC 設計理念的優秀的Web 框架，是目前最主流的 MVC框架之一。

[[338738]]

本文轉載自微信公眾號「小菜良記」，作者蔡不菜丶。轉載本文請聯系小菜良記公眾號。

SpringMVC概述

Spring 為展現層提供的基于 MVC 設計理念的優秀的Web 框架，是目前最主流的 MVC框架之一
Spring3.0 后全面超越 Struts2，成為最優秀的 MVC 框架
Spring MVC 通過一套 MVC 注解，讓 POJO 成為處理請求的控制器，而無須實現任何接口。
支持 REST 風格的 URL 請求
采用了松散耦合可插拔組件結構，比其他 MVC 框架更具擴展性和靈活性

SpringMVC簡單使用

1)在 web.xml 中配置 DispatcherServlet：

<!-- 配置 DispatcherServlet --> 
 <servlet> 
  <servlet-name>dispatcherServlet</servlet-name> 
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
  <!-- 配置 DispatcherServlet 的一個初始化參數: 配置 SpringMVC 配置文件的位置和名稱 --> 
  <!--  
   實際上也可以不通過 contextConfigLocation 來配置 SpringMVC 的配置文件, 而使用默認的. 
   默認的配置文件為: /WEB-INF/<servlet-name>-servlet.xml 
  --> 
  <init-param> 
   <param-name>contextConfigLocation</param-name> 
   <param-value>classpath:springmvc.xml</param-value> 
  </init-param> 
  <load-on-startup>1</load-on-startup> 
 </servlet> 
 <servlet-mapping> 
  <servlet-name>dispatcherServlet</servlet-name> 
  <url-pattern>/</url-pattern> 
 </servlet-mapping>

2)加入 Spring MVC 的配置文件

<?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="cbuc.life.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>

3)編寫處理請求的處理器，并使用**@Controller** 注解標識為處理器

@Controller 
public class HelloWorldController { 
 /** 
    1. 使用 @RequestMapping 注解來映射請求的 URL 
    2. 返回值會通過視圖解析器解析為實際的物理視圖, 對于 InternalResourceViewResolver 視圖解析器, 會做如下的解析: 
       通過 prefix + returnVal + 后綴 這樣的方式得到實際的物理視圖, 然會做轉發操作 
       ==> /WEB-INF/views/success.jsp 
  */ 
 @RequestMapping("/helloworld") 
 public String hello(){ 
  System.out.println("hello world"); 
  return "success"; 
 } 
}

4) 編寫視圖

JSP在/WEB-INF/views/目錄下創建一個succes.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
<!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>Insert title here</title> 
</head> 
<body> 
 <h1>成功跳轉頁面</h1> 
</body> 
</html>

5)將項目運行起來訪問：localhost:8080/hellowoorld

使用 @RequestMapping 映射請求

Spring MVC 使用 @RequestMapping 注解為控制器指定可以處理哪些 URL 請求
在控制器的類定義及方法定義處都可標注
- 類定義：提供初步的請求映射信息。相對于 WEB 應用的根目錄
- 方法：提供進一步的細分映射信息。相對于類定義處的 URL。若類定義處未標注 @RequestMapping，則方法處標記的 URL 相對于WEB 應用的根目錄
DispatcherServlet 截獲請求后，就通過控制器上@RequestMapping 提供的映射信息確定請求所對應的處理方法。

1)標準請求頭

2)@RequestMapping

@RequestMapping 的value、method、params 及 heads 分別表示*請求 URL***、請求方法、請求參數***及***請求頭的映射條件，他們之間是與的關系，聯合使用多個條件可讓請求映射更加精確化。

/** 
  * 可以使用 params 和 headers 來更加精確的映射請求. params 和 headers 支持簡單的表達式. 
  *  
  * @return 
  */ 
 @RequestMapping(value = "testParamsAndHeaders", 
     params = { "username","age!=10" }, 
     headers = { "Accept-Language=en-US,zh;q=0.8" }, 
     method = RequestMethod.POST) 
 public String test() { 
  System.out.println("test..."); 
  return "success"; 
 }

3)支持Ant 風格

? ：匹配文件名中的一個字符

/user/createUser?

匹配 /user/createUsera 或者 user/createUserb 等 URL

* ：匹配文件名中的任意字符

/user/*/createUser

匹配 /user/aaa/createUser 或者 /user/bbb/createUser 等 URL

** ：匹配多層路徑

/user/**/createUser

匹配 /user/createUser 或者 /user/aaa/bbb/createUser 等 URL

@PathVariable

映射 URL 綁定的占位符

帶占位符的 URL 是 Spring3.0 新增的功能，該功能在 SpringMVC 向 REST 目標挺進發展過程中具有里程碑的意義
通過@PathVariable可以將 URL 中占位符參數綁定到控制器處理方法的入參中：URL 中的 {xxx} 占位符可以通過@PathVariable("xxx") 綁定到操作方法的入參中。

/** 
 * @PathVariable 可以來映射 URL 中的占位符到目標方法的參數中. 
 */ 
@RequestMapping("/testPathVariable/{id}") 
public String test(@PathVariable("id") Integer id) { 
 System.out.println("id: " + id); 
 return "success"; 
}

REST風格

REST：即 Representational State Transfer。(資源)表現層狀態轉化。是目前最流行的一種互聯網軟件架構。它結構清晰、符合標準、易于理解、擴展方便，所以正得到越來越多網站的采用

示例：

/order/1 HTTP GET ：得到 id = 1 的 order 記錄
/order/1 HTTP DELETE：刪除 id = 1的 order 記錄
/order/1 HTTP PUT：更新 id = 1的 order 記錄
/order HTTP POST：新增一條order記錄

@RequestParam 綁定請求參數值

在處理方法入參處使用 @RequestParam 可以把請求參數傳遞給請求方法
- value：參數名
- required：是否必須;默認為 true，表示請求參數中必須包含對應的參數，若不存在，將拋出異常

/** 
 * @RequestParam 來映射請求參數. value 值即請求參數的參數名 required 該參數是否必須. 默認為 true 
 *               defaultValue 請求參數的默認值 
 */ 
@RequestMapping(value = "/testRequestParam") 
public String testRequestParam( 
  @RequestParam(value = "username") String username, 
  @RequestParam(value = "age", required = false, defaultValue = "0") int age) { 
 System.out.println("testRequestParam, username: " + username + ", age: " + age); 
 return "success"; 
}

@RequestHeader 綁定請求報頭的屬性值

/** 
 *   映射請求頭信息 用法同 @RequestParam 
 */ 
@RequestMapping("/testRequestHeader") 
public String testRequestHeader( 
  @RequestHeader(value = "Accept-Language") String al) { 
 System.out.println("testRequestHeader, Accept-Language: " + al); 
 return "success"; 
}

@CookieValue 綁定請求中的 Cookie 值

/** 
 * @CookieValue: 映射一個 Cookie 值. 屬性同 @RequestParam 
 */ 
@RequestMapping("/testCookieValue") 
public String testCookieValue(@CookieValue("JSESSIONID") String sessionId) { 
 System.out.println("testCookieValue: sessionId: " + sessionId); 
 return "success"; 
}

POJO 對象綁定請求參數值

/** 
 * Spring MVC 會按請求參數名和 POJO 屬性名進行自動匹配， 自動為該對象填充屬性值。支持級聯屬性。 
 * 如：dept.deptId、dept.address.tel 等 
 */ 
@RequestMapping("/testPojo") 
public String testPojo(User user) { 
 System.out.println("testPojo: " + user); 
 return "success"; 
}

MVC 中Handler 方法可以接收的ServletAPI 類型的參數

HttpServletRequest
HttpServletResponse
HttpSession
Writer
java.security.Principal
Locale
InputStream
OutputStream
Reader

處理模型數據

1)ModelAndView

處理方法返回值類型為 ModelAndView時，方法體可通過該對象添加模型數據，ModelAndView中既包含視圖信息，也包含模型數據信息。

2)Map 及 Model

入參為 org.springframework.ui.Model、org.springframework.ui.ModelMap 或java.uti.Map 時，處理方法返回時，Map 中的數據會自動添加到模型中。

3)@SessionAttributes:

將模型中的某個屬性暫存到HttpSession中，以便多個請求之間可以共享這個屬性(從session域中獲取)

若希望在多個請求之間共用某個模型屬性數據，則可以在控制器類上標注一個 @SessionAttributes，Spring MVC 將在模型中對應的屬性暫存到 HttpSession 中。
@SessionAttributes除了可以通過屬性名指定需要放到會話中的屬性外，還可以通過模型屬性的對象類型指定哪些模型屬性需要放到會話中

1)@SessionAttributes(types=User.class)：會將隱含模型中所有類型為 User.class 的屬性添加到會話中

2)@SessionAttributes(value={“user1”, “user2”})：會將隱含模型中對象名為user1，user2 的屬性添加到會話中

3)@SessionAttributes(types={User.class, Dept.class})：會將隱含模型中所有類型為User.class，Dept.class 的屬性添加到會話中

4)@SessionAttributes(value={“user1”, “user2”}, types={Dept.class})：會將隱含模型中對象名為user1，user2 的屬性和所有類型為 Dept.class 的屬性添加到會話中

4)@ModelAttribute

方法入參標注該注解后, 入參的對象就會放到數據模型中

@ModelAttribute

在方法定義上使用 @ModelAttribute 注解：Spring MVC在調用目標處理方法前，會先逐個調用在方法級上標注了@ModelAttribute 的方法。
在方法的入參前使用 @ModelAttribute 注解：
- 可以從隱含對象中獲取隱含的模型數據中獲取對象，再將請求參數綁定到對象中，再傳入入參
- 將方法入參對象添加到模型中

示例：

視圖和視圖解析器

請求處理方法執行完成后，最終返回一個 ModelAndView 對象。對于那些返回String，View 或 ModeMap 等類型的處理方法，Spring MVC 也會在內部將它們裝配成一個 ModelAndView 對象，它包含了邏輯名和模型對象的視圖。
Spring MVC 借助視圖解析器(ViewResolver)得到最終的視圖對象(View)，最終的視圖可以是 JSP，也可能是 Excel、JFreeChart等各種表現形式的視圖。
對于最終究竟采取何種視圖對象對模型數據進行渲染，處理器并不關心，處理器工作重點聚焦在生產模型數據的工作上，從而實現 MVC 的充分解耦。

視圖

我們只需要實現View這個接口就可以自定義視圖

示例：

@Component 
public class HelloView implements View{ 
 @Override 
 public String getContentType() { 
  return "text/html"; 
 } 
 @Override 
 public void render(Map<String, ?> model, HttpServletRequest request, 
   HttpServletResponse response) throws Exception { 
  response.getWriter().print("hello view, time: " + new Date()); 
 } 
} 
@RequestMapping("/testView") 
 public String testView(){ 
  System.out.println("testView"); 
  return "helloView"; //這里返回的就是我們自定義的視圖 
 }

視圖解析器

SpringMVC 為邏輯視圖名的解析提供了不同的策略，可以在 Spring WEB 上下文中配置***一種***或***多種***解析策略，并指定他們之間的***先后順序***。每一種映射策略對應一個具體的視圖解析器實現類。
視圖解析器的作用比較單一，將邏輯視圖解析為一個具體的視圖對象。
所有的視圖解析器都必須實現 ViewResolver 接口。
程序員可以選擇一種視圖解析器或混用多種視圖解析器。
每個視圖解析器都實現了Ordered接口并開放出一個 order 屬性，可以通過order 屬性指定解析器的優先順序，order 越小優先級越高。
SpringMVC 會按視圖解析器順序的優先順序對邏輯視圖名進行解析，直到解析成功并返回視圖對象，否則將拋出 ServletException 異常

SpringMVC.xml中的配置：

<!-- 配置視圖解析器: 如何把 handler 方法返回值解析為實際的物理視圖 --> 
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 
 <property name="prefix" value="/WEB-INF/views/"></property> 
 <property name="suffix" value=".jsp"></property> 
</bean> 
  
<!-- 配置視圖  BeanNameViewResolver 解析器: 使用視圖的名字來解析視圖 --> 
<!-- 通過 order 屬性來定義視圖解析器的優先級, order 值越小優先級越高 --> 
<bean class="org.springframework.web.servlet.view.BeanNameViewResolver"> 
 <property name="order" value="100"></property> 
</bean>

責任編輯：武曉燕來源：小菜良記

Spring MVC