Spring MVC中@Controller和@RequestMapping注解详解

RequestMapping 注解类型

在基于注解的控制器类中可以为每个请求编写对应的处理方法。那么如何将请求与处理方法一一对应呢？

需要使用 org.springframework.web.bind.annotation.RequestMapping 注解类型将请求与处理方法一一对应。

1）方法级别注解

方法级别注解的示例代码如下：

1. package controller;
2. import org.springframework.stereotype.Controller;
3. import org.springframework.web.bind.annotation.RequestMapping;
4. /**
5. * “@Controller”表示 IndexController 的实例是一个控制器
6. *
7. * @Controller相当于@Controller(@Controller) 或@Controller(value="@Controller")
8. */
9. @Controller
10. public class IndexController {
11. @RequestMapping(value = "/index/login")
12. public String login() {
13. /**
14. * login代表逻辑视图名称，需要根据Spring MVC配置
15. * 文件中internalResourceViewResolver的前缀和后缀找到对应的物理视图
16. */
17. return "login";
18. }
19. @RequestMapping(value = "/index/register")
20. public String register() {
21. return "register";
22. }
23. }

上述示例中有两个 RequestMapping 注解语句，它们都作用在处理方法上。注解的 value 属性将请求 URI 映射到方法，value 属性是 RequestMapping 注解的默认属性，如果只有一个 value 属性，则可以省略该属性。

用户可以使用如下 URL 访问 login 方法（请求处理方法），在访问 login 方法之前需要事先在 /WEB-INF/jsp/ 目录下创建 login.jsp。

1. http://localhost:8080/springMVCDemo02/index/login

2）类级别注解

类级别注解的示例代码如下：

1. package controller;
2. import org.springframework.stereotype.Controller;
3. import org.springframework.web.bind.annotation.RequestMapping;
4. @Controller
5. @RequestMapping("/index")
6. public class IndexController {
7. @RequestMapping("/login")
8. public String login() {
9. return "login";
10. }
11. @RequestMapping("/register")
12. public String register() {
13. return "register";
14. }
15. }

在类级别注解的情况下，控制器类中的所有方法都将映射为类级别的请求。用户可以使用如下 URL 访问 login 方法。

1. http://localhost:8080/springMVCDemo02/index/login

为了方便维护程序，建议开发者采用类级别注解，将相关处理放在同一个控制器类中。例如，对商品的增、删、改、查处理方法都可以放在 GoodsOperate 控制类中。

编写请求处理方法

在控制类中每个请求处理方法可以有多个不同类型的参数，以及一个多种类型的返回结果。

1）请求处理方法中常出现的参数类型

如果需要在请求处理方法中使用 Servlet API 类型，那么可以将这些类型作为请求处理方法的参数类型。Servlet API 参数类型的示例代码如下：

1. package controller;
2. import javax.servlet.http.HttpSession;
3. import org.springframework.stereotype.Controller;
4. import org.springframework.web.bind.annotation.RequestMapping;
5. @Controller
6. @RequestMapping("/index")
7. public class IndexController {
8. @RequestMapping("/login")
9. public String login(HttpSession session,HttpServletRequest request) {
10. session.setAttribute("skey", "session范围的值");
11. session.setAttribute("rkey", "request范围的值");
12. return "login";
13. }
14. }

除了 Servlet API 参数类型以外，还有输入输出流、表单实体类、注解类型、与 Spring 框架相关的类型等，这些类型在后续章节中使用时再详细介绍。

其中特别重要的类型是 org.springframework.ui.Model 类型，该类型是一个包含 Map 的 Spring 框架类型。在每次调用请求处理方法时 Spring MVC 都将创建 org.springframework.ui.Model 对象。Model 参数类型的示例代码如下：

1. package controller;
2. import javax.servlet.http.HttpServletRequest;
3. import javax.servlet.http.HttpSession;
4. import org.springframework.stereotype.Controller;
5. import org.springframework.ui.Model;
6. import org.springframework.web.bind.annotation.RequestMapping;
7. @Controller
8. @RequestMapping("/index")
9. public class IndexController {
10. @RequestMapping("/register")
11. public String register(Model model) {
12. /*在视图中可以使用EL表达式${success}取出model中的值*/
13. model.addAttribute("success", "注册成功");
14. return "register";
15. }
16. }

2）请求处理方法常见的返回类型

最常见的返回类型就是代表逻辑视图名称的 String 类型，例如前面教程中的请求处理方法。除了 String 类型以外，还有 ModelAndView、Model、View 以及其他任意的 Java 类型。