SpringMVC框架学习笔记（二）：@RequestMapping 注解的各种用法

1 基本使用

@RequestMapping 注解可以指定控制器/处理器的某个方法的请求的 url，如下

@RequestMapping(value = "/login")
public String login(){}

2 @RequestMapping 注解其它使用方式

1.1 @RequestMapping 可以修饰方法和类

说明 : @RequestMapping 注解可以修饰方法，还可以修饰类 当同时修饰类和方法时，

请求的 url 就是组合 /类请求值/方法请求值

例如如下组合login()方法的请求url为： http://localhost:8080/web工程路径/login

@RequestMapping(value = "/user")
@Controller
public class UserServlet {

    //编写方法，响应用户的请求
    /**
     * 1.login方法是用于响应用户的登录请求
     * 2.@RequestMapping(value = "/login") 表示给控制器的这个方法配了一个url映射
     * 当用户在浏览器输入 http://localhost:8080/web工程路径/login 就能访问到login()
     * 3.return "login_ok"; 表示返回结果给视图解析器(InternalResourceViewResolver)
     * ,视图解析器会根据配置，来决定跳转哪个页面
     */
    @RequestMapping(value = "/login")
    public String login(){
        System.out.println("login ok....");
        return "login_ok";
    }
}

1.2 @RequestMapping 可以指定请求方式

说明: @RequestMapping 还可以指定请求的方式(post/get/put/delete..), 请求的方式需要和指定的一样，否则报错

//@PostMapping(value = "/buy")
@RequestMapping(value = "/buy",method = RequestMethod.POST)
public String buy() {
    System.out.println("购买商品~");
    return "success";
}

上述代码解读：

• method=RequestMethod.POST: 表示请求buy目标方法的请求方式必须是 post 

<form action="user/buy" method="post">
    购买人:<input type="text" name="username"><br>
    够买量:<input type="text" name="nums"><br>
    <input type="submit" value="购买">
</form>

• RequestMethod 四个常用选项 POST, GET, PUT, DELETE
• SpringMVC 控制器默认支持 GET 和 POST 两种方式 , 也就是你不指定 method , 可以接收
  GET 和 POST 请求
• 当明确指定了 method , 则需要按指定方式请求 , 否则会报错
• @PostMapping(value = "/buy") 等价与 @RequestMapping(value = "/buy",method = RequestMethod.POST)

1.3 @RequestMapping 可指定 params 支持简单表达式

@RequestMapping(value = "/find", params = "param1")

（1） params = "param1": 表示请求必须包含名为 param1 的请求参数

（2） params = "!=param1": 表示请求不能包含名为 param1 的请求参数

（3） params = "param1 != value1": 表示请求包含名为 param1 的请求参数，但其值不能为 value1

（4） params = {"param1=value1", "param2"}: 请求必须包含名为 param1 和 param2 的两个请求参数，且 param1 参数的值必须为 value1

实例：

前端携带参数发出请求

<hr><h1>演示params的使用</h1>
<a href="user/find?bookId=200">查询书籍</a>

后端接收请求

/**
 * 1. params="bookId" 表示请求该目标方法时，必须给一个bookId参数, 值没有限定
 * 2. search(String bookId): 表示请求目标方法时, 携带的bookId=100, 就会将请求携带的 bookId对应的
 * 值 100, 赋给 String bookId
 * 3. params = "bookId=100" 表示必须给一个bookId参数, 而且值必须是100
 */
@RequestMapping(value = "/find", params = "bookId=100", method = RequestMethod.GET)
public String search(String bookId) {
    System.out.println("查询书籍 bookId= " + bookId);
    return "success";
}

1.4 @RequestMapping 支持 Ant 风格资源地址

（1）? ：匹配文件名中的一个字符

（2）* ：匹配文件名中的任意字符

（3）**: 匹配多层路径

（4）Ant 风格的 url 地址举例

/user/*/createUser: 匹配 /user/aaa/createUser 、 /user/bbb/createUser 等 URL

/user/**/createUser: 匹配 /user/createUser 、 /user/aaa/bbb/createUser 等 URL

/user/createUser??: 匹配 /user/createUseraa 、 /user/createUserbb 等 URL

实例：

前端发出请求

<hr><h1>演示Ant风格的请求资源方式 </h1>
<a href="user/message/aa">发送消息1</a><br>
<a href="user/message/aa/bb/cc">发送消息2</a><br>

后端处理请求

/**
 * 要求: 可以配置  /user/message/aa, /user/message/aa/bb/cc
 * 1. @RequestMapping(value = "/message/**") /** 可以匹配多层路径
 */

@RequestMapping(value = "/message/**")
public String im() {
    System.out.println("发送消息");
    return "success";
}

1.5 @RequestMapping 可配合 @PathVariable 映射 URL 绑定的占位符

（1）@RequestMapping 还可以配合 @PathVariable 映射 URL 绑定的占位符。

（2）这样就不需要在 url 地址上带参数名，更加的简洁明了

实例：

前端请求

<hr><h1>占位符的演示</h1>
<a href="user/reg/kristina/300">占位符的演示</a>

后端接收请求

//前端页面: <a href="user/reg/kristina/300">占位符的演示</a>
//(value = "/reg/{username}/{userid}"): 表示kristina->{username} 300=>{userid}
@RequestMapping(value = "/reg/{username}/{userid}")
public String register(@PathVariable("username") String name,
                       @PathVariable("userid") String id) {
    System.out.println("接收到参数--" + "username= " + name + "--" + "usreid= " + id);
    return "success";
}

1.6 注意事项

（1）映射的 URL, 不能重复。如下情况就会报错

@RequestMapping(value = "/hi")
public String hi() {
    System.out.println("hi");
    return "success";
}
@RequestMapping(value = "/hi")
public String hi2() {
    System.out.println("hi");
    return "success";
}

（3）各种请求的简写形式

说明：@RequestMapping(value = "/buy",method = RequestMethod.POST) 等 价@PostMapping(value = "/buy")

其他简写方式：@GetMapping @PostMapping @PutMapping @DeleteMapping

（2）如果我们确定表单或者超链接会提交某个字段数据比如(email), 要求提交的参数名和目标方法形参的参数名保持一致。如果不一致，也不会报错，只是接收不到数据，参数值为null。如果参数类型不匹配，会报错，可以强转的类型会自动强转，所以一般数值型数据都用 String 接收，防止报错

例如：

前端请求 localhost:9998/user/hello3?email=tom@sohu.com

则后端可以这样接收

@GetMapping(value = "/hello3")
public String hello3(String email) {
    System.out.println("hello3 " + email);
    return "success";
}