Postman发送请求，及后台接收

1、前言

在使用postman工具测试api接口的时候，如何使用 json 字符串传值呢，而不是使用 x-www-form-urlencoded 类型，毕竟经过 key-value 传值是有局限性的。假如我要测试批量插入数据的接口呢，使用 x-www-form-urlencoded 方法根本就不适用于这种场景。

那么如何经过postman工具使用json字符串传值呢，这里就引伸出来了spring的两个注解：

• @RequestParam

• @RequestBody

总而言之，这两个注解均可以在后台接收参数，可是使用场景不同。

2、@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是用来处理 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就派上用场了。继续往下看 ↓

3、@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>>，具体代码以下图所示：

postman请求：

控制台输出：

得出结论，经过@RequestBody能够解析Body中json格式的数据。

 

4、总结

注解@RequestParam接收的参数是来自requestHeader中，即请求头。一般用于GET请求，像POST、DELETE等其它类型的请求也可使用。

注解@RequestBody接收的参数是来自requestBody中，即请求体。通常用于处理非 Content-Type: application/x-www-form-urlencoded编码格式的数据，好比：application/json、application/xml等类型的数据。一般用于接收POST、DELETE等类型的请求数据，GET类型也能够适用。

@requestBody通常是将多个参数封装为一个对象时使用。访问方式为application/json 通常为post

@requestParam实例： 访问方式可为form表单 通常为get

public AjaxResult getCouponCode(    @RequestParam(name = "userId", required = false, defaultValue = "-1") long userId)

当接口请求是application/JSON时，直接发Json.toJSONString(对象)

public RebateRuleDTO queryRebateRule(GetRebateRule rebateRule) { return getObject(URLRebateConstant.URL_QUERY_REBATE_RULE, JSON.toJSONString(rebateRule), RebateRuleDTO.class, "queryRebateRule");