SpringMvc之@RequestParam詳解


@RequestParam是傳遞參數的.

@RequestParam用於將請求參數區數據映射到功能處理方法的參數上。

public String queryUserName(@RequestParam String userName)

在url中輸入:localhost:8080/**/?userName=zhangsan

請求中包含username參數(如/requestparam1?userName=zhang),則自動傳入。

接下來我們看一下@RequestParam注解主要有哪些參數:

value:參數名字,即入參的請求參數名字,如username表示請求的參數區中的名字為username的參數的值將傳入;

required:是否必須,默認是true,表示請求中一定要有相應的參數,否則將報404錯誤碼;

defaultValue:默認值,表示如果請求中沒有同名參數時的默認值,默認值可以是SpEL表達式,如“#{systemProperties['java.vm.version']}”。

 

表示請求中可以沒有名字為username的參數,如果沒有默認為null,此處需要注意如下幾點:

 

public String queryUserName(@RequestParam(value="userName" ,required =false ) String userName)

 

     原子類型:必須有值,否則拋出異常,如果允許空值請使用包裝類代替。

     Boolean包裝類型類型:默認Boolean.FALSE,其他引用類型默認為null。

public String requestparam5(  
@RequestParam(value="username", required=true, defaultValue="zhang") String username)   
          

如果沒有傳入參數,則默認是"zhangsan".

但是在傳遞參數的時候如果是url?userName=zhangsan&userName=wangwu時怎么辦呢?

其實在實際roleList參數入參的數據為“zhangsan,wangwu”,即多個數據之間使用“,”分割;我們應該使用如下方式來接收多個請求參數:

 

 
         
public String requestparam8(@RequestParam(value="userName") String []  userNames)     
或者是:
public String requestparam8(@RequestParam(value="list") List<String> list)     

 

 

 

@PathVariable綁定URI模板變量值

 

@RequestMapping(value="/users/{userId}/topics/{topicId}")  
public String test(   @PathVariable(value="userId") int userId,    @PathVariable(value="topicId") int topicId)  

 如請求的URL為“控制器URL/users/123/topics/456”,則自動將URL中模板變量{userId}和{topicId}綁定到通過@PathVariable注解的同名參數上,即入參后userId=123、topicId=456。代碼在PathVariableTypeController中

6.6.4、@CookieValue綁定Cookie數據值

@CookieValue用於將請求的Cookie數據映射到功能處理方法的參數上。

public String test(@CookieValue(value="JSESSIONID", defaultValue="") String sessionId) 

如上配置將自動將JSESSIONID值入參到sessionId參數上,defaultValue表示Cookie中沒有JSESSIONID時默認為空。

public String test2(@CookieValue(value="JSESSIONID", defaultValue="") Cookie sessionId)     

傳入參數類型也可以是javax.servlet.http.Cookie類型

測試代碼在CookieValueTypeController中。@CookieValue也擁有和@RequestParam相同的三個參數,含義一樣。

6.6.5、@RequestHeader綁定請求頭數據

@RequestHeader用於將請求的頭信息區數據映射到功能處理方法的參數上。

@RequestMapping(value="/header")  
public String test(  
       @RequestHeader("User-Agent") String userAgent,  
       @RequestHeader(value="Accept") String[] accepts)

如上配置將自動將請求頭“User-Agent”值入參到userAgent參數上,並將“Accept”請求頭值入參到accepts參數上。測試代碼在HeaderValueTypeController中。

@RequestHeader也擁有和@RequestParam相同的三個參數,含義一樣。

6.6.6、@ModelAttribute綁定請求參數到命令對象

@ModelAttribute一個具有如下三個作用:

①綁定請求參數到命令對象:放在功能處理方法的入參上時,用於將多個請求參數綁定到一個命令對象,從而簡化綁定流程,而且自動暴露為模型數據用於視圖頁面展示時使用;

②暴露表單引用對象為模型數據:放在處理器的一般方法(非功能處理方法)上時,是為表單准備要展示的表單引用對象,如注冊時需要選擇的所在城市等,而且在執行功能處理方法(@RequestMapping注解的方法)之前,自動添加到模型對象中,用於視圖頁面展示時使用;

