第六章 註解式控制器詳解——SpringMVC3強大的請求映射規則詳解

6.5、請求映射

處理器定義好了,那接下來我們應該定義功能處理方法,接收用戶請求處理並選擇視圖進行渲染。首先我們看一下圖6-1:

http請求信息包含六部分信息:
①請求方法,如GET或POST,表示提交的方式;
②URL,請求的地址信息;
③協議及版本;
④請求頭信息(包括Cookie信息);
⑤回車換行(CRLF);
⑥請求內容區(即請求的內容或數據),如表單提交時的參數數據、URL請求參數(?abc=123 ?後邊的)等。
 
想要了解HTTP/1.1協議,請訪問http://tools.ietf.org/html/rfc2616
 
那此處我們可以看到有①、②、④、⑥一般是可變的,因此我們可以這些信息進行請求到處理器的功能處理方法的映射,因此請求的映射分爲如下幾種:

URL路徑映射:使用URL映射請求到處理器的功能處理方法;

請求方法映射限定:如限定功能處理方法只處理GET請求;

請求參數映射限定:如限定只處理包含“abc”請求參數的請求;

請求頭映射限定:如限定只處理“Accept=application/json”的請求。

接下來看看具體如何映射吧。

6.5.1、URL路徑映射

6.5.1.1、普通URL路徑映射

@RequestMapping(value={"/test1", "/user/create"}):多個URL路徑可以映射到同一個處理器的功能處理方法。

6.5.1.2、URI模板模式映射

@RequestMapping(value="/users/{userId}"):{×××}佔位符, 請求的URL可以是 “/users/123456”或

“/users/abcd”,通過6.6.5講的通過@PathVariable可以提取URI模板模式中的{×××}中的×××變量。

@RequestMapping(value="/users/{userId}/create"):這樣也是可以的,請求的URL可以是“/users/123/create”。

@RequestMapping(value="/users/{userId}/topics/{topicId}"):這樣也是可以的,請求的URL可以是“/users/123/topics/123”。

6.5.1.3、Ant風格的URL路徑映射

@RequestMapping(value="/users/**"):可以匹配“/users/abc/abc”,但“/users/123”將會被【URI模板模式映射中的“/users/{userId}”模式優先映射到】【詳見4.14的最長匹配優先】。

@RequestMapping(value="/product?"):可匹配“/product1”或“/producta”,但不匹配“/product”或“/productaa”;

@RequestMapping(value="/product*"):可匹配“/productabc”或“/product”,但不匹配“/productabc/abc”;

@RequestMapping(value="/product/*"):可匹配“/product/abc”,但不匹配“/productabc”;

@RequestMapping(value="/products/**/{productId}"):可匹配“/products/abc/abc/123”或“/products/123”,也就是Ant風格和URI模板變量風格可混用;

此處需要注意的是【4.14中提到的最長匹配優先】,Ant風格的模式請參考4.14。

6.5.1.4、正則表達式風格的URL路徑映射

從Spring3.0開始支持正則表達式風格的URL路徑映射,格式爲{變量名:正則表達式},這樣我們就可以通過6.6.5講的通過@PathVariable提取模式中的{×××:正則表達式匹配的值}中的×××變量了。

@RequestMapping(value="/products/{categoryCode:\\d+}-{pageNumber:\\d+}"):可以匹配“/products/123-1”,但不能匹配“/products/abc-1”,這樣可以設計更加嚴格的規則。

正則表達式風格的URL路徑映射是一種特殊的URI模板模式映射:

URI模板模式映射是{userId},不能指定模板變量的數據類型,如是數字還是字符串;

正則表達式風格的URL路徑映射,可以指定模板變量的數據類型,可以將規則寫的相當複雜。

6.5.1.5、組合使用是“或”的關係

如 @RequestMapping(value={"/test1", "/user/create"}) 組合使用是或的關係,即“/test1”或“/user/create”請求URL路徑都可以映射到@RequestMapping指定的功能處理方法。

以上URL映射的測試類爲:cn.javass.chapter6.web.controller.mapping.MappingController.java。

到此,我們學習了Spring Web MVC提供的強大的URL路徑映射,而且可以實現非常複雜的URL規則。Spring Web MVC不僅僅提供URL路徑映射,還提供了其他強大的映射規則。接下來我們看一下請求方法映射限定吧。

