硬核!學(xué)會SpringMVC從這篇開始
本文轉(zhuǎn)載自微信公眾號「小菜良記」,作者蔡不菜丶 。轉(zhuǎn)載本文請聯(lián)系小菜良記公眾號。
SpringMVC概述
- Spring 為展現(xiàn)層提供的基于 MVC 設(shè)計理念的優(yōu)秀的Web 框架,是目前最主流的 MVC框架之一
- Spring3.0 后全面超越 Struts2,成為最優(yōu)秀的 MVC 框架
- Spring MVC 通過一套 MVC 注解,讓 POJO 成為處理請求的控制器,而無須實現(xiàn)任何接口。
- 支持 REST 風(fēng)格的 URL 請求
- 采用了松散耦合可插拔組件結(jié)構(gòu),比其他 MVC 框架更具擴展性和靈活性
SpringMVC簡單使用
1)在 web.xml 中配置 DispatcherServlet:
- <!-- 配置 DispatcherServlet -->
- <servlet>
- <servlet-name>dispatcherServlet</servlet-name>
- <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
- <!-- 配置 DispatcherServlet 的一個初始化參數(shù): 配置 SpringMVC 配置文件的位置和名稱 -->
- <!--
- 實際上也可以不通過 contextConfigLocation 來配置 SpringMVC 的配置文件, 而使用默認(rèn)的.
- 默認(rèn)的配置文件為: /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** 注解標(biāo)識為處理器
- @Controller
- public class HelloWorldController {
- /**
- 1. 使用 @RequestMapping 注解來映射請求的 URL
- 2. 返回值會通過視圖解析器解析為實際的物理視圖, 對于 InternalResourceViewResolver 視圖解析器, 會做如下的解析:
- 通過 prefix + returnVal + 后綴 這樣的方式得到實際的物理視圖, 然會做轉(zhuǎn)發(fā)操作
- ==> /WEB-INF/views/success.jsp
- */
- @RequestMapping("/helloworld")
- public String hello(){
- System.out.println("hello world");
- return "success";
- }
- }
4) 編寫視圖
JSP在/WEB-INF/views/目錄下創(chuàng)建一個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>成功跳轉(zhuǎn)頁面</h1>
- </body>
- </html>
5)將項目運行起來訪問 :localhost:8080/hellowoorld
使用 @RequestMapping 映射請求
- Spring MVC 使用 @RequestMapping 注解為控制器指定可以處理哪些 URL 請求
- 在控制器的類定義及方法定義處都可標(biāo)注
- 類定義:提供初步的請求映射信息。相對于 WEB 應(yīng)用的根目錄
- 方法:提供進一步的細分映射信息。相對于類定義處的 URL。若類定義處未標(biāo)注 @RequestMapping,則方法處標(biāo)記的 URL 相對于WEB 應(yīng)用的根目錄
- DispatcherServlet 截獲請求后,就通過控制器上@RequestMapping 提供的映射信息確定請求所對應(yīng)的處理 方法。
1)標(biāo)準(zhǔn)請求頭
2)@RequestMapping
@RequestMapping 的value、method、params 及 heads 分別表示*請求 URL***、請求方法、請求參數(shù)***及***請求頭的映射條件,他們之間是與的關(guān)系,聯(lián)合使用多個條件可讓請求映射更加精確化。
- /**
- * 可以使用 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 風(fēng)格
- ? :匹配文件名中的一個字符
/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 目標(biāo)挺進發(fā)展過程中具有里程碑的意義
- 通過@PathVariable可以將 URL 中占位符參數(shù)綁定到控制器處理方法的入?yún)⒅校篣RL 中的 {xxx} 占位符可以通過@PathVariable("xxx") 綁定到操作方法的入?yún)⒅小?/li>
- /**
- * @PathVariable 可以來映射 URL 中的占位符到目標(biāo)方法的參數(shù)中.
- */
- @RequestMapping("/testPathVariable/{id}")
- public String test(@PathVariable("id") Integer id) {
- System.out.println("id: " + id);
- return "success";
- }
REST風(fēng)格
REST:即 Representational State Transfer。(資源)表現(xiàn)層狀態(tài)轉(zhuǎn)化。是目前最流行的一種互聯(lián)網(wǎng)軟件架構(gòu)。它結(jié)構(gòu)清晰、符合標(biāo)準(zhǔn)、易于理解、擴展方便, 所以正得到越來越多網(wǎng)站的采用
示例:
- /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 綁定請求參數(shù)值
- 在處理方法入?yún)⑻幨褂?@RequestParam 可以把請求參數(shù)傳遞給請求方法
- value:參數(shù)名
- required:是否必須;默認(rèn)為 true,表示請求參數(shù)中必須包含對應(yīng)的參數(shù),若不存在,將拋出異常
- /**
- * @RequestParam 來映射請求參數(shù). value 值即請求參數(shù)的參數(shù)名 required 該參數(shù)是否必須. 默認(rèn)為 true
- * defaultValue 請求參數(shù)的默認(rèn)值
- */
- @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 對象綁定請求參數(shù)值
- /**
- * Spring MVC 會按請求參數(shù)名和 POJO 屬性名進行自動匹配, 自動為該對象填充屬性值。支持級聯(lián)屬性。
- * 如:dept.deptId、dept.address.tel 等
- */
- @RequestMapping("/testPojo")
- public String testPojo(User user) {
- System.out.println("testPojo: " + user);
- return "success";
- }
MVC 中Handler 方法可以接收的ServletAPI 類型的參數(shù)
- HttpServletRequest
- HttpServletResponse
- HttpSession
- Writer
- java.security.Principal
- Locale
- InputStream
- OutputStream
- Reader
處理模型數(shù)據(jù)
1)ModelAndView
處理方法返回值類型為 ModelAndView時,方法體可通過該對象添加模型數(shù)據(jù),ModelAndView中既包含視圖信息,也包含模型數(shù)據(jù)信息。
2)Map 及 Model
入?yún)?org.springframework.ui.Model、org.springframework.ui.ModelMap 或java.uti.Map 時,處理方法返回時,Map 中的數(shù)據(jù)會自動添加到模型中。
3)@SessionAttributes:
將模型中的某個屬性暫存到HttpSession中,以便多個請求之間可以共享這個屬性(從session域中獲取)
- 若希望在多個請求之間共用某個模型屬性數(shù)據(jù),則可以在 控制器類上標(biāo)注一個 @SessionAttributes,Spring MVC 將在模型中對應(yīng)的屬性暫存到 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
方法入?yún)?biāo)注該注解后, 入?yún)⒌膶ο缶蜁诺綌?shù)據(jù)模型中
@ModelAttribute
- 在方法定義上使用 @ModelAttribute 注解:Spring MVC在調(diào)用目標(biāo)處理方法前,會先逐個調(diào)用在方法級上標(biāo)注了@ModelAttribute 的方法。
- 在方法的入?yún)⑶笆褂?@ModelAttribute 注解:
- 可以從隱含對象中獲取隱含的模型數(shù)據(jù)中獲取對象,再將請求參數(shù)綁定到對象中,再傳入入?yún)?/li>
- 將方法入?yún)ο筇砑拥侥P椭?/li>
示例:
視圖和視圖解析器
- 請求處理方法執(zhí)行完成后,最終返回一個 ModelAndView 對象。對于那些返回String,View 或 ModeMap 等類型的處理方法,Spring MVC 也會在內(nèi)部將它們裝配成一個 ModelAndView 對象,它包含了邏輯名和模型對象的視圖。
- Spring MVC 借助視圖解析器(ViewResolver)得到最終的視圖對象(View),最終的視圖可以是 JSP,也可能是 Excel、JFreeChart等各種表現(xiàn)形式的視圖。
- 對于最終究竟采取何種視圖對象對模型數(shù)據(jù)進行渲染,處理器并不關(guān)心,處理器工作重點聚焦在生產(chǎn)模型數(shù)據(jù)的工 作上,從而實現(xiàn) MVC 的充分解耦。
視圖
我們只需要實現(xiàn)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 上下文中配置***一種***或***多種***解析策略,并指定他們之間的***先后順序***。每一種映射策略對應(yīng)一個具體的視圖解析器實現(xiàn)類。
- 視圖解析器的作用比較單一,將邏輯視圖解析為一個具體的視圖對象。
- 所有的視圖解析器都必須實現(xiàn) ViewResolver 接口。
- 程序員可以選擇一種視圖解析器或混用多種視圖解析器。
- 每個視圖解析器都實現(xiàn)了Ordered接口并開放出一個 order 屬性,可 以通過order 屬性指定解析器的優(yōu)先順序,order 越小優(yōu)先級越高。
- SpringMVC 會按視圖解析器順序的優(yōu)先順序?qū)壿嬕晥D名進行解析,直到解析成功并返回視圖對象,否則將拋出 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 屬性來定義視圖解析器的優(yōu)先級, order 值越小優(yōu)先級越高 -->
- <bean class="org.springframework.web.servlet.view.BeanNameViewResolver">
- <property name="order" value="100"></property>
- </bean>