Spring MVC @Controller和@RequestMapping注解

从 Java 5 开始，Java 就增加了对注解（Annotation）的支持，它是代码中的一种特殊标记，可以在编译、加载和运行时被读取，执行相应的处理。通过注解，开发人员可以在不改变原有代码逻辑的情况下，在代码中嵌入补充信息。

Spring 从 2.5 版本开始提供了对注解技术的全面支持，以替换传统的 XML 配置，简化 Spring 的配置。作为 Spring 框架的一个子项目， Spring MVC 自然也提供了对注解的支持。

在 Spring MVC 中有两个十分重要的注解，它们分别是 @Controller 和 @RequestMapping 。本节，我们就针对这两个重要 Spring MVC 注解进行讲解。

@Controller 注解

@Controller 注解可以将一个普通的 Java 类标识成控制器（Controller）类，示例代码如下。

package net.biancheng.controller;
import org.springframework.stereotype.Controller;
@Controller
public class IndexController {
// 处理请求的方法
}

Spring MVC 是通过组件扫描机制查找应用中的控制器类的，为了保证控制器能够被 Spring MVC 扫描到，我们还需要在 Spring MVC 的配置文件中使用 <context:component-scan/> 标签，指定控制器类的基本包（请确保所有控制器类都在基本包及其子包下），示例代码如下。

<!-- 使用扫描机制扫描控制器类，控制器类都在net.biancheng.controller包及其子包下 -->
<context:component-scan base-package="net.biancheng.controller" />

@RequestMapping 注解

@RequestMapping 注解是 Spring MVC 中最常被用到的注解之一。它通常被标注在控制器方法上，负责将请求与处理请求的控制器方法关联起来，建立映射关系。

Spring MVC 的前端控制器（DispatcherServlet）拦截到用户发来的请求后，会通过 @RequestMapping 注解提供的映射信息找到对应的控制器方法，对这个请求进行处理。

@RequestMapping 注解的使用方式

@RequestMapping 既可以标注在控制器类上，也可以标注在控制器方法上。

1. 修饰方法

当 @RequestMapping  注解被标注在方法上时，value 属性值就表示访问该方法的 URL 地址。当用户发送过来的请求想要访问该 Controller 下的控制器方法时，请求路径就必须与这个 value 值相同，示例代码如下。

@Controller
public class HelloController {
@RequestMapping("/login")
public String welcome() {
return "login";
}
}

2. 修饰类

当 @RequestMapping 注解标注在控制器类上时，value 属性的取值就是这个控制器类中的所有控制器方法 URL 地址的父路径。也就是说，访问这个 Controller 下的任意控制器方法都需要带上这个父路径。

@Controller
@RequestMapping(value = "/springmvc")
public class HelloController {
@RequestMapping("/login")
public String welcome() {
return "login";
}
}

例如，在上面的控制类中，用户想要访问 HelloController 中的 welcome() 方法，请求的地址就必须带上父路径“/springmvc”，即请求地址必须为“/springmvc/login”。

@RequestMapping 注解的属性

@RequestMapping 注解中提供了多个可用属性，下面我们就对其中几个比较常用的属性进行介绍。

1. value 属性

在 @RequestMapping 注解中，value 属性用来设置控制器方法的请求映射地址。所有能够匹配到该请求映射地址的请求，都可以被该控制器方法处理，示例代码如下。

@RequestMapping(value = "/register")

value 属性是 @RequestMapping 注解的默认属性，如果我们在 @RequestMapping 注解中只设置了一个 value 属性，则该属性名可以被省略，示例代码如下。

//省略 value 属性名
@RequestMapping( "/register")

value 属性的取值是一个字符串类型的数组，表示该控制器方法可以匹配多个请求地址。 

@RequestMapping( value = {"/register", "/login"})
public String success() {
return "success";
}

2. name 属性

name 属性相当于方法的注释，用于解释这个方法是用来干什么的，使方法更易理解。

例如，下面的代码表示 getUsers() 方法是一个用来获取用户信息的控制器方法。

@RequestMapping(value = "toUser",name = "获取用户信息")
public String getUsers() {
……
}

3. method 属性

method 属性用来设置控制器方法支持的请求方式。如果一个控制器方法没有设置 @RequestMapping 注解的 method 属性，则说明该控制器方法支持全部请求类型，可以处理所有类型的请求。

method 属性的取值是一个 RequestMethod 类型的数组，表示一个控制器方法支持多种方式的请求，常用的请求方式有 GET、POST、DELETE、PUT 等。

例如，控制器方法只支持 GET 方式的请求，代码如下。

@RequestMapping(value = "/toUser",method = RequestMethod.GET)

我们也可以为同一个控制器方法指定支持多种类型的请求。例如，一个方法既支持 GET 方式的请求，也支持 POST 方式的请求，代码如下。

@RequestMapping(value = "/toUser",method = {RequestMethod.GET,RequestMethod.POST})，

4. params 属性

params 属性用于指定请求中的参数，只有当请求中携带了符条件的参数时，控制器方法才会对该请求进行处理。

我们可以通过以下 4 种表达式来对请求的参数进行配置。

序号	表达式	含义
①	"param"	请求中必须携带名为 param 的参数
②	"!param"	与表达式 ① 的含义完全相反，请求中不能携带名为 param 的参数
③	"param=value"	请求中必须携带名为 param 的参数，且参数的取值必须为：value
④	"param!=value"	与表达式 ③ 的含义完全相反，请求中不能携带参数：param = value。

params 属性的取值是一个字符串类型的数组，表示只有请求中同时携带了 params 属性指定的全部参数时，控制器方法才会对该请求进行处理。

例如，控制器方法 testParam() 的代码如下：

@RequestMapping(value = "/testParam", params = {"name=C语言中文网", "url=http://c.bianheng网站站点" rel="nofollow"  />  header 属性是一个字符换类型的数组，表示只有当请求同时携带数组中规定的所有头信息时，控制器方法才会对该请求进行处理。

例如，控制器方法 method() 的代码如下。
@RequestMapping(value = "toUser",headers = "Referer=http://c.biancheng网站站点" rel="nofollow"  />  
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3网站站点" rel="nofollow"  />    
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework网站站点" rel="nofollow"  />          
package net.biancheng.c.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
@Controller
@RequestMapping("/springmvc")
public class RequestMappingController {
/**
* @author c语言中文网
* @RequestMapping value、name、method 属性
*/
@RequestMapping(value = {"/welcome", "/do"}, name = "跳转到欢迎页", method = RequestMethod.GET)
public String testValue() {
return "welcome";
}
/**
* @author c语言中文网
* @RequestMapping 注解 params 属性
*/
@RequestMapping(value = "/testParam", params = {"name=springmvc", "url=http://c.biancheng网站站点" rel="nofollow"  />  
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf网站站点" rel="nofollow"  /> 
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf网站站点" rel="nofollow"  /> 
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf网站站点" rel="nofollow"  />