6.5.2、請求方法映射限定

一般我們熟悉的表單一般分爲兩步:第一步展示,第二步提交,如4.9、SimpleFormController那樣,那如何通過@RequestMapping來實現呢?

6.5.2.1、請求方法映射限定

我們熟知的,展示表單一般爲GET請求方法;提交表單一般爲POST請求方法。但6.5.1節講的URL路徑映射方式對任意請求方法是全盤接受的,因此我們需要某種方式來告訴相應的功能處理方法只處理如GET請求方法的請求或POST請求方法的請求。

接下來我們使用@RequestMapping來實現SimpleFormController的功能吧。

package cn.javass.chapter6.web.controller.method;
//省略import
@Controller
@RequestMapping("/customers/**")                                     //①處理器的通用映射前綴
public class RequestMethodController {
    @RequestMapping(value="/create", method = RequestMethod.GET)//②類級別的@RequestMapping窄化
    public String showForm() {
        System.out.println("===============GET");
        return "customer/create";  
    }
    @RequestMapping(value="/create", method = RequestMethod.POST)//③類級別的@RequestMapping窄化
    public String submit() {
        System.out.println("================POST");
        return "redirect:/success";        
    }
}

 ①處理器的通用映射前綴(父路徑):表示該處理器只處理匹配“/customers/**”的請求;

②對類級別的@RequestMapping進行窄化,表示showForm可處理匹配“/customers/**/create”且請求方法爲“GET”的請求;

③對類級別的@RequestMapping進行窄化,表示submit可處理匹配“/customers/**/create”且請求方法爲“POST”的請求。

6.5.2.2、組合使用是“或”的關係

@RequestMapping(value="/methodOr", method = {RequestMethod.POST, RequestMethod.GET}):即請求方法可以是 GET 或 POST。

提示:

1、一般瀏覽器只支持GET、POST請求方法,如想瀏覽器支持PUT、DELETE等請求方法只能模擬,稍候章節介紹。

2、除了GET、POST,還有HEAD、OPTIONS、PUT、DELETE、TRACE。

3、DispatcherServlet默認開啓對 GET、POST、PUT、DELETE、HEAD的支持;

4、如果需要支持OPTIONS、TRACE,請添加DispatcherServlet在web.xml的初始化參數:dispatchOptionsRequest 和 dispatchTraceRequest 爲true。

請求方法的詳細使用請參考RESTful架構風格一章。

以上請求方法映射限定測試類爲:cn.javass.chapter6.web.controller.method.RequestMethodController。

6.5.3、請求參數數據映射限定

6.5.3.1、請求數據中有指定參數名

package cn.javass.chapter6.web.controller.parameter;
//省略import
@Controller
@RequestMapping("/parameter1")                                      //①處理器的通用映射前綴
public class RequestParameterController1 {
    //②進行類級別的@RequestMapping窄化
    @RequestMapping(params="create", method=RequestMethod.GET) 
    public String showForm() {
        System.out.println("===============showForm");
        return "parameter/create";        
    }
    //③進行類級別的@RequestMapping窄化
    @RequestMapping(params="create", method=RequestMethod.POST)  
    public String submit() {
        System.out.println("================submit");
        return "redirect:/success";        
    }
}

 ②@RequestMapping(params="create", method=RequestMethod.GET) :表示請求中有“create”的參數名且請求方法爲“GET”即可匹配,如可匹配的請求URL“http://×××/parameter1?create”;

③@RequestMapping(params="create", method=RequestMethod.POST):表示請求中有“create”的參數名且請求方法爲“POST”即可匹配;

此處的create請求參數名錶示你請求的動作,即你想要的功能的一個標識,常見的CRUD(增刪改查)我們可以使用如下請求參數名來表達:

(create請求參數名 且 GET請求方法) 新增頁面展示、(create請求參數名 且 POST請求方法)新增提交;

(update請求參數名 且 GET請求方法) 新增頁面展示、(update請求參數名 且 POST請求方法)新增提交;

(delete請求參數名 且 GET請求方法) 新增頁面展示、(delete請求參數名 且 POST請求方法)新增提交;

