Java框架之SpringMVC 03-RequestMapping-請求數據-響應數據

SpringMVC SpringMVC是一種輕量級的、基於MVC的Web層應用框架。通過一套 MVC 註解，讓 POJO 成為處理請求的控制器，而無須實現任何介面。採用了鬆散耦合可插拔組件結構，比其他 MVC 框架更具擴展性和靈活性。優點： 1、天生與Spring框架集成，如：(IOC,AOP ...

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 便於框架移植