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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章