(query請求參數名 且 GET請求方法) 新增頁面展示、(query請求參數名 且 POST請求方法) 新增提交;

(list請求參數名 且 GET請求方法) 列表頁面展示;

(view請求參數名 且 GET請求方法) 查看單條記錄頁面展示。

6.5.3.2、請求數據中沒有指定參數名

//請求參數不包含 create參數名
@RequestMapping(params="!create", method=RequestMethod.GET)//進行類級別的@RequestMapping窄化

 @RequestMapping(params="!create", method=RequestMethod.GET):表示請求中沒有“create”參數名且請求方法爲“GET”即可匹配,如可匹配的請求URL“http://×××/parameter1?abc”。

6.5.3.3、請求數據中指定參數名=值

package cn.javass.chapter6.web.controller.parameter;
//省略import
@Controller
@RequestMapping("/parameter2")                      //①處理器的通用映射前綴
public class RequestParameterController2 {
    //②進行類級別的@RequestMapping窄化
    @RequestMapping(params="submitFlag=create", method=RequestMethod.GET)  
    public String showForm() {
        System.out.println("===============showForm");
        return "parameter/create";        
    }
    //③進行類級別的@RequestMapping窄化
    @RequestMapping(params="submitFlag=create", method=RequestMethod.POST)   
    public String submit() {
        System.out.println("===============submit");
        return "redirect:/success";        
    }
}

 ②@RequestMapping(params="submitFlag=create", method=RequestMethod.GET):表示請求中有“submitFlag=create”請求參數且請求方法爲“GET”即可匹配,如請求URL爲http://×××/parameter2?submitFlag=create

③@RequestMapping(params="submitFlag=create", method=RequestMethod.POST):表示請求中有“submitFlag=create”請求參數且請求方法爲“POST”即可匹配;

此處的submitFlag=create請求參數表示你請求的動作,即你想要的功能的一個標識,常見的CRUD(增刪改查)我們可以使用如下請求參數名來表達:

(submitFlag=create請求參數名 且 GET請求方法) 新增頁面展示、(submitFlag=create請求參數名 且 POST請求方法) 新增提交;

(submitFlag=update請求參數名 且 GET請求方法) 新增頁面展示、(submitFlag=update請求參數名 且 POST請求方法) 新增提交;

(submitFlag=delete請求參數名 且 GET請求方法) 新增頁面展示、(submitFlag=delete請求參數名 且 POST請求方法) 新增提交;

(submitFlag=query請求參數名 且 GET請求方法) 新增頁面展示、(submitFlag=query請求參數名 且 POST請求方法) 新增提交;

(submitFlag=list請求參數名 且 GET請求方法) 列表頁面展示;

(submitFlag=view請求參數名 且 GET請求方法) 查看單條記錄頁面展示。

6.5.3.4、請求數據中指定參數名!=值

//請求參數submitFlag 不等於 create
@RequestMapping(params="submitFlag!=create", method=RequestMethod.GET)  

 @RequestMapping(params="submitFlag!=create", method=RequestMethod.GET):表示請求中的參數“submitFlag!=create”且請求方法爲“GET”即可匹配,如可匹配的請求URL“http://×××/parameter1?submitFlag=abc”。

6.5.3.5、組合使用是“且”的關係

@RequestMapping(params={"test1", "test2=create"})  //②進行類級別的@RequestMapping窄化

 @RequestMapping(params={"test1", "test2=create"}):表示請求中的有“test1”參數名 且 有“test2=create”參數即可匹配,如可匹配的請求URL“http://×××/parameter3?test1&test2=create。

以上請求參數數據映射限定測試類爲:cn.javass.chapter6.web.controller.method包下的RequestParameterController1、RequestParameterController2、RequestParameterController3。

6.5.4、請求頭數據映射限定

6.5.4.1、準備環境

瀏覽器:建議chrome最新版本;

插件:ModHeader

安裝地址:https://chrome.google.com/webstore/detail/idgpnmonknjnojddfkpgkljpfnnfcklj

插件安裝步驟:

1、打開https://chrome.google.com/webstore/detail/idgpnmonknjnojddfkpgkljpfnnfcklj,如圖6-2

 

圖6-2

2、點擊“添加至chrome”後彈出“確認安裝”對話框,點擊“安裝”按鈕即可,如圖6-3:

 

