Controller中获取URI的属性的标签/类

一、核心注解 / 类详解（按使用频率排序）

1. @RequestParam（最常用）

作用

接收URL 请求参数（即 URL 中?后面的键值对，如http://localhost:8080/user?userId=123&name=张三）。

核心用法

@GetMapping("/user") // 基础用法：接收userId参数，参数名和方法参数名一致 public String getUser(@RequestParam Long userId) { return "用户ID：" + userId; } // 进阶用法：指定参数名、设置默认值、非必传 public String getUser( @RequestParam(value = "uid", required = false, defaultValue = "0") Long userId, @RequestParam String name // 省略value，默认匹配参数名name ) { return "用户ID：" + userId + "，姓名：" + name; }

关键特点

• 必传性：默认required = true，前端不传该参数会报 400 错误；
• 适配场景：GET 请求（URL 参数）、POST 请求（表单提交的参数）都能接收。

2. @PathVariable（路径参数）

作用

接收URL 路径中的动态参数（即 URL 中{}占位符的内容，如http://localhost:8080/user/123）。

核心用法

@GetMapping("/user/{userId}/{name}") public String getUser( @PathVariable Long userId, // 匹配路径中的{userId} @PathVariable("name") String userName // 路径名和参数名不一致时指定value ) { return "用户ID：" + userId + "，姓名：" + userName; }

关键特点

• 路径绑定：参数必须和 URL 中{}的名称对应，不传则报 404；
• 适配场景：RESTful 风格接口（如/user/123代替/user?userId=123）。

3. @Param（MyBatis 注解，非 Controller 参数）

⚠️ 注意：这个注解不是 Controller 接收前端参数的，是 MyBatis 中给 Mapper 接口方法参数命名的，很多人会混淆！

作用

给 MyBatis Mapper 接口的方法参数起别名，方便 XML / 注解中引用参数。

核心用法

// Mapper接口（非Controller） public interface UserMapper { // 用@Param给参数命名，XML中可通过#{userId}引用 User getUser(@Param("userId") Long id); } // 对应的MyBatis XML <select id="getUser" resultType="User"> SELECT * FROM user WHERE id = #{userId} </select>

4. HttpServletRequest（原生请求对象）

作用

Java EE 原生的请求对象，是所有 Spring 注解参数接收的 “底层实现”，可手动解析所有请求参数。

核心用法

@GetMapping("/user") public String getUser(HttpServletRequest request) { // 解析URL参数 String userId = request.getParameter("userId"); String name = request.getParameter("name"); // 还能获取请求头、Cookie、请求方法等 String token = request.getHeader("token"); return "用户ID：" + userId + "，姓名：" + name + "，Token：" + token; }

关键特点

• 万能但繁琐：能获取所有请求相关数据，但需要手动类型转换（如 String 转 Long）；
• 适配场景：特殊需求（如批量解析参数、自定义参数处理）。

二、补充：其他常用参数接收注解

1. @RequestBody

接收JSON 格式的请求体（POST/PUT 请求中，请求体为JSON 字符串），是前后端分离的核心注解：

@PostMapping("/user") public String addUser(@RequestBody User user) { // 前端传{"userId":123,"name":"张三"}，自动映射到User对象 return "新增用户：" + user.getName(); }

2. @RequestHeader

接收HTTP 请求头中的参数（如 Token、Content-Type 等）：

public String getUser(@RequestHeader("token") String token) { return "请求头Token：" + token; }

3. @CookieValue

接收Cookie 中的参数：

public String getUser(@CookieValue("sessionId") String sessionId) { return "Cookie中的SessionID：" + sessionId; }

三、核心区别与使用场景总结