一、前言
一直有這么一個疑問：在使用postman工具測試api接口的時候，如何使用 json 字符串傳值呢，而不是使用 x-www-form-urlencoded 類型，畢竟通過 key-value 傳值是有局限性的。假如我要測試批量插入數據的接口呢，使用 x-www-form-urlencoded 方法根本就不適用于這種場景。

那么如何通過postman工具使用json字符串傳值呢，這里就引申出來了spring的兩個注解：

• @RequestParam
• @RequestBody

總而言之，這兩個注解都可以在后臺接收參數，但是使用場景不一樣。繼續往下看 ↓

二、@RequestParam
先介紹一下@RequestParam的使用場景：

注解@RequestParam接收的參數是來自requestHeader中，即請求頭。通常用于GET請求，比如常見的url：http://localhost:8081/spring-boot-study/novel/findByAuthorAndType?author=唐家三少&type=已完結，其在Controller 層的寫法如下圖所示：

@RequestParam有三個配置參數：

required 表示是否必須，默認為 true，必須。
defaultValue 可設置請求參數的默認值。
value 為接收url的參數名（相當于key值）。
@RequestParam用來處理 Content-Type 為 application/x-www-form-urlencoded 編碼的內容，Content-Type默認為該屬性。

@RequestParam也可用于其它類型的請求，例如：POST、DELETE等請求。比如向表中插入單條數據，Controller 層的寫法如下圖所示：

由于@RequestParam是用來處理 Content-Type 為 application/x-www-form-urlencoded 編碼的內容的，所以在postman中，要選擇body的類型為 x-www-form-urlencoded，這樣在headers中就自動變為了 Content-Type : application/x-www-form-urlencoded 編碼格式。如下圖所示：

但是這樣不支持批量插入數據啊，如果改用 json 字符串來傳值的話，類型設置為 application/json，點擊發送的話，會報錯，后臺接收不到值，為 null。

這時候，注解@RequestBody就派上用場了。

三、@RequestBody

先介紹一下@RequestBody的使用場景：

注解@RequestBody接收的參數是來自requestBody中，即請求體。一般用于處理非 Content-Type: application/x-www-form-urlencoded編碼格式的數據，比如：application/json、application/xml等類型的數據。

就application/json類型的數據而言，使用注解@RequestBody可以將body里面所有的json數據傳到后端，后端再進行解析。

3.1 向表中批量插入數據
舉個批量插入數據的例子，Controller層的寫法如下圖所示：

由于@RequestBody可用來處理 Content-Type 為 application/json 編碼的內容，所以在postman中，選擇body的類型為row -> JSON(application/json)，這樣在 Headers 中也會自動變為 Content-Type : application/json 編碼格式。body內的數據如下圖所示：

批量向表中插入兩條數據，這里的 saveBatchNovel()方法已經封裝了 JPA的 saveAll() 方法。body 里面的 json 語句的 key 值要與后端實體類的屬性一一對應。

注意：前端使用$.ajax的話，一定要指定 contentType: “application/json;charset=utf-8;”，默認為 application/x-www-form-urlencoded。

3.2 后端解析json數據
上述示例是傳遞到實體類中的具體寫法，那么如果傳遞到非實體類中，body里面的json數據需要怎么解析呢？我們再來看下面這個例子：

在body中，我們還是輸入上面的json數據，根據分析，上面的json數據是一個List數組內嵌套著map對象，那么在后臺的接收形式可寫為 List<Map<String, String>>，具體代碼如下圖所示：

控制臺輸出：

四、總結
注解@RequestParam接收的參數是來自requestHeader中，即請求頭。通常用于GET請求，像POST、DELETE等其它類型的請求也可以使用。

注解@RequestBody接收的參數是來自requestBody中，即請求體。一般用于處理非 Content-Type: application/x-www-form-urlencoded編碼格式的數據，比如：application/json、application/xml等類型的數據。通常用于接收POST、DELETE等類型的請求數據，GET類型也可以適用。

**重點補充：**在使用注解@RequestParam的時候【不加注解的時候效果與@RequestParam類似】，在body data中我們不能傳json字符串類型的參數，否則對象中是接收不到傳遞參數相應的值。相應的在@RequestBody注解標記的形式上傳遞表格參數則會報錯。

postman模擬發送請求【@RequestParam接受json字符串】：

debug斷點后頁面展示的結果：

postman模擬發送請求【@RequestBody接受application/x-www-form-urlencoded表格參數】：

代碼以及報錯顯示：

總結

以上是生活随笔為你收集整理的注解@RequestParam【不添加默认项注解】与@RequestBody的使用场景的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。