SpringBoot接收參數所有方式總結

更新時間：2024年07月04日 09:02:42 作者：鞋尖的灰塵

這篇文章主要介紹了SpringBoot接收參數所有方式總結,文中通過代碼示例和圖文結合的方式給大家介紹的非常詳細,對大家的學習或工作有一定的幫助,需要的朋友可以參考下

方法形參接收參數【不推薦】

此場景適用于請求參數比較少的情況
Springboot3.2會異常報錯: Name for argument of type [java.lang.String] not specified, and parameter name information not available via reflection. Ensure that the compiler uses the '-parameters' flag.
解決方案

@RequestMapping("/test1")
public String test1(String name,String age) {
    return String.format("name:%s,age:%s", name, age);
}

以實體類接受參數【不推薦】

此場景適用于請求參數比較多的情況

  @Getter
  @Setter
  public static class DTO {
      private String name;
?
      private Integer age;
  }
?
  @RequestMapping("/test2")
  public String test2(DTO request) {
      return String.format("name:%s,age:%s", request.getName(), request.getAge());
  }

以形參和實體類接受參數【不推薦】

Springboot3.2會異常報錯: Name for argument of type [java.lang.String] not specified, and parameter name information not available via reflection. Ensure that the compiler uses the '-parameters' flag.
解決方案

  @RequestMapping("/test3")
  public String test3(DTO requestDto,String sex) {
      return String.format("name:%s,age:%s,sex:%s", requestDto.getName(), requestDto.getAge(),sex);
  }

上述三種接受參數的方式，只能用來獲取query-params,form-data,x-www-form-urlencoded格式數據

@PathVariable注解

@PathVariable 注解可用于處理請求 URI 映射中的模板變量，并將其綁定到 Controller 方法參數

使用 @PathVariable 注解來提取 URI 的模板部分，該部分由變量 {name} 表示

  @RequestMapping("/test4/{name}/{age}")
  public String test4(@PathVariable("name") String name,@PathVariable("age") Integer age) {
      return String.format("name:%s,age:%s", name, age);
  }

指定路徑變量名

由于方法參數和路徑變量的名稱相同，可以不用主動設置模板路徑變量的名稱。如果路徑變量名不同，可以在 @PathVariable 注解的參數中指定

@GetMapping("/test5/{name}")
public String test4(@PathVariable("name") String id) {
    return String.format("name:%s",id);
}

單個請求中的多個路徑變量

@GetMapping("/test5/{name}/{id}")
public String test5(@PathVariable(value = "name") String name,@PathVariable(value = "id") String id) {
    return String.format("name:%s id:%s", name, id);
}

