SpringBoot請求參數(shù)傳遞與接收示例詳解
更新時間：2025年08月21日 10:55:38 作者：Whitekuma0914
本文給大家介紹SpringBoot請求參數(shù)傳遞與接收示例詳解,本文通過實例代碼給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友參考下吧
I. 基礎參數(shù)傳遞
i.查詢參數(shù)（Query Parameters）
請求示例：GET /user?name=John&age=25
@GetMapping("/user")
public String getUser(
@RequestParam String name,
@RequestParam(defaultValue = "20") int age) {
return "Name: " + name + ", Age: " + age;
}ii.路徑參數(shù)（Path Variables）
請求示例：GET /product/123
@GetMapping("/product/{id}")
public String getProduct(@PathVariable Long id) {
return "Product ID: " + id;
}iii.混合
請求示例：GET /order/456?status=shipped
@GetMapping("/order/{orderId}")
public String getOrder(
@PathVariable String orderId,
@RequestParam String status) {
return "Order " + orderId + " is " + status;
}II. 對象綁定
i.自動綁定到實體類
請求示例：GET /search?keyword=spring&page=2&size=10
public class SearchParams {
private String keyword;
private int page = 1;
private int size = 20;
// getters/setters方法
}
?
@GetMapping("/search")
public String search(SearchParams params) {
return "Searching: " + params.getKeyword()
+ " Page: " + params.getPage();
}ii.嵌套對象綁定
請求示例：GET /user?name=Alice&address.city=Beijing&address.zip=100001
public class UserQuery {
private String name;
private Address address;
// getters/setters
}
?
public class Address {
private String city;
private String zip;
}
?
@GetMapping("/user")
public String findUser(UserQuery query) {
return query.getName() + " in " + query.getAddress().getCity();
}III. JSON 請求體（POST/PUT/PATCH）
請求示例：POST /users Body: {"name":"Mike","email":"mike@example.com"}
// User實體
public class User {
private String id;
private String name;
private String email;
// getters/setters
}
?
@PostMapping("/users")
public User createUser(@RequestBody User user) {
user.setId(UUID.randomUUID().toString());
return user; // 自動轉為JSON
}IV、數(shù)組/集合參數(shù)
i.查詢參數(shù)數(shù)組
請求示例：GET /products?ids=101,102,103
@GetMapping("/products")
public String getProducts(@RequestParam List<Long> ids) {
return "IDs: " + ids.toString();
}ii.JSON 數(shù)組
請求示例：POST /batch Body: [{"name":"Item1"},{"name":"Item2"}]
@PostMapping("/batch")
public String batchCreate(@RequestBody List<Item> items) {
return "Created " + items.size() + " items";
}V、特殊參數(shù)處理
i.日期格式化
請求示例：GET /events?date=2023-05-15
@GetMapping("/events")
public String getEvents(@DateTimeFormat(pattern = "yyyy-MM-dd") Date date) {
return "Events on: " + date.toString();
}ii.可選參數(shù)
@GetMapping("/optional")
public String optionalParam(@RequestParam(required = false) String filter) {
return filter != null ? "Filter: " + filter : "No filter";
}iii.請求頭參數(shù)
@GetMapping("/auth")
public String auth(@RequestHeader("Authorization") String token) {
return "Token: " + token.substring(0, 5) + "...";
}VI、文件上傳
表單請求：multipart/form-data
@PostMapping("/upload")
public String uploadFile(@RequestParam("file") MultipartFile file) {
return "File received: " + file.getOriginalFilename()
+ " Size: " + file.getSize();
}VII、驗證參數(shù)（需spring-boot-starter-validation）
POST /register
public class Registration {
@NotBlank
private String username;
@Email
private String email;
@Min(18)
private int age;
}
@PostMapping("/register")
public ResponseEntity<?> register(@Valid @RequestBody Registration form) {
// 自動驗證參數(shù)
return ResponseEntity.ok("Valid");
}
// 全局異常處理
@ControllerAdvice
public class ValidationHandler {
@ResponseStatus(HttpStatus.BAD_REQUEST)
@ExceptionHandler(MethodArgumentNotValidException.class)
public Map<String, String> handleValidation(MethodArgumentNotValidException ex) {
Map<String, String> errors = new HashMap<>();
ex.getBindingResult().getFieldErrors().forEach(error ->
errors.put(error.getField(), error.getDefaultMessage()));
return errors;
}
}VIII、注解總結
| 注解 | 用途 | 示例場景 |
|---|---|---|
@RequestParam | 獲取查詢參數(shù) | ?name=value |
@PathVariable | 獲取路徑參數(shù) | /users/{id} |
@RequestBody | 獲取JSON/XML請求體 | POST/PUT請求 |
@ModelAttribute | 綁定表單數(shù)據 | HTML表單提交 |
@RequestHeader | 獲取請求頭值 | Authorization頭 |
@DateTimeFormat | 日期參數(shù)格式化 | ?date=2023-01-01 |
@RequestPart | 文件上傳 | multipart/form-data |
@Valid | 觸發(fā)參數(shù)驗證 | 配合JSR-303驗證注解 |
到此這篇關于SpringBoot請求參數(shù)傳遞與接收示例整理的文章就介紹到這了,更多相關SpringBoot請求參數(shù)內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
jpa實體@ManyToOne @OneToMany無限遞歸方式
這篇文章主要介紹了jpa實體@ManyToOne @OneToMany無限遞歸方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-10-10
springboot控制層傳遞參數(shù)為非必填值的操作
這篇文章主要介紹了springboot控制層傳遞參數(shù)為非必填值的操作，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-10-10
SpringBoot 自定義+動態(tài)切換數(shù)據源教程
這篇文章主要介紹了SpringBoot 自定義+動態(tài)切換數(shù)據源教程，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-12-12
這篇文章主要為大家詳細介紹了java實現(xiàn)圖片任意角度旋轉，具有一定的參考價值，感興趣的小伙伴們可以參考一下2019-04-04
在學習mybatis的時候,如果用log4j2來協(xié)助查看調試信息,則會大大提高學習的效率,加快debug速度,下面這篇文章主要給大家介紹了關于mybatis?log4j2打印sql+日志的相關資料,需要的朋友可以參考下2022-08-08
Idea創(chuàng)建多模塊maven聚合項目的實現(xiàn)
這篇文章主要介紹了Idea創(chuàng)建多模塊maven聚合項目的實現(xiàn)，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2019-12-12
這篇文章將用實例為大家詳細介紹了介紹如何解決Spring的循環(huán)依賴問題，文中的示例代碼講解詳細，對我們學習Spring有一定的幫助，需要的可以參考一下2022-07-07
文章介紹了如何在異步請求中傳遞traceId,通過重寫ThreadPoolTaskExecutor的方法和實現(xiàn)TaskDecorator接口來增強線程池,確保異步線程間的traceId同步2025-02-02
Java單線程程序實現(xiàn)實現(xiàn)簡單聊天功能
這篇文章主要介紹了Java單線程程序實現(xiàn)實現(xiàn)簡單聊天功能,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-10-10
Java提供了多種格式化輸出的方式,包括String.format()、System.out.printf()和Formatter類,這些方法支持數(shù)字、日期、字符串等多種格式化操作,這篇文章主要介紹了Java格式化輸出的相關資料,需要的朋友可以參考下2025-04-04