Spring MVC 框架中你可以按任意顺序定义请求处理方法的入参(除了 Errors 和 BindingResult 必须紧跟在命令对象/表单参数后面以外),Spring MVC 会根据反射机制自动将对应的对象通过入参传递给请求处理方法。这种机制让开发者完全可以不依赖 Servlet API 开发控制层的程序,当请求处理方法需要特定的对象时,仅仅需要在参数列表中声明入参即可,不需要考虑如何获取这些对象,下面列举下spring mvc支持的处理方法参数。

* Java 基本数据类型 和String
默认情况下将按名称匹配的方式绑定到 URL 参数上,可以通过 @RequestParam 注解改变默认的绑定规则

* Request or response objects (Servlet API).
Request或者response 对象 (Servlet API),选择任意的request或者response类型,例如:ServletRequest 、 HttpServletRequest.

* Session object (Servlet API).
session对象(Servlet API):构成类型有HttpSession,这个类型的参数增强了当前通信的session,因此,这个参数永远不会null.
注意:session通道不是线程安全的,特别是在Servlet环境下,如果允许多个请求访问session的情况下建议将AnnotationMethodHandlerAdapter的synchronizeOnSession属性设置为"true"

* org.springframework.web.context.request.WebRequest or org.springframework.web.context.request.NativeWebRequest. Allows for generic request parameter access as well as request/session attribute access, without ties to the native Servlet/Portlet API.
使用spring封装的WebRequest或者NativeWebRequest,与使用原生的Servlet/Portlet API不相上下。

*.java.util.Locale
用于获得当前的请求区域。

*.java.io.InputStream / java.io.Reader for access to the request's content. This value is the raw InputStream/Reader as exposed by the Servlet API.
值为原始的InputStream/Reader被Servlet API 可以借此访问 request 的内容

*.java.io.OutputStream / java.io.Writer for generating the response's content. This value is the raw OutputStream/Writer as exposed by the Servlet API.
用于产生响应的内容,以此操作 response 的内容

*.java.security.Principal containing the currently authenticated user.
包含当前认证的用户。

*.@PathVariable annotated parameters for access to URI template variables
用于注解参数对应到地址栏的变量参数
例如:

@RequestMapping(value="/owners/{ownerId}", method=RequestMethod.GET)
public String findOwner(@PathVariable("ownerId") String ownerId, Model model) {
  // implementation omitted
}



访问地址"/owners/{ownerId}" 指定了访问变量名称为ownerId,当控制器处理这个请求的时候,ownerId的值被设置到请求的地址栏,


例如:当请求来自/owners/fred,值fred被绑定到访问方法的参数String ownerId



*.@RequestParam


用于注解参数到Servlet 请求的参数,参数值对应到控制器方法中声明的参数。


@RequestMapping(method = RequestMethod.GET)
    public String setupForm(@RequestParam("id") int petId, ModelMap model) {
        Pet pet = this.clinic.loadPet(petId);
        model.addAttribute("pet", pet);
        return "petForm";
    }



例如:请求的参数id对应到方法中的petId.



*.@RequestHeader


注解参数用于具体的Servlet请求的http头部,参数值被转换到生命的方法参数类型。


请求头部信息例如:Connection,Accept-Language、Accept-Charset等


public void displayHeaderInfo(@RequestHeader("Connection") String connection,@RequestHeader("Accept-Encoding") String encoding) {
        System.out.println("connection:" + connection);
        System.out.println("Accept-Encoding:" + encoding);
}




*.@RequestBody



*.HttpEntity<?>



*.java.util.Map / org.springframework.ui.Model / org.springframework.ui.ModelMap


它绑定 Spring MVC 框架中每个请求所创建的潜在的模型对象,它们可以被 Web 视图对象访问(如 JSP).用于增强传递到web视图页面的model,也就是说他们作为方法的参数后,页面视图就可以直接根据key来取得相应的值。



*.org.springframework.validation.Errors / org.springframework.validation.BindingResult


BindingResult继承于Errors,为属性列表中的命令/表单对象的校验结果,返回错误信息到页面,设置为方法参数后,在视图页面上可以直接获取。


BindingResult result必须和@ModelAttribute同时使用,并且参数要紧挨着。否则会报错。Errors/BindingResult argument declared without preceding model attribute异常。


如下例:1、2报错; 3正常。


//test:1


@RequestMapping(params="method=result1")
public String processSubmit1(User user,
    Model model, BindingResult result) {
    return "/demo1/listBoard";
}



//test:2


@RequestMapping(params="method=result2")
public String processSubmit2(@ModelAttribute("user") User user,
        Model model, BindingResult result) {
    return "/demo1/listBoard";
}



//test:3


@RequestMapping(params="method=result3")
public String processSubmit3(@ModelAttribute("user") User user,
        BindingResult result,Model model) {
    return "/demo1/listBoard";
}




* org.springframework.web.bind.support.SessionStatus status handle for marking form processing as complete, which triggers the cleanup of session attributes that have been indicated by the @SessionAttributes annotation at the handler type level.



可以通过该类型 status 对象显式结束表单的处理,这相当于触发 session 清除其中的通过 @SessionAttributes 定义的属性


例子:使用 SessionStatus 控制 Session 级别的模型属性


@RequestMapping(method = RequestMethod.POST)
public String processSubmit(@ModelAttribute Owner owner,
BindingResult result, SessionStatus status) {//<——①
    new OwnerValidator().validate(owner, result);
    if (result.hasErrors()) {
        return "ownerForm";
    }
    else {
        this.clinic.storeOwner(owner);
        status.setComplete();//<——②
        return "redirect:/owner.do?ownerId=" + owner.getId();
    }
}



processSubmit() 方法中的 owner 表单对象将绑定到 ModelMap 的“owner”属性中,result 参数用于存放检验 owner 结果的对象,


而 status 用于控制表单处理的状态。在 ② 处,我们通过调用 status.setComplete() 方法,


该 Controller 所有放在 session 级别的模型属性数据将从 session 中清空。