java.util.Map<String, String> 類型的方法參數來處理多個 `@PathVariable 參數 [不推薦]

@GetMapping("/test5/{name}/{id}")
public String test6(@PathVariable Map<String,String> request) {
    return JSON.toJSONString(request);
}

可選擇的路徑變量

  @RequestMapping(value = {"/test6","test6/{name}/{age}"})
  public String test6(@PathVariable("name") String name,@PathVariable("age") Integer age) {
      return String.format("name:%s,age:%s", name, age);
  }

咋一看，上述 Controller 應該可以處理 /test6 和 /test6/smile/32 請求。但是，由于 @PathVariables 所注解的方法參數默認為必選參數，因此它無法處理 /api/employeeswithrequired 請求

有三種不同的方法來處理這個問題

設置required為false

  @RequestMapping(value = {"/test6","test6/{name}/{age}"})
  public String test6(@PathVariable(value = "name",required = false) String name,@PathVariable(value = "age",required = false) Integer age) {
      return String.format("name:%s,age:%s", name, age);
  }

使用 java.util.Optional

  @RequestMapping(value = {"/test7","test7/{name}/{age}"})
  public String test7(@PathVariable Optional<String> name,@PathVariable Optional<String> age) {
      return String.format("name:%s,age:%s", name.orElse("null"), age.orElse("null"));
  }

使用 Map<String, String> 類型的方法參數 [不推薦]

  @RequestMapping(value = {"/test8","test8/{name}/{age}"})
  public String test8(@PathVariable Map<String,String> request) {
      return String.format("name:%s,age:%s", request.get("name"), request.get("age"));
  }

@RequestParam

可以使用 @RequestParam 從請求中提取查詢參數、表單參數甚至是多個參數

指定請求參數名稱

如果變量名稱和參數名稱不同，可以使用 name 屬性配置 @RequestParam 名稱：

  @RequestMapping("/test9")
  public String test9(@RequestParam("name") String name,@RequestParam("age") Integer age) {
      return String.format("name:%s,age:%s", name, age);
?
  }

也可以使用 @RequestParam(value = "name") 或直接使用 @RequestParam("name")

可選的請求參數

使用 @RequestParam 注解的方法參數默認為必填參數。這意味著，如果請求中沒有該參數，就會返回 400 錯誤
- 可以使用 required 屬性將 @RequestParam 配置為可選參數：

  @RequestMapping("/test10")
  public String test10(@RequestParam(value = "name",required = false) String name,@RequestParam(value = "age",required = false) Integer age) {
      return String.format("name:%s,age:%s", name, age);
  }

如果沒有指定參數，方法參數將綁定為 null

使用 Java 8 Optional

  @RequestMapping("/test11")
  public String test11(@RequestParam(value = "name") Optional<String> name,@RequestParam(value = "age") Optional<Integer> age) {
      return String.format("name:%s,age:%s", name.orElse(null), age.orElse(null));
  }

在這種情況下，不需要指定 required 屬性。

如果沒有提供請求參數，則使用默認值：

請求參數的默認值

還可以使用 defaultValue 屬性為 @RequestParam 設置默認值

  @RequestMapping("/test12")
  public String test12(@RequestParam(value = "name",defaultValue = "smile") Optional<String> name,@RequestParam(value = "age") Optional<Integer> age) {
      return String.format("name:%s,age:%s", name.orElse(null), age.orElse(null));
  }

與 required=false 類似，用戶不再需要提供參數：

注意，當設置 defaultValue 屬性時，required 會被被設置為 false

映射所有參數

還可以使用 Map 來封裝多個參數，而無需定義它們的名稱（name）或數量：

  @RequestMapping("/test13")
  public String test13(@RequestParam Map<String,String> request) {
      return String.format("name:%s,age:%s", request.get("name"), request.get("age"));
  }

多值參數（列表/數組）

一個 @RequestParam 可以有多個值：

  @RequestMapping("/test14")
  public String test14(@RequestParam("id") List<String> idList) {
      return String.format(JSON.toJSONString(idList));
  }

@RequestBody

將HttpRequest主體映射到方法上實體屬性中

以字符串的方式接收 body 的數據

  @PostMapping("/test15")
  public String test15(@RequestBody String requestString) {
      return requestString;
  }

以Map的方式接收body 的數據

  @RequestMapping("/test16")
  public String test16(@RequestBody Map<String,Object> requestMap) {
      return String.format(JSON.toJSONString(requestMap));
  }

以實體類的方式接收body 的數據【最常用】

  @RequestMapping("/test17")
  public String test17(@RequestBody DTO requestDto) {
      return String.format(JSON.toJSONString(requestDto));
  }

當body中沒有任何數據傳遞時，會拋出異常：Resolved [org.springframework.http.converter.HttpMessageNotReadableException: Required request body is missing: public java.lang.String com.fs.smile.home.controller.RequestController.test16(java.util.Map<java.lang.String, java.lang.Object>)]這種情況，應該如何解決

可以使用 required 屬性將 @RequestBody 配置為可選參數

  @RequestMapping("/test17")
  public String test17(@RequestBody DTO requestDto) {
      return String.format(JSON.toJSONString(requestDto));
  }

使用 Java 8 Optional

在這種情況下，不需要指定 required 屬性

  @RequestMapping("/test18")
  public String test18(@RequestBody Optional<Map<String,Object> > requestMap) {
      return String.format(JSON.toJSONString(requestMap.orElse(null)));
  }

@RequestBody接收數據的格式要求

Content-Type: application/json
Content-Type: application/xml
Content-Type: text/plain
Content-Type: application/octet-stream

根據不同的Content-Type等情況,Spring-MVC會采取不同的HttpMessageConverter實現來進行信息轉換解析。@RequestBody不能用來處理application/x-www-form-urlencoded 或 multipart/form-data 格式的請求數據，如果嘗試使用 @RequestBody 來處理這類請求，通常會遇到 415 Unsupported Media Type 異常。要處理這兩種格式的數據，應該使用 @RequestParam 或 @ModelAttribute 注解

@RequestHeader

RequestHeader主要用來獲取請求當中的請求頭

獲取單個header屬性

  @RequestMapping("/test20")
  public String test20(@RequestHeader("name") String name,@RequestHeader("age") Integer age) {
      return String.format("name:%s,age:%s", name, age);
  }

當header中不存在該參數時，系統會拋出400的異常，可以參考@PathVariable的處理方案

獲取所有header屬性

@RequestMapping("/test21")
public String test21(@RequestHeader Map<String,String> headers) {
    return String.format("name:%s,age:%s", headers.get("name"), headers.get("age"));
}

獲取header對象

@RequestMapping("/test22")
public String test22(@RequestHeader HttpHeaders headers) {
    return String.format("name:%s,age:%s", headers.get("name"), headers.get("age"));
}

以上就是SpringBoot接受參數所有方式總結的詳細內容，更多關于SpringBoot接受參數的資料請關注腳本之家其它相關文章！

您可能感興趣的文章:

ElasticSearch查詢文檔基本操作實例
這篇文章主要為大家介紹了ElasticSearch查詢文檔基本操作實例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪
2023-02-02
Spring MVC 學習之 - URL參數傳遞詳解
本篇文章主要介紹了SpringMVC-URL參數傳遞，在學習 Spring Mvc 過程中，有必要來先了解幾個關鍵參數，有興趣的可以了解一下。
2017-01-01
java加密枝術深入理解
java.security包中的MessageDigest類提供了計算消息摘要的方法，本文將詳細介紹，需要了解的朋友可以參考下
2012-11-11
SpringCloud降級規(guī)則使用介紹
這篇文章主要介紹了SpringCloud降級規(guī)則，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2022-08-08
Maven插件的安裝及使用
這篇文章主要介紹了Maven插件的安裝及使用，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2020-09-09
java讀取資源路徑的幾種實現方式
文章總結了Java讀取資源路徑的幾種方式,并指出了在JUnit測試文件和普通類中讀取資源路徑的區(qū)別,普通類中讀取資源路徑時,只返回主目錄,而JUnit測試文件中可以精確到所在模塊
2025-02-02
Java通過在主循環(huán)中判斷Boolean來停止線程的方法示例
這篇文章主要介紹了Java通過在主循環(huán)中判斷Boolean來停止線程的方法,結合具體實例形式分析了java針對線程的判斷與停止操作相關實現技巧,需要的朋友可以參考下
2017-04-04
解決idea 項目編譯后沒有class文件的問題
這篇文章主要介紹了解決idea 項目編譯后沒有class文件的問題，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧
2020-12-12
SpringBoot實現RabbitMQ監(jiān)聽消息的四種方式
本文主要介紹了SpringBoot實現RabbitMQ監(jiān)聽消息的四種方式,包括@RabbitListener,MessageListener接口,MessageListenerAdapter適配器,@RabbitHandler這幾種,感興趣的可以了解一下
2024-05-05
spring-boot項目啟動遲緩異常排查解決記錄
這篇文章主要為大家介紹了spring-boot項目啟動遲緩異常排查解決記錄，突然在本地啟動不起來了，表象特征就是在本地IDEA上運行時，進程卡住也不退出，應用啟動時加載相關組件的日志也不輸出
2022-02-02