SpringMVC 常用注解 详解
SpringMVC 常用注解
1、@RequestMapping 路径映射
2、@RequestParam 获取请求参数
3、@PathVariable 绑定URL 模板变量值
4、@ModelAttribute 用在方法上 / 用在方法参数列表上
5、@SessionAttributes 将值放到session 域中
6、@ResponsBody 与 @RequestBody 传输json 格式数据
本文摘自 https://www.cnblogs.com/xiaoxi
未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
@RequestMapping
@RequestMapping 是一个用来处理请求地址(URL 路径映射)映射的注解(将请求映射到对应的控制器方法中),可以用在类上或方法上,用在类上 设置请求前缀,用在方法上 设置请求后缀。
@RequestMapping 中的方法:
value 指定请求路径
method 指定请求类型
params 指定request 中必须包含某些参数值,才能让该方法执行
headers 指定request 中必须包含指定的header 才能让该方法执行
consumes 指定请求的内容类型 例如:Application/json , text/html
Produces 指定返回的内容类型,仅当request 请求头中的类型包含该指定类型才能返回
@RequestMapping 的方法
一、value指定请求路径
1、指定多个路径 中间使用逗号隔开
@RequestMapping(value={"/updateitem","/updateitems","/list"})
@RequestMapping(value={"/updateitem","/updateitems","/list"})
/**
* 可以多个请求访问该类或者方法,
* 访问路径 : http://localhost:8080/updateitem 或者 http://localhost:8080/list
*/
2、@RequestMapping 作用在类上 // 只要符合请求路径,都可以访问该类
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @RequestMapping(value = "/json/info/{itemId}") 2 @ResponseBody 3 public Items getItemById(@PathVariable("itemId") int id) { 4 Items items = itemService.getItemById(id); 5 return items; 6 } 7 /** 8 *访问地址为:http://localhost:8080/item/queryItem 9 **/
3、同时作用在类上,方法上 // 请求时应符合前缀(类上的@RequestMapping)+后缀(方法上的@RequestMapping)
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @Controller 2 @RequestMapping(value = "/item") 3 public class ItemController { 4 @RequestMapping(value = "/json/info-list") 5 public List<Items> getItemById() { 6 return itemService.getItemList(); 7 } 8 } 9 /** 10 *访问地址 http://localhost:8080/item/json/info-list 11 *注意: 12 * 由于在类上加了 /item ,所以在访问该类的每个方法时,都应该带上前缀/item 13 **/
4、路径中含某变量的值 // 获取路径中的参数,赋值给方法的形参
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @RequestMapping("/json/info/{itemId}") 2 @ResponseBody 3 public Items getItemById(@PathVariable("itemId") int id) { 4 Items items = itemService.getItemById(id); 5 return items; 6 } 7 /** 8 * 获取路径中的参数 itemId 的值,赋值给 int id 9 **/
二、method 指定请求类型 {RequestMethod.GET(get 请求), RequestMethod.POST(post请求)}
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @Controller 2 @RequestMapping(value = "/item" , method = RequestMetod.GET) 3 public class ItemController { 4 @RequestMapping(value = "/json/info-list") 5 public List<Items> getItemById() { 6 return itemService.getItemList(); 7 } 8 } 9 10 /** 11 * Method方法 用来设置请求类型 12 * 取值 : GET POST 13 */
三、params 指定request 中必须包含某些参数值,才能让该方法执行
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @RequestMapping(value = "/ info") 2 public class ItemController { 3 @RequestMapping(value = "/qwe",params="action=123") 4 public List<Items> getItemById(@PathVariable("itemId") int id) { 5 return itemService.getItemList(); 6 } 7 } 8 /** 9 * 访问地址为:http://localhost:8080// info/qwe?action=123 10 * 路径中必须包含 “action =123” 参数 该方法才能执行 11 **/
四、headers 指定request 中必须包含指定的header值 才能让该方法执行
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @RequestMapping(value = "/info") 2 public class ItemController { 3 @RequestMapping(value = "/header",headers="Accept=application/json") 4 public List<Items> getItemById() { 5 return itemService.getItemList(); 6 } 7 } 8 /** 9 * 访问地址为:http://localhost:8080// info/header 10 * 且请求头中必须有 "Accept=application/json" 参数 ,该方法才能执行 11 **/
五、consumes 指定请求的内容类型例如Application/json , text/html
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @RequestMapping(value = "/info") 2 public class ItemController { 3 @RequestMapping(value = "/header", consumes ="application/json") 4 public List<Items> getItemById() { 5 return itemService.getItemList(); 6 } 7 } 8 /** 9 * 访问地址为:http://localhost:8080// info/header 10 * 该方法仅处理request Content-Type 为application/json 类型的请求 11 **/
六、produces 指定返回的内容类型,仅当request 请求头中的(Accept)类型包含该指定类型才能返回
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @RequestMapping(value = "/info") 2 public class ItemController { 3 @RequestMapping(value = "/header", produces ="application/json") 4 public List<Items> getItemById() { 5 return itemService.getItemList(); 6 } 7 } 8 /** 9 * 访问地址为:http://localhost:8080// info/header 10 * 该方法仅处理request请求头中(Accept)包含了 “application/json”, 11 * 同时暗示了返回的内容类型为 “application/json” 12 **/
@RequestParam 获取url 中的参数
@RequestParam 用于将url 中的的参数,映射到方法的参数上。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @RequestMapping(value = "/info") 2 public class ItemController { 3 @RequestMapping(value = "/body") 4 public String getItemByName(@RequestParam String username) { 5 return username(); 6 } 7 } 8 /** 9 * 访问地址为:http://localhost:8080// info/body 10 * 将url 路径中携带的名为username 的参数,赋值给方法username参数 11 * 即:http://localhost:8080// info/body?username=“张三” 则将张三赋值给username 12 **/
@RequestParam 注解有三个参数: value required defaultValue
1、value : 即url 路径中参数的名字
2、required : 是否必须,默认为 true ,表示请求中一定要有相应的参数,否者会抛出异常。
即:若上面代码中,url 路径中没有与方法同名的参数,将会抛出异常。
3、defaultValue : 默认值,表示若请求中没有同名参数时的默认值,设置该参数时,自动将required设为false。
注意:1、若url请求参数中没有对应的username 的参数,则会抛出异常
2、可以设置required 的值为false ,这样若url 请求中没有对应的参数,则会默认为null
如果请求中有多个同名的应该如何接收呢?如给用户授权时,可能授予多个权限,首先看下如下代码:
public String requestparam7(@RequestParam(value="role") String roleList)
如果请求参数类似于url?role=admin&rule=user,则实际roleList参数入参的数据为“admin,user”,即多个数据之间使用“,”分割;我们应该使用如下方式来接收多个请求参数:
public String requestparam7(@RequestParam(value="role") String[] roleList) 或者 public String requestparam8(@RequestParam(value="list") List<String> list)
@PathVariable 绑定URL 模板变量值
@PathVariable 可以将路径(url)中的参数映射到方法的参数上,
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 // 在请求路径中设置变量{itemId} 2 @RequestMapping("/json/info/{itemId}") 3 // 使用@PathVariable("itemId") 获取路径中的变量 itemId 的值 4 @ResponseBody 5 public Items getItemById(@PathVariable("itemId") int id) { 6 Items items = itemService.getItemById(id); 7 return items; 8 }
@ModelAttribute
ModelAttribute可以应用在方法参数上或方法上,他的作用主要是当注解在方法参数上时会将注解的参数对象添加到Model中;当注解在请求处理方法Action上时会将该方法变成一个非请求处理的方法,但其它Action被调用时会首先调用该方法。
@ModelAttribute注释一个方法
被@ModelAttribute注释的方法表示这个方法的目的是增加一个或多个模型(model)属性。这个方法和被@RequestMapping注释的方法一样也支持@RequestParam参数,但是它不能直接被请求映射。实际上,控制器中的@ModelAttribute方法是在同一控制器中的@RequestMapping方法被调用之前调用的。
被@ModelAttribute注释的方法用于填充model属性,例如,为下拉菜单填充内容,或检索一个command对象(如,Account),用它来表示一个HTML表单中的数据。
一个控制器可以有任意数量的@ModelAttribute方法。所有这些方法都在@RequestMapping方法被调用之前调用。
有两种类型的@ModelAttribute方法。一种是:只加入一个属性,用方法的返回类型隐含表示。另一种是:方法接受一个Model类型的参数,这个model可以加入任意多个model属性。
@SessionAttributes 将值放到session 域中
在默认情况下,ModelMap中的属性作用域是request级别,也就是说,当本次请求结束后,ModelMap 中的属性将销毁。如果希望在多个请求中共享ModelMap中的属性,必须将其属性转存到session 中,这样 ModelMap 的属性才可以被跨请求访问。
Spring 允许我们有选择地指定 ModelMap 中的哪些属性需要转存到 session 中,以便下一个请求属对应的 ModelMap 的属性列表中还能访问到这些属性。这一功能是通过类定义处标注 @SessionAttributes 注解来实现的。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 package demo.controller; 2 3 import org.springframework.stereotype.Controller; 4 import org.springframework.ui.ModelMap; 5 import org.springframework.web.bind.annotation.RequestMapping; 6 import org.springframework.web.bind.annotation.SessionAttributes; 7 8 import demo.model.User; 9 10 @Controller 11 @RequestMapping(value="/demo1") 12 //(1)将ModelMap中属性名为currUser的属性放到Session属性列表中,以便这个属性可以跨请求访问 13 @SessionAttributes("currUser") 14 public class Demo1Controller { 15 16 @RequestMapping(value="/getUser") 17 public String getUser(ModelMap model){ 18 User user=new User(); 19 user.setUser_name("zhangsan"); 20 user.setUser_age(25); 21 user.setUser_email("zhangsan@sina.com"); 22 //(2)向ModelMap中添加一个属性 23 model.addAttribute("currUser",user); 24 return "/demo/user"; 25 } 26 27 @RequestMapping(value="/getUser1") 28 public String getUser1(ModelMap model){ 29 User user=(User)model.get("currUser"); 30 System.out.println(user.getUser_name()); 31 System.out.println(user.getUser_age()); 32 System.out.println(user.getUser_email()); 33 return "demo/user1"; 34 } 35 }
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 <%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 2 <%@ page import="demo.model.User" %> 3 <% 4 String path = request.getContextPath(); 5 String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/"; 6 %> 7 8 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 9 <html> 10 <head> 11 <base href="<%=basePath%>"> 12 <title>My JSP 'index.jsp' starting page</title> 13 </head> 14 <body><br> 15 <%User user=(User)session.getAttribute("currUser");%> 16 用户名:<%=user.getUser_name() %><br/> 17 年龄:<%=user.getUser_age() %><br/> 18 邮箱:<%=user.getUser_email() %><br/><br/> 19 <a href="<%=path %>/demo1/getUser1">跳转</a> 20 </body> 21 </html>
如上例代码中,我们在getUser 方法上使用了@SessionAttributes 注解,所以在getUser方法中通过@SessionAttributes 注解将 ModelMap 中名为 currUser 的属性放置到 Session 中,所以我们不但可以在 getUser() 请求所对应的 JSP 视图页面中通过 request.getAttribute(“currUser”) 和 session.getAttribute(“currUser”) 获取 user 对象,还可以在下一个请求(getUser1())所对应的 JSP 视图页面中通过 session.getAttribute(“currUser”) 或 session.getAttribute(“currUser”)访问到这个属性。
这里我们仅将一个 ModelMap 的属性放入 Session 中,其实 @SessionAttributes 允许指定多个属性。你可以通过字符串数组的方式指定多个属性,如 @SessionAttributes({“attr1”,"attr2”})。此外,@SessionAttributes 还可以通过属性类型指定要 session 化的 ModelMap 属性,如 @SessionAttributes(types = User.class),当然也可以指定多个类,如 @SessionAttributes(types = {User.class,Dept.class}),还可以联合使用属性名和属性类型指定:@SessionAttributes(types = {User.class,Dept.class},value={“attr1”,"attr2”})。
@Controller @SessionAttributes("currentUser") public class GreetingController{ @RequestMapping public void hello(@ModelAttribute("currentUser") User user){ //user.sayHello() } }
通过@ModelAttribute绑定
@SessionAttributes 是用来在 controller 内部共享 model 属性的。
我们可以在需要访问 Session 属性的 controller 上加上 @SessionAttributes,然后在 action 需要的 User 参数上加上 @ModelAttribute,并保证两者的属性名称一致。SpringMVC 就会自动将 @SessionAttributes 定义的属性注入到 ModelMap 对象,在 setup action 的参数列表时,去 ModelMap 中取到这样的对象,再添加到参数列表。只要我们不去调用 SessionStatus 的 setComplete() 方法,这个对象就会一直保留在 Session 中,从而实现 Session 信息的共享。
@SessionAttributes清除
@SessionAttributes需要清除时,使用SessionStatus.setComplete();来清除。注意,它只清除@SessionAttributes的session,不会清除HttpSession的数据。故如用户身份验证对象的session一般不用它来实现,还是用session.setAttribute等传统的方式实现。
@ResponseBody 与 @RequestBody
@ResponseBody 是作用在方法上,表示将该方法的返回结果直接写入到HTTP response body 中,
我们在使用@RequestMapping 注解后,需要将返回值解析,然后将解析结果为跳转路径,加上@ResponseBody 注解后,返回结果不会被解析,而是直接写入HTTP response body 中。
比如:返回json 数据,加上@ResponseBody 后,会直接返回json 格式数据
示例:
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 @RequestMapping("/json/info/{itemId}") 2 @ResponseBody 3 public Items getItemById(@PathVariable("itemId") int id) { 4 Items items = itemService.getItemById(id); 5 return items; 6 }
@RequestBody 是作用在形参列表上,表示将HTTP 请求正文出入到方法中,使用适合HTTPMessageConverter 将请求体写入某个对象
比如 : 用来传输 json 格式数据时,使用@RequestBody
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 // 接收json 格式数据,并返回json 格式数据 2 @RequestMapping("/json/rec") 3 @ResponseBody // 返回json 格式数据 4 public Items getJsonItem(@RequestBody Items items) { // 接收json 格式数据 5 return items; 6 }