③暴露@RequestMapping方法返回值為模型數據:放在功能處理方法的返回值上時,是暴露功能處理方法的返回值為模型數據,用於視圖頁面展示時使用。

 

一、綁定請求參數到命令對象

如用戶登錄,我們需要捕獲用戶登錄的請求參數(用戶名、密碼)並封裝為用戶對象,此時我們可以使用@ModelAttribute綁定多個請求參數到我們的命令對象。

  1. public String test1(@ModelAttribute("user") UserModel user)  

     

和6.6.1一節中的五、命令/表單對象功能一樣。只是此處多了一個注解@ModelAttribute("user"),它的作用是將該綁定的命令對象以“user”為名稱添加到模型對象中供視圖頁面展示使用。我們此時可以在視圖頁面使用${user.username}來獲取綁定的命令對象的屬性。

 

綁定請求參數到命令對象支持對象圖導航式的綁定,如請求參數包含“?username=zhang&password=123&workInfo.city=bj”自動綁定到user中的workInfo屬性的city屬性中。

Java代碼  
  1. @RequestMapping(value="/model2/{username}")  
    public String test2(@ModelAttribute("model") DataBinderTestModel model) {   

     

DataBinderTestModel相關模型請從第三章拷貝過來,請求參數到命令對象的綁定規則詳見【4.16.1、數據綁定】一節,URI模板變量也能自動綁定到命令對象中,當你請求的URL中包含“bool=yes&schooInfo.specialty=computer&hobbyList[0]=program&hobbyList[1]=music&map[key1]=value1&map[key2]=value2&state=blocked”會自動綁定到命令對象上。

 

當URI模板變量和請求參數同名時,URI模板變量具有高優先權。

 

二、暴露表單引用對象為模型數據

Java代碼  
  1. @ModelAttribute("cityList")  
    public List<String> cityList() {  
        return Arrays.asList("北京", "山東");  
    } 

     

      

如上代碼會在執行功能處理方法之前執行,並將其自動添加到模型對象中,在功能處理方法中調用Model 入參的containsAttribute("cityList")將會返回true。

Java代碼  
  1. @ModelAttribute("user")  //
    public UserModel getUser(@RequestParam(value="username", defaultValue="") String username) {  
    //TODO 去數據庫根據用戶名查找用戶對象  
    UserModel user = new UserModel();  
    user.setRealname("zhang");  
         return user;  
    }  

     

     

如你要修改用戶資料時一般需要根據用戶的編號/用戶名查找用戶來進行編輯,此時可以通過如上代碼查找要編輯的用戶。

也可以進行一些默認值的處理。

Java代碼  
  1. @RequestMapping(value="/model1") //
    public String test1(@ModelAttribute("user") UserModel user, Model model)   

     

此處我們看到①和②有同名的命令對象,那Spring Web MVC內部如何處理的呢:

(1、首先執行@ModelAttribute注解的方法,准備視圖展示時所需要的模型數據;@ModelAttribute注解方法形式參數規則和@RequestMapping規則一樣,如可以有@RequestParam等;

(2、執行@RequestMapping注解方法,進行模型綁定時首先查找模型數據中是否含有同名對象,如果有直接使用,如果沒有通過反射創建一個,因此②處的user將使用①處返回的命令對象。即②處的user等於①處的user。

 

三、暴露@RequestMapping方法返回值為模型數據

Java代碼  
  1. public @ModelAttribute("user2") UserModel test3(@ModelAttribute("user2") UserModel user)  

大家可以看到返回值類型是命令對象類型,而且通過@ModelAttribute("user2")注解,此時會暴露返回值到模型數據(名字為user2)中供視圖展示使用。那哪個視圖應該展示呢?此時Spring Web MVC會根據RequestToViewNameTranslator進行邏輯視圖名的翻譯,詳見【4.15.5、RequestToViewNameTranslator】一節。

 

此時又有問題了,@RequestMapping注解方法的入參user暴露到模型數據中的名字也是user2,其實我們能猜到:

(3、@ModelAttribute注解的返回值會覆蓋@RequestMapping注解方法中的@ModelAttribute注解的同名命令對象。

 

四、匿名綁定命令參數

Java代碼  
  1. public String test4(@ModelAttribute UserModel user, Model model)  
    或  
    public String test5(UserModel user, Model model)   

     

此時我們沒有為命令對象提供暴露到模型數據中的名字,此時的名字是什么呢?Spring Web MVC自動將簡單類名(首字母小寫)作為名字暴露,如“cn.javass.chapter6.model.UserModel”暴露的名字為“userModel”。

Java代碼  
  1. public @ModelAttribute List<String> test6()  
    或  
    public @ModelAttribute List<UserModel> test7()   

     

對於集合類型(Collection接口的實現者們,包括數組),生成的模型對象屬性名為“簡單類名(首字母小寫)”+“List”,如List<String>生成的模型對象屬性名為“stringList”,List<UserModel>生成的模型對象屬性名為“userModelList”。

 

其他情況一律都是使用簡單類名(首字母小寫)作為模型對象屬性名,如Map<String, UserModel>類型的模型對象屬性名為“map”。

6.6.7、@SessionAttributes綁定命令對象到session

有時候我們需要在多次請求之間保持數據,一般情況需要我們明確的調用HttpSession的API來存取會話數據,如多步驟提交的表單。Spring Web MVC提供了@SessionAttributes進行請求間透明的存取會話數據。

Java代碼  
  1. //1、在控制器類頭上添加@SessionAttributes注解  
    @SessionAttributes(value = {"user"})    //
    public class SessionAttributeController   
      
    //2、@ModelAttribute注解的方法進行表單引用對象的創建  
    @ModelAttribute("user")    //
    public UserModel initUser()   
      
    //3、@RequestMapping注解方法的@ModelAttribute注解的參數進行命令對象的綁定  
    @RequestMapping("/session1")   //
    public String session1(@ModelAttribute("user") UserModel user)  
      
    //4、通過SessionStatus的setComplete()方法清除@SessionAttributes指定的會話數據  
    @RequestMapping("/session2")   //
    public String session(@ModelAttribute("user") UserModel user, SessionStatus status) {  
        if(true) { //
            status.setComplete();  
        }  
        return "success";  
    }   

     

@SessionAttributes(value = {"user"})含義:

@SessionAttributes(value = {"user"}) 標識將模型數據中的名字為“user” 的對象存儲到會話中(默認HttpSession),此處value指定將模型數據中的哪些數據(名字進行匹配)存儲到會話中,此外還有一個types屬性表示模型數據中的哪些類型的對象存儲到會話范圍內,如果同時指定value和types屬性則那些名字和類型都匹配的對象才能存儲到會話范圍內。

 

包含@SessionAttributes的執行流程如下所示:

① 首先根據@SessionAttributes注解信息查找會話內的對象放入到模型數據中;

② 執行@ModelAttribute注解的方法:如果模型數據中包含同名的數據,則不執行@ModelAttribute注解方法進行准備表單引用數據,而是使用①步驟中的會話數據;如果模型數據中不包含同名的數據,執行@ModelAttribute注解的方法並將返回值添加到模型數據中;

③ 執行@RequestMapping方法,綁定@ModelAttribute注解的參數:查找模型數據中是否有@ModelAttribute注解的同名對象,如果有直接使用,否則通過反射創建一個;並將請求參數綁定到該命令對象;

此處需要注意:如果使用@SessionAttributes注解控制器類之后,③步驟一定是從模型對象中取得同名的命令對象,如果模型數據中不存在將拋出HttpSessionRequiredException Expected session attribute ‘user’(Spring3.1)

或HttpSessionRequiredException Session attribute ‘user’ required - not found in session(Spring3.0)異常。

④ 如果會話可以銷毀了,如多步驟提交表單的最后一步,此時可以調用SessionStatus對象的setComplete()標識當前會話的@SessionAttributes指定的數據可以清理了,此時當@RequestMapping功能處理方法執行完畢會進行清理會話數據。

 

我們通過Spring Web MVC的源代碼驗證一下吧,此處我們分析的是Spring3.1的RequestMappingHandlerAdapter,讀者可以自行驗證Spring3.0的AnnotationMethodHandlerAdapter,流程一樣:

(1、RequestMappingHandlerAdapter.invokeHandlerMethod

Java代碼  
  1. //1、RequestMappingHandlerAdapter首先調用ModelFactory的initModel方法准備模型數據:  
    modelFactory.initModel(webRequest, mavContainer, requestMappingMethod);  
    //2、調用@RequestMapping注解的功能處理方法  
    requestMappingMethod.invokeAndHandle(webRequest, mavContainer);  
    //3、更新/合並模型數據  
    modelFactory.updateModel(webRequest, mavContainer);   

     

(2、ModelFactory.initModel

Java代碼  
  1. Map<String, ?> attributesInSession = this.sessionAttributesHandler.retrieveAttributes(request);  
    //1.1、將與@SessionAttributes注解相關的會話對象放入模型數據中  
    mavContainer.mergeAttributes(attributesInSession);  
    //1.2、調用@ModelAttribute方法添加表單引用對象  
    invokeModelAttributeMethods(request, mavContainer);  
    //1.3、驗證模型數據中是否包含@SessionAttributes注解相關的會話對象,不包含拋出異常  
    for (String name : findSessionAttributeArguments(handlerMethod)) {  
        if (!mavContainer.containsAttribute(name)) {  
            //1.4、此處防止在@ModelAttribute注解方法又添加了會話對象  
            //如在@ModelAttribute注解方法調用session.setAttribute("user", new UserModel());  
            Object value = this.sessionAttributesHandler.retrieveAttribute(request, name);  
            if (value == null) {  
                throw new HttpSessionRequiredException("Expected session attribute '" + name + "'");  
            }  
            mavContainer.addAttribute(name, value);  
    }   

     

(3、ModelFactory.invokeModelAttributeMethods

Java代碼  
  1. for (InvocableHandlerMethod attrMethod : this.attributeMethods) {  
        String modelName = attrMethod.getMethodAnnotation(ModelAttribute.class).value();   
        //1.2.1、如果模型數據中包含同名數據則不再添加  
        if (mavContainer.containsAttribute(modelName)) {  
            continue;  
        }  
        //1.2.2、調用@ModelAttribute注解方法並將返回值添加到模型數據中,此處省略實現代碼  
    }   

     

(4、requestMappingMethod.invokeAndHandle 調用功能處理方法,此處省略

(5、ModelFactory.updateMode 更新模型數據

Java代碼  
  1. //3.1、如果會話被標識為完成,此時從會話中清除@SessionAttributes注解相關的會話對象  
    if (mavContainer.getSessionStatus().isComplete()){   
        this.sessionAttributesHandler.cleanupAttributes(request);  
    }  
    //3.2、如果會話沒有完成,將模型數據中的@SessionAttributes注解相關的對象添加到會話中  
    else {  
        this.sessionAttributesHandler.storeAttributes(request, mavContainer.getModel());  
    }  
    //省略部分代碼  

     

     

到此@SessionAtrribute介紹完畢,測試代碼在cn.javass.chapter6.web.controller.paramtype.SessionAttributeController中。

 

另外cn.javass.chapter6.web.controller.paramtype.WizardFormController是一個類似於【4.11、AbstractWizardFormController】中介紹的多步驟表單實現,此處不再貼代碼,多步驟提交表單需要考慮會話超時問題,這種方式可能對用戶不太友好,我們可以采取隱藏表單(即當前步驟將其他步驟的表單隱藏)或表單數據存數據庫(每步驟更新下數據庫數據)等方案解決。

6.6.8、@Value綁定SpEL表示式

@Value用於將一個SpEL表達式結果映射到到功能處理方法的參數上。

Java代碼  
  1. public String test(@Value("#{systemProperties['java.vm.version']}") String jvmVersion)  

到此數據綁定我們就介紹完了,對於沒有介紹的方法參數和注解(包括自定義注解)在后續章節進行介紹。接下來我們學習下數據類型轉換吧。

 

 

 

 

 

 

 

 

 

 

 

 

 

 

http://jinnianshilongnian.iteye.com/blog/1703694


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM