1. 基本用法
- 作用:从请求中提取查询参数或表单数据。
- 语法:
@RequestParam("参数名") 数据类型 参数名
- 示例:
@GetMapping("/greet") public String greet(@RequestParam("name") String name) { return "Hello, " + name + "!"; }
- 请求:
/greet?name=John
- 响应:
Hello, John!
- 请求:
2. 默认值
- 作用:当参数不存在时,使用默认值。
- 语法:
@RequestParam(value = "参数名", defaultValue = "默认值") 数据类型 参数名
- 示例:
@GetMapping("/greet") public String greet(@RequestParam(value = "name", defaultValue = "Guest") String name) { return "Hello, " + name + "!"; }
- 请求:
/greet
- 响应:
Hello, Guest!
- 请求:
3. 可选参数
- 作用:允许参数不存在。
- 语法:
@RequestParam(value = "参数名", required = false) 数据类型 参数名
- 示例:
@GetMapping("/greet") public String greet(@RequestParam(value = "name", required = false) String name) { return "Hello, " + (name != null ? name : "Guest") + "!"; }
- 请求:
/greet
- 响应:
Hello, Guest!
- 请求:
4. 绑定到对象
- 作用:将多个参数绑定到一个对象中。
- 示例:
public class User { private int id; private String name; // Getter 和 Setter 方法 } @GetMapping("/user") public String getUser(User user) { return "User ID: " + user.getId() + ", Name: " + user.getName(); }
- 请求:
/user?id=1&name=John
- 响应:
User ID: 1, Name: John
- 请求:
5. 绑定到集合或数组
- 作用:将多个同名参数绑定到集合或数组中。
- 示例:
@GetMapping("/hobbies") public String getHobbies(@RequestParam("hobby") List<String> hobbies) { return "Hobbies: " + String.join(", ", hobbies); }
- 请求:
/hobbies?hobby=Reading&hobby=Traveling
- 响应:
Hobbies: Reading, Traveling
- 请求:
6. 绑定到 Map
- 作用:将动态参数绑定到
Map
中。 - 示例:
@GetMapping("/params") public String getParams(@RequestParam Map<String, String> params) { return "Params: " + params.toString(); }
- 请求:
/params?name=John&age=25
- 响应:
Params: {name=John, age=25}
- 请求:
7. 处理复杂类型
- 作用:支持日期、枚举等复杂类型的转换。
- 示例:
@GetMapping("/date") public String getDate(@RequestParam("date") @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate date) { return "Date: " + date.toString(); }
- 请求:
/date?date=2023-10-01
- 响应:
Date: 2023-10-01
- 请求: