SpringMVC常用的5种注解-精创网络云防护

帮助文档
SpringMVC常用的5种注解
来源：www.jcwlyf.com浏览：35更新：2025-11-23
SpringMVC 是一个基于 Java 的实现了 MVC 设计模式的请求驱动类型的轻量级 Web 框架，它通过一系列的注解来简化开发过程，提高开发效率。下面将详细介绍 SpringMVC 中常用的 5 种注解。
@Controller 注解
@Controller 注解是 SpringMVC 中最基础也是最常用的注解之一，它用于标识一个类为 SpringMVC 的控制器。在 Spring 框架中，控制器负责处理客户端的请求并返回相应的视图或数据。
使用 @Controller 注解的类会被 Spring 容器自动扫描并注册为一个 Bean。当客户端发送请求时，SpringMVC 会根据请求的 URL 找到对应的控制器方法进行处理。
示例代码如下：
```
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class HelloController {

    @RequestMapping("/hello")
    @ResponseBody
    public String hello() {
        return "Hello, SpringMVC!";
    }
}
```
在上述代码中，"HelloController" 类被 "@Controller" 注解标识为一个控制器。"@RequestMapping("/hello")" 注解用于映射请求的 URL，当客户端访问 "/hello" 时，会调用 "hello()" 方法。"@ResponseBody" 注解用于将方法的返回值直接作为响应体返回给客户端。
@RequestMapping 注解
@RequestMapping 注解用于将 HTTP 请求映射到控制器的处理方法上。它可以用于类级别和方法级别，类级别的注解可以为该类中的所有处理方法设置一个基础的请求路径，方法级别的注解则用于进一步细化请求路径。
@RequestMapping 注解支持多种属性，如 "value"、"method"、"params"、"headers" 等。
示例代码如下：
```
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/user")
public class UserController {

    @RequestMapping(value = "/list", method = RequestMethod.GET)
    @ResponseBody
    public String getUserList() {
        return "User List";
    }

    @RequestMapping(value = "/add", method = RequestMethod.POST)
    @ResponseBody
    public String addUser() {
        return "User Added";
    }
}
```
在上述代码中，"UserController" 类上的 "@RequestMapping("/user")" 注解为该类中的所有处理方法设置了基础路径 "/user"。"getUserList()" 方法的 "@RequestMapping" 注解指定了请求路径为 "/list"，请求方法为 "GET"；"addUser()" 方法的 "@RequestMapping" 注解指定了请求路径为 "/add"，请求方法为 "POST"。
@RequestParam 注解
@RequestParam 注解用于将请求参数绑定到控制器方法的参数上。当客户端发送请求时，可能会携带一些参数，使用 @RequestParam 注解可以方便地获取这些参数。
@RequestParam 注解支持多个属性，如 "value"、"required"、"defaultValue" 等。
示例代码如下：
```
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/param")
public class ParamController {

    @RequestMapping("/test")
    @ResponseBody
    public String testParam(@RequestParam(value = "name", required = false, defaultValue = "Guest") String name) {
        return "Hello, " + name;
    }
}
```
在上述代码中，"testParam()" 方法的 "@RequestParam" 注解将请求参数 "name" 绑定到方法的 "name" 参数上。"required = false" 表示该参数不是必需的，"defaultValue = "Guest"" 表示如果请求中没有提供该参数，则使用默认值 "Guest"。
@PathVariable 注解
@PathVariable 注解用于从 URL 路径中获取变量值。在 RESTful 风格的 API 中，经常会使用 URL 路径来传递参数，使用 @PathVariable 注解可以方便地获取这些参数。
示例代码如下：
```
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/user")
public class UserPathVariableController {

    @RequestMapping("/{id}")
    @ResponseBody
    public String getUserById(@PathVariable("id") int id) {
        return "User ID: " + id;
    }
}
```
在上述代码中，"getUserById()" 方法的 "@PathVariable" 注解将 URL 路径中的 "{id}" 变量绑定到方法的 "id" 参数上。当客户端访问 "/user/123" 时，"id" 参数的值将为 "123"。
@RequestBody 注解
@RequestBody 注解用于将 HTTP 请求的请求体绑定到控制器方法的参数上。当客户端发送的请求体是 JSON、XML 等格式的数据时，使用 @RequestBody 注解可以将这些数据自动转换为 Java 对象。
示例代码如下：
```
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;

class User {
    private String name;
    private int age;

    // Getters and Setters
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

@Controller
@RequestMapping("/user")
public class UserRequestBodyController {

    @RequestMapping(value = "/add", method = RequestMethod.POST)
    @ResponseBody
    public String addUser(@RequestBody User user) {
        return "User Name: " + user.getName() + ", Age: " + user.getAge();
    }
}
```
在上述代码中，"addUser()" 方法的 "@RequestBody" 注解将请求体中的 JSON 数据自动转换为 "User" 对象。客户端发送的请求体应该是一个符合 "User" 类结构的 JSON 数据，例如 "{"name": "John", "age": 30}"。
综上所述，SpringMVC 中的这 5 种注解在实际开发中非常常用，它们可以帮助开发者简化开发过程，提高开发效率。通过合理使用这些注解，可以使代码更加简洁、清晰，易于维护。
在使用这些注解时，需要注意它们的使用场景和属性设置，以确保能够正确地处理客户端的请求。同时，还可以结合其他 SpringMVC 的特性，如视图解析器、拦截器等，来构建更加完善的 Web 应用程序。
希望通过本文的介绍，你对 SpringMVC 中常用的 5 种注解有了更深入的理解和掌握。在实际开发中，可以根据具体的需求灵活运用这些注解，提高开发效率和代码质量。