第一部分:Action输入参数
Spring MVC 通过@RequestMapping注解映射请求,最终的真正执行代码为处理器方法,即@RequestMapping注解的方法。Spring MVC方法可以接受的参数包含:
1.1)基本数据类型,如int,String,double...
1.2)自定义数据类型,如自定义的pojo对象
1.3)Servlet API中的Request和Response。如:ServletRequest或HttpServletRequest。
1.4)Session对象。如:HttpSession。注意此对象不是线程安全的,可设置RequestMappingHandlerAdapter的 “synchronizeOnSession”属性为true来同步。
1.5)org.springframework.web.context.request.WebRequest或org.springframework.web.context.request.NativeWebRequest。
1.6)java.util.Locale对象。需要在Servlet环境中配置 LocaleResolver。
1.7)java.io.InputStream / java.io.Reader用于访问请求输入流。
1.8)java.io.OutputStream / java.io.Writer用于生成的输出流。
1.9)java.security.Principal用于保存当前的认证用户。
1.10)@PathVariable注解的参数。
1.11)@MatrixVariable注解的参数。
1.12)@RequestParam注解的请求参数。
1.13)@RequestHeader注解的请求头参数。
1.14)@RequestBody注解的请求体参数。
1.15)@RequestPart注解的上传文件请求体参数。请求类型为”multipart/form-data”。
1.16)HttpEntity<?>:请求实体对象,可以访问头信息和内容体。
1.17)java.util.Map / org.springframework.ui.Model / org.springframework.ui.ModelMap:用于响应模型类,存储响应数据。
1.18)org.springframework.web.servlet.mvc.support.RedirectAttributes:用于在redirect的重定向中传递数据。
1.19)命令或 表单对象。
1.20)org.springframework.validation.Errors / org.springframework.validation.BindingResult对象。
1.21)org.springframework.web.bind.support.SessionStatus可以用来控制Session的清理。
1.22)org.springframework.web.util.UriComponentsBuilder可以用来查询当前请求的主机名、端口号、Schema、Context Path、Servlet Mapping信息。
1、基本数据类型
方法的参数可以是任意基本数据类型,如果方法参数名与http中请求的参数名称相同时会进行自动映射。
public String index(Model model, int id, String name) {
}
2、自定义数据类型
Spring MVC会通过反射把请求中的参数设置到自定义类型的对象中。
public String index(Model model, Member member) {
}
3、集合类型
Spring MVC中不能直接在方法的参数中使用集合类型(List 和 Map),必须使用集合类型的包装类。
//人员集合
public class MemberList {
private List<Member> items;
public List<Member> getItems() {
return items;
}
public void setItems(List<Member> items) {
this.items = items;
}
}
然后使用
public String index(Model model, MemberList members) {
}
4、使用@RequestParam注解的请求参数。
@RequestMapping(value="/index.do")
public String index(@RequestParam(value="code", required=true) String code,@RequestParam(value="pwd", required=true) String pwd, ModelMap model) {
Member member = authService.validate(code,pwd);
model.addAttribute("member", member);
return "index";
}
使用 @RequestParam 可以处理一些细节逻辑,如默认值、是否必须、别名等。
5、使用@RequestBody注解的请求体参数。
@RequestMapping(value="/index.do", method = RequestMethod.PUT)
public void index(@RequestBody String body, Writer writer) throws IOException {
writer.write(body);
}
由HttpMessageConverter来转换body至对象。它可以被转换成支持的任意类型。 RequestMappingHandlerAdapter 默认的支持有:
5.1)ByteArrayHttpMessageConverter :byte[]转换。
5.2)StringHttpMessageConverter :转换成String。
5.3)FormHttpMessageConverter :转换成MultiValueMap<String, String>。
5.4)SourceHttpMessageConverter :转换成javax.xml.transform.Source。
转换的参数还可以加上@Valid注解,以进行转换校验,如果校验失败将抛出MethodArgumentNotValidException,此异常默认情况由 DefaultHandlerExceptionResolver进行管理,将会向客户端发送400错误码。
6、使用HttpEntity<?>
@RequestMapping(value="/index.do")
public ResponseEntity<String> index(HttpEntity<byte[]> requestEntity) throws Exception {
String requestHeader = requestEntity.getHeaders().getFirst("MyRequestHeader");
byte[] requestBody = requestEntity.getBody();
HttpHeaders responseHeaders = new HttpHeaders();
responseHeaders.set("MyResponseHeader", "MyValue");
return new ResponseEntity<String>("Hello World", responseHeaders, HttpStatus.CREATED);
}
7、使用@ModelAttribute
@ModelAttribute使用在方法上,就相当于一个公共model池一样(前提是在同一个Controller中),在同一个Controller中,所有@RequestMapping注解的方法执行前,都要先执行这些由@ModelAtrribute注解的方法,将数据存入到当前请求的Model中。它可以单个添加属性,也可以批量地添加。
@ModelAttribute
public void bindModel(@RequestParam String code,@RequestParam String pwd, Model model){
model.addAttribute(authService.validate(code,pwd));
}
@ModelAttribute使用在方法参数上,被注解的参数会先从请求的Model中查找,如果未找到,则会实例化一个新对象,放入请求的Model中。
查找路径:
存在于@SessionAttributes中。
存在于同一个Controller中的注解于方法级别上的@ModelAttribute中。
Url的模式匹配和转换中。
@RequestMapping(value="/member/{member}", method = RequestMethod.PUT)
public void bind(@ModelAttribute("member") Member member){
}
8、使用@SessionAttributes
在Controller类上使用此注解,会从请求的model中查找@SessionAttributes指定的属性名或属性类型,将它们保存到Session中。
/**
* @功能 权限控制器
* @作者 Davee.Yuan
* @日期 2017-01-16
* @说明 http://localhost:8080/auth/index
*/
@Controller
@RequestMapping("/sso")
@SessionAttributes("member")
public class SsoController{
}
9、使用@RedirectAttributes
方法的签名中指定一个RedirectAttributes 类型的参数,用于在请求返回 RedirectView时传递数据。
@RequestMapping(value="/redirect.do")
public String redirect(RedirectAttributes attr){
attr.addAttribute("status",9999);
return "redirect:/toLogin";
}
10、使用@CookieValue
@RequestMapping(value="/display.do")
public String display(@CookieValue("JSESSIONID") String cookie){
//---------------------
return "";
}
第二部分:类型转换
Spring MVC控制器接收到的原始请求数据都是文本类型,而先前使用的@RequestParam、@CookieValue等注解的参数可以为String类型,也可以是其它,Spring默认支持一些简单的数据类型如int、long、Date等类型的自动转换,如果需要对自定义的类型或复杂类型进行转换的话,需要自定义转换器绑定。绑定的方式有两种:局部绑定、全局绑定(它还有两种实现形式):
局部绑定:在@Controller中使用@InitBinder注解方法进行转换器的绑定,用它绑定的方法返回类型应设置成void,方法参数WebDataBinder集合了WebRequest和java.util.Locale,它可以将转换器绑定至Context中:
@InitBinder
public void initBinder(WebDataBinder binder) {
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
dateFormat.setLenient(false);
binder.registerCustomEditor(Date.class, new CustomDateEditor(dateFormat, false));
}
全局绑定:一种方式是实现一个WebBindingInitializer 接口类,将它绑定至全局配置中,如实现类ClinicBindingInitializer:
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
<property name="cacheSeconds" value="0" />
<property name="webBindingInitializer">
<bean class="org.springframework.samples.petclinic.web.ClinicBindingInitializer" />
</property>
</bean>
全局绑定:另一种方式是使用@InitBinder注解于@ControllerAdvice注解的类中,来实现全局绑定
内容主要来自于:https://blog.zenfery.cc/archives/131.html?replytocom=14