圖6-3

3、安裝成功後,在瀏覽器右上角出現如圖6-4的圖標表示安裝成功:

 

圖6-4

4、鼠標右擊右上角的“Modify Header”圖標,選擇選項,打開如圖6-5:

 

圖6-5

7、修改完成後,輸入URL請求,你可以在chrome的“開發人員工具的”網絡選項卡下,看到如圖6-7的信息表示添加請求頭成功了:

 

圖6-7

到此我們的工具安裝完畢,接下來看看如何使用請求頭數據進行映射限定。

6.5.4.2、請求頭數據中有指定參數名

@RequestMapping(value="/header/test1", headers = "Accept"):表示請求的URL必須爲“/header/test1”

且 請求頭中必須有Accept參數才能匹配。

@RequestMapping(value="/header/test1", headers = "abc"):表示請求的URL必須爲“/header/test1”

且 請求頭中必須有abc參數才能匹配,如圖6-8時可匹配。

 

圖6-8

6.5.4.3、請求頭數據中沒有指定參數名

@RequestMapping(value="/header/test2", headers = "!abc"):表示請求的URL必須爲“/header/test2”

且 請求頭中必須沒有abc參數才能匹配。(將Modify Header的abc參數值刪除即可)。

 

6.5.4.4、請求頭數據中指定參數名=值

@RequestMapping(value="/header/test3", headers = "Content-Type=application/json"):表示請求的URL必須爲“/header/test3” 且 請求頭中必須有“Content-Type=application/json”參數即可匹配。(將Modify Header的Content-Type參數值改爲“application/json”即可);

 

當你請求的URL爲“/header/test3” 但 如果請求頭中沒有或不是“Content-Type=application/json”參數(如“text/html”其他參數),將返回“HTTP Status 415”狀態碼【表示不支持的媒體類型(Media Type),也就是MIME類型】,即我們的功能處理方法只能處理application/json的媒體類型。

@RequestMapping(value="/header/test4", headers = "Accept=application/json"):表示請求的URL必須爲“/header/test4” 且 請求頭中必須有“Accept =application/json”參數即可匹配。(將Modify Header的Accept參數值改爲“application/json”即可);

 

當你請求的URL爲“/header/test4” 但 如果請求頭中沒有“Accept=application/json”參數(如“text/html”其他參數),將返回“HTTP Status 406”狀態碼【不可接受,服務器無法根據Accept頭的媒體類型爲客戶端生成響應】,即客戶只接受“application/json”媒體類型的數據,即我們的功能處理方法的響應只能返回“application/json”媒體類型的數據。

@RequestMapping(value="/header/test5", headers = "Accept=text/*") :表示請求的URL必須爲“/header/test5” 且 請求頭中必須有如“Accept=text/plain”參數即可匹配。(將Modify Header的Accept參數值改爲“text/plain”即可);

Accept=text/*:表示主類型爲text,子類型任意,如“text/plain”、“text/html”等都可以匹配。

@RequestMapping(value="/header/test6", headers = "Accept=*/*") :表示請求的URL必須爲“/header/test6” 且 請求頭中必須有任意Accept參數即可匹配。(將Modify Header的Accept參數值改爲“text/html”或“application/xml”等都可以)。

Accept=*/*:表示主類型任意,子類型任意,如“text/plain”、“application/xml”等都可以匹配。

6.5.4.5、請求頭數據中指定參數名!=值

@RequestMapping(value="/header/test7", headers = "Accept!=text/vnd.wap.wml"):表示請求的URL必須爲“/header/test7” 且 請求頭中必須有“Accept”參數但值不等於“text/vnd.wap.wml”即可匹配。

6.5.4.6、組合使用是“且”的關係

@RequestMapping(value="/header/test8", headers = {"Accept!=text/vnd.wap.wml","abc=123"}):表示請求的URL必須爲“/header/test8” 且 請求頭中必須有“Accept”參數但值不等於“text/vnd.wap.wml”且 請求中必須有參數“abc=123”即可匹配。

注:Accept:text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8

如果您的請求中含有Accept:“*/*”,則可以匹配功能處理方法上的如“text/html”、“text/*”,“application/xml”等。


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