Java框架之SpringMVC 03-RequestMapping-請求資料-響應資料
SpringMVC
SpringMVC是一種輕量級的、基於MVC的Web層應用框架。
通過一套 MVC 註解，讓 POJO 成為處理請求的控制器，而無須實現任何介面。
採用了鬆散耦合可插拔元件結構，比其他 MVC 框架更具擴充套件性和靈活性。
優點：
1、天生與Spring框架整合，如：(IOC,AOP)
2、支援Restful風格
3、支援靈活的URL到頁面控制器的對映
4、非常容易與其他檢視技術整合，如:Velocity、FreeMarker等等
5、因為模型資料不存放在特定的API裡，而是放在一個Model裡(Map資料結構實現，因此很容易被其他框架使用)
6、非常靈活的資料驗證、格式化和資料繫結機制、能使用任何物件進行資料繫結，
7、更加簡單、強大的異常處理
8、對靜態資源的支援
9、支援靈活的本地化、主題等解析
常用主要元件
① DispatcherServlet：前端控制器
② Controller：處理器/頁面控制器，做的是MVC中的C的事情，但控制邏輯轉移到前端控制器了，用於對請求進行處理
③ HandlerMapping：請求對映到處理器，找誰來處理，如果對映成功返回一個HandlerExecutionChain物件（包含一個Handler處理器(頁面控制器)物件、多個HandlerInterceptor攔截器物件）
④ View Resolver : 檢視解析器，找誰來處理返回的頁面。把邏輯檢視解析為具體的View,進行這種策略模式，很容易更換其他檢視技術；如InternalResourceViewResolver將邏輯檢視名對映為JSP檢視
⑤ LocalResolver：本地化、國際化
⑥ MultipartResolver：檔案上傳解析器
⑦ HandlerExceptionResolver：異常處理器
Spring MVC 的配置檔案
流程分析
基本步驟:
① 客戶端請求提交到DispatcherServlet
② 由DispatcherServlet控制器查詢一個或多個HandlerMapping，找到處理請求的Controller
③ DispatcherServlet將請求提交到Controller（也稱為Handler）
④ Controller呼叫業務邏輯處理後，返回ModelAndView
⑤ DispatcherServlet查詢一個或多個ViewResoler檢視解析器，找到ModelAndView指定的檢視
⑥ 檢視負責將結果顯示到客戶端
標準的 HTTP 請求報頭
@RequestMapping
1、使用@RequestMapping 註解來對映請求的 URL
@RequestMapping可以應用的地方
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping {…}
請求的方式有
public enum RequestMethod {
GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE
}
@RequestMapping可以為控制器指定可以處理哪些 URL 請求，將該註解中的 value 屬性值對映成URL,客戶端可以通過該URL請求到指定類中的方法。
1）在控制器的類定義或方法定義處都可標註 @RequestMapping
① 標記在類上：提供初步的請求對映資訊。相對於 WEB 應用的根目錄
② 標記在方法上：提供進一步的細分對映資訊。相對於標記在類上的 URL。
2）若類上未標註 @RequestMapping，則方法處標記的 URL 相對於 WEB 應用的根目錄
3）作用：DispatcherServlet 截獲請求後，就通過控制器上 @RequestMapping 提供的對映資訊確定請求所對應的處理方法。
@RequestMapping屬性
value:指定URL路徑
method:指定請求方式
params:指定請求引數
headers:指定請求頭資訊
對映請求引數、請求方式或請求頭
1）@RequestMapping 除了可以使用請求 URL 對映請求外，還可以使用請求方法、請求引數及請求頭來精確對映對應請求
2）@RequestMapping 的 value【重點】、method【重點】、params【瞭解】 及 heads【瞭解】 分別表示請求 URL、請求方式、請求引數及請求頭的對映條件，他們之間是與的關係，聯合使用多個條件可讓請求對映更加精確化。即：需滿足所有對映條件才可匹配到對應方法
3）params 和 headers支援簡單的表示式：
param1: 表示請求必須包含名為 param1 的請求引數
!param1: 表示請求不能包含名為 param1 的請求引數
param1 != value1: 表示請求包含名為 param1 的請求引數，但其值不能為 value1
{"param1=value1", "param2"}: 請求必須包含名為 param1 和param2 的兩個請求引數，且 param1 引數的值必須為 value1
Ant 路徑風格
Ant 風格資源地址支援 3 種匹配符：【瞭解】
?：匹配檔名中的一個字元
*：匹配檔名中的任意字元
**：** 匹配多層路徑
/user/*/**/createUser?? 匹配 /user/xxx/多層/createUserXX
REST
REST是什麼？因為REST的內涵非常豐富，所以很難用一兩句話解釋清楚這個問題。首先，REST是Web自身的架構風格。
參考資料：理解本真的REST架構風格
REST：即 Representational State Transfer。（資源）表現層狀態轉化。是目前最流行的一種網際網路軟體架構。它結構清晰、符合標準、易於理解、擴充套件方便
資源（Resources）：資源是一種看待伺服器的方式。是網路上的一個實體，可以是一段文字、一張圖片，可以用一個URI（統一資源定位符，獨一無二的識別符）指向它，獲取這個資源，訪問它的URI就可以了
表現層：資源的表述（Representation）是一段對於資源在某個特定時刻的狀態的描述，即把資源具體呈現出來的形式， 比如，文字可以用 txt 、JSON 格式表現，甚至可以採用二進位制格式。
狀態轉化（State Transfer）：狀態轉移說的是：在客戶端和伺服器端之間轉移（transfer）代表資源狀態的表述。通過轉移和操作資源的表述，來間接實現操作資源的目的。如：每發出一個請求，就代表了客戶端和伺服器的一次互動過程。HTTP協議，是一個無狀態協議，即所有的狀態都儲存在伺服器端。因此，如果客戶端想要操作伺服器，必須通過某種手段，讓伺服器端發生“狀態轉化”。而這種轉化是建立在表現層之上的，所以就是 “表現層狀態轉化”。
統一介面（Uniform Interface）REST要求，必須通過統一的介面來對資源執行各種操作。對於每個資源只能執行一組有限的操作。例如：HTTP/1.1協議定義了一個操作資源的統一介面。REST還要求，對於資源執行的操作，其操作語義必須由HTTP訊息體之前的部分完全表達，不能將操作語義封裝在HTTP訊息體內部。這樣做是為了提高互動的可見性
超文字驅動（Hypertext Driven）將Web應用看作是一個由很多狀態（應用狀態）組成的有限狀態機。資源之間通過超連結相互關聯，超連結既代表資源之間的關係，也代表可執行的狀態遷移。即：客戶端應該依賴的是超媒體的狀態遷移語義，而不應該對於是否存在某個URI或URI的某種特殊構造方式作出假設。一切都有可能變化，只有超媒體的狀態遷移語義能夠長期保持穩定。
具體對於HTTP來說，就是 HTTP 協議裡面對應的四種常用基本操作：GET 用來獲取資源，POST 用來新建資源，PUT 用來更新資源，DELETE 用來刪除資源。應使用由客戶端定義的請求方式指定對應的某種操作，而不應該通過某種特殊構造方式進行指定
HiddenHttpMethodFilter過濾器
瀏覽器 form 表單只支援 GET 與 POST 請求，HiddenHttpMethodFilter 可以將POST請求轉換為標準的 http 方法以達到REST風格
使用步驟
1. 必須將form表單中的method設定為POST
2. 提交表單時，必須提交"_method"引數，一般使用隱藏域
原因：HiddenHttpMethodFilter過濾器將HttpServletRequest中的getMethod()方法，重寫啦。
<!-- 配置處理請求方式-->
<filter>
<filter-name>hiddenHttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>hiddenHttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
處理請求資料
Spring MVC 框架會將 HTTP 請求的資訊繫結到相應的方法入參中，並根據方法的返回值型別做出相應的後續處理。
可以對方法及方法入參標註相應的註解（ @PathVariable 、@RequestParam、@RequestHeader 等）
@PathVariable請求佔位符
是 Spring3.0 新增的功能，通過 @PathVariable 可以將 URL 中佔位符引數繫結到控制器處理方法的入參中
//@PathVariable 註解可以將請求URL路徑中的請求引數，傳遞到處理請求方法的入參中
// 瀏覽器的請求為: testPathVariable/1001
@RequestMapping(value="/testPathVariable/{id}",method=RequestMethod.DELET)
public String testPathVariable(@PathVariable("id") Integer id) {}
@RequestParam請求引數
如果請求引數與形參不一致時，可以使用@RequestParam註解實現獲取引數值
書寫位置：標註在方法的引數中，springMVC預設會將請求引數注入（繫結）到方法形參中（兩個引數名一致）
一旦使用該註解，必須為相應引數傳引數。如果未傳參，會報錯：400，因為required預設為 true,
value：用於對映請求引數名稱
required：是否必須。預設為 true, 表示請求引數中必須包含對應的引數，若不存在，將丟擲異常
defaultValue: 預設值，當沒有傳遞引數時使用該值作為預設值，不設預設為 null
@RequestMapping(value="/testRequestParam?username=guigu&age=10")
public String testRequestParam(
@RequestParam(value="username") String username,
@RequestParam(value="age",required=false,defaultValue="0") int age){
return "success";
}
@RequestHeader 請求頭
獲取請求頭資訊，請求頭包含了若干個屬性，伺服器可據此獲知客戶端的資訊，通過 @RequestHeader 即可將請求頭中的屬性值繫結到處理方法的入參中
@CookieValue
獲取指定的Cookie資訊，可讓處理方法入參繫結某個 Cookie 值
使用POJO作為引數
Spring MVC 會按請求引數名和 POJO 屬性名進行自動匹配，自動為該物件填充屬性值。支援級聯屬性。
@RequestMapping(value = "/emps",method = RequestMethod.PUT)
public String updateEmp(Employee employee){
employeeDao.save(employee);
return "redirect:/emps";
}
//Spring MVC 會按請求引數名和 Employee 屬性名進行自動匹配， 自動為該物件填充屬性值。支援級聯屬性
配置字元編碼過濾器
<!-- 處理POST請求和響應亂碼-->
<filter>
<filter-name>characterEncodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
GET請求亂碼
- GET請求引數是在地址後面的。我們需要修改tomcat的配置檔案。需要在server.xml檔案修改Connector標籤，新增URIEncoding="utf-8"屬性。
使用Servlet原生API
/**
* 可以使用 Serlvet 原生的 API 作為目標方法的引數 具體支援以下型別
* HttpServletRequest
* HttpServletResponse
* HttpSession
* java.security.Principal
* Locale
* InputStream
* OutputStream
* Reader
* Writer
*/
@RequestMapping("/testServletAPI")
public void testServletAPI(HttpServletRequest request,HttpServletResponse response, Writer out) throws IOException {
System.out.println("testServletAPI, " + request + ", " + response);
out.write("hello springmvc");
}
處理響應資料
2、返回值會通過檢視解析器解析為實際的物理檢視
輸出模型資料型別
1） ModelAndView: 作為返回值型別，響應資料：處理方法返回值型別為 ModelAndView 時, 方法體即可通過該物件新增模型資料
2） String： 作為返回值型別，即為檢視資訊直接找字串對映 URL 路徑，轉發或重定向
3） Map 或 Model: 作為引數，響應資料：入參為 Model、ModelMap 或 Map，處理方法返回時，Map 中的資料會自動新增到模型中。
ModelAndView
控制器處理方法的返回值如果為 ModelAndView, 則其既包含檢視資訊，也包含模型資料資訊。
1） 兩個重要的成員變數:
private Object view; 【檢視資訊】
private ModelMap model; 【模型資料】
2）新增模型資料:
MoelAndView addObject(String attributeName, Object attributeValue) 【設定模型資料】
ModelAndView addAllObject(Map<String, ?> modelMap)
4）設定檢視:
void setView(View view) 【設定檢視物件】
void setViewName(String viewName) 【設定檢視名字】
5）獲取模型資料
protected Map<String, Object> getModelInternal() 【獲取模型資料】
public ModelMap getModelMap()
public Map<String, Object> getModel()
@RequestMapping("/testModelAndView")
public ModelAndView testModelAndView(){
String viewName = "success";
ModelAndView mv = new ModelAndView(viewName);
mv.addObject("time",new Date().toString()); //實質上存放到request域中
return mv;
}
ModelAndView 底層工作原理，不論控制器返回一個String,ModelAndView,View都會轉換為ModelAndView物件，將資料放到request域中，再通過轉發實現頁面跳轉
Map Model
Spring MVC 在內部使用了一個 org.springframework.ui.Model 介面儲存模型資料
Spring MVC 在呼叫方法前會建立一個隱含的模型物件作為模型資料的儲存容器。
如果方法的入參為 Map 或 Model 型別，Spring MVC 會將隱含模型的引用傳遞給這些入參。
在方法體內，開發者可以通過這個入參物件訪問到模型中的所有資料，也可以向模型中新增新的屬性資料
//目標方法的返回型別也可以是一個Map型別引數（也可以是Model,或ModelMap型別）
@RequestMapping("/testMap")
public String testMap(Map<String, Object> map) { //【重點】
System.out.println(map.getClass().getName());
//org.springframework.validation.support.BindingAwareModelMap
map.put("names", Arrays.asList("Tom", "Jerry", "Kite"));
return "success";
}
注意問題：Map集合的泛型，key為String,Value為Object,而不是String
由原始碼可知：不論用那個型別作為資料模型，其內部都會轉化為BindingAwareModelMap型別使其指向同一map物件
BindingAwareModelMap底層支援兩種介面（Map&Model）推薦使用 Map 便於框架移植