Spring MVC @RequestMapping @ResponseBody @RequestBody @PathVariable @RestController ...总结

### Spring MVC 注解详解 #### @RequestMapping 的使用场景及特点 `@RequestMapping` 是一个基础性的注解，可用于类级别和方法级别。当应用于类时，它定义了一个公共的基础路径，该路径会与方法级别的路径组合形成最终访问地址[^1]。 对于具体的 HTTP 请求方式支持，虽然 `@RequestMapping` 能够接收所有的 HTTP 方法（GET, POST 等），但在实际开发中更推荐使用其衍生出来的专门用于某一种请求类型的子注解，比如 `@GetMapping`, `@PostMapping` 等，因为这些子注解具有更高的语义清晰度并能减少代码量[^2]。 ```java // 类级注解设置全局前缀 @RequestMapping("/api") public class MyController { // GET /api/resource @RequestMapping(value="/resource", method=RequestMethod.GET) public String getResource(){ return "Resource"; } } ``` #### @RequestParam 和 @PathVariable 对比 两者都用来传递参数给控制器的方法，但是它们的工作机制有所不同： - **@RequestParam**: 主要用于获取查询字符串中的键值对形式的数据，即 URL 后面跟问号后面的部分(`?key=value`)。如果希望从表单提交或者链接后面的参数里取数据就用这个注解[^4]。 ```java // http://localhost:8080/api/user?id=123&name=testUser @GetMapping("/user") public User getUser(@RequestParam Long id, @RequestParam String name){ return userService.findUserByIdAndName(id,name); } ``` - **@PathVariable**: 则是用来捕获 URI 模板中的动态部分，也就是 URL 中的占位符 `{}` 。这种方式使得 RESTful 风格 API 更加直观易读[^5]. ```java // http://localhost:8080/api/users/123 @GetMapping("/users/{id}") public User getUserById(@PathVariable("id") long userId){ return userService.findById(userId); } ``` #### @RequestBody 和 @ResponseBody 解析 这两个注解主要用于处理 JSON 或 XML 形式的实体内容传输： - **@RequestBody**: 接收客户端发送过来的内容体，并将其转换成 Java 对象实例化传入控制层函数内作为参数. ```java @PostMapping("/addUser") public ResponseEntity<String> addUser(@RequestBody User user){ userService.save(user); return new ResponseEntity<>("success", HttpStatus.CREATED); } ``` - **@ResponseBody**: 将返回的对象序列化为 JSON/XML 字符串响应给前端浏览器显示. 它通常配合 `@RestController` 来简化视图解析过程. ```java @RestController public class UserController{ @GetMapping("/getUserJson") public User getUserJson(){ return userService.findOne(); } } ```