SpringMVC 从入门到精通系列 03 —— 常用注解

1. RequestParam 注解

• 作用： 把请求中的指定名称的参数传递给控制器中的形参赋值

• 属性：

  1. value： 请求参数中的名称
  2. required： 请求参数中是否必须提供此参数，默认值是true，必须提供（如果不提供会报错）

• 代码如下：

  jsp:

  <a href="anno/testRequestParam?username=xiuyan">测试RequestParam</a>
  

  Controller：

  @Controller
  @RequestMapping(path = "/anno")
  public class AnnoController {
  
      @RequestMapping(path = "/testRequestParam")
      public String testRequestParam(@RequestParam(value = "username") String name){
          System.out.println("测试RequestParam注解");
          System.out.println(name);
          return "success";
      }
  }
  

  测试结果：
  

2. RequestBody 注解 ★

• 作用：用于获取请求体的内容（注意：get方法不可以）

• 属性： required，是否必须有请求体，默认值是true

• 代码如下：

  jsp：

  <form action="anno/testRequestBody" method="post">
      姓名：<input type="text" name="uname"><br>
      年龄：<input type="text" name="age"><br>
      <input type="submit" value="提交" />
  </form>
  

  Controller：

  @Controller
  @RequestMapping(path = "/anno")
  public class AnnoController {
  
      @RequestMapping(path = "/testRequestBody")
      public String testRequestBody(@RequestBody String body){
          System.out.println("测试RequestBody注解");
          System.out.println(body);
          return "success";
      }
  }
  

  测试结果：
  
  

  注：@RequestBody在实际运用中需要注意的地方

  后台用于接收对象，需注意三点：post请求方式、contentType、json对象的字符串（不是 json 对象）。

    
  

3. PathVariable 注解

• 作用：拥有绑定url中的占位符的。 例如：url中有/delete/{id}，{id}就是占位符

• 属性： value，指定url中的占位符名称

• Restful 风格的 URL：

  1. 请求路径一样，可以根据不同的请求方式去执行后台的不同方法
  2. restful风格的URL优点：结构清晰、符合标准、易于理解、扩展方便

• 代码如下：

  jsp：

  <a href="anno/testPathVariable/111">测试PathVariable</a>
  

  Controller：

  @Controller
  @RequestMapping(path = "/anno")
  public class AnnoController {
  
      @RequestMapping(path = "/testPathVariable/{sid}")
      public String testPathVariable(@PathVariable(name="sid") String id){
          System.out.println("测试PathVariable注解");
          System.out.println(id);
          return "success";
      }
  }
  

  

4. RequestHeader 注解（了解）

• 作用：获取指定请求头的值

• 属性： value，请求头的名称

• 代码如下

  @RequestMapping(path="/hello")
  public String sayHello(@RequestHeader(value="Accept") String header) {
  	System.out.println(header);
  	return "success";
  }
  

5. CookieValue 注解（了解）

• 作用：用于获取指定cookie的名称的值

• 属性： value，cookie的名称

• 代码：

  @RequestMapping(path="/hello")
  public String sayHello(@CookieValue(value="JSESSIONID") String cookieValue) {
  	System.out.println(cookieValue);
  	return "success";
  }
  

6. ModelAttribute 注解

• 作用：
  1. 出现在方法上：表示当前方法会在控制器方法执行前先执行。
  2. 出现在参数上：获取指定的数据给参数赋值。
• 应用场景： 当提交表单数据不是完整的实体数据时，保证没有提交的字段使用数据库原来的数据。
• 具体的代码：

有返回值：

jsp：

<form action="anno/testModuleAttribute" method="post">
	姓名：<input type="text" name="username"><br>
	年龄：<input type="text" name="age"><br>
	<input type="submit" value="提交" />
</form>

Controller：

@RequestMapping(path="/testModuleAttribute")
public String testModuleAttribute( User user){
    System.out.println("showUser方法执行了");
    System.out.println(user);
    return "success";
}

/**
 * 该方法会先执行（有返回值）
*/
@ModelAttribute
public User showUser(String username){
    System.out.println("测试ModuleAttribute注解");
    // 模拟通过 username 查询数据库
    User user = new User();
    user.setUsername("xiuyan");
    user.setAge(22);
    user.setDate(new Date());
    return user;
}

测试结果：

  结果显示，由于先执行 showUser 方法，在方法里面封装了 User 对象并返回，从而再执行 testModuleAttribute 方法时，不会因为传入表单没有传入日期属性，而导致日期属性为空。

无返回值：

@RequestMapping(path="/testModuleAttribute")
public String testModuleAttribute(@ModelAttribute("abc") User user){
    System.out.println("showUser方法执行了");
    System.out.println(user);
    return "success";
}

/**
 * 无返回值
 */
@ModelAttribute
public void showUser(String username, Map<String, User> map){
    System.out.println("测试ModuleAttribute注解");
    // 模拟通过 username 查询数据库
    User user = new User();
    user.setUsername("xiuyan");
    user.setAge(22);
    user.setDate(new Date());
    map.put("abc", user);
}

测试结果：

7. SessionAttributes 注解

• 作用：用于多次执行控制器方法间的参数共享

• 属性： value，指定存入属性的名称

• 代码如下：

  jsp：

  <a href="anno/testSessionAttributes">测试SessionAttributes</a><br>
  <a href="anno/getSessionAttributes">测试getSessionAttributes</a><br>
  <a href="anno/delSessionAttributes">测试delSessionAttributes</a><br>
  

  Controller：

  @Controller
  @RequestMapping(path = "/anno")
  @SessionAttributes(value = {"msg"})
  public class AnnoController {
  
      @RequestMapping(path="/testSessionAttributes")
      public String testSessionAttributes(Model model){
          System.out.println("testSessionAttributes方法执行了");
          //默认会将 msg 存入 request 域，当开启@SessionAttributes(value = {"msg"})，也会将 msg 存入 session
          model.addAttribute("msg", "haha");
          return "success";
      }
      @RequestMapping(path="/getSessionAttributes")
      public String getSessionAttributes(ModelMap model){
          System.out.println("getSessionAttributes方法执行了");
          String msg = (String) model.get("msg");
          System.out.println(msg);
          return "success";
      }
      @RequestMapping(path="/delSessionAttributes")
      public String delSessionAttributes(SessionStatus status){
          System.out.println("delSessionAttributes方法执行了");
          status.setComplete();
          return "success";
      }
  
  }
  

  成功页面：

  <%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
  <html>
  <head>
      <title>Title</title>
  </head>
  <body>
      <h3>成功页面</h3>
      ${requestScope.msg}
      ${sessionScope.msg}
  </body>
  </html>
  
  

  

8. RestController 注解 ★

参考链接：https://blog.csdn.net/qq_45754346/article/details/124596138