Java中如何区分POST、GET请求与@RequestBody、@RequestParam使用差异?

2026-05-25 23:312阅读0评论SEO教程
  • 内容介绍
  • 文章标签
  • 相关推荐

本文共计2279个文字,预计阅读时间需要10分钟。

Java中如何区分POST、GET请求与@RequestBody、@RequestParam使用差异?

目录 + @RequestParam + @RequestBody + 后端解析JSON数据 + POST请求时 + 总结 + 参考:@RequestParam + 注解@RequestParam接收的参数来自HTTP请求体或请求URL的QueryString。@RequestParam可以接收简单类型属性,也支持复杂类型属性。

目录
  • @RequestParam
  • @RequestBody
    • 后端解析json数据
  • POST请求时
    • 总结
      • 参考:

        @RequestParam

        注解@RequestParam接收的参数是来自HTTP请求体或请求url的QueryString中。

        RequestParam可以接受简单类型的属性,也可以接受对象类型。

        @RequestParam有三个配置参数:

        • required表示是否必须,默认为true,必须。
        • defaultValue可设置请求参数的默认值。
        • value为接收url的参数名(相当于key值)。

        @RequestParam用来处理 Content-Typeapplication/x-www-form-urlencoded 编码的内容,Content-Type默认为该属性。@RequestParam也可用于其它类型的请求,例如:POST、DELETE等请求

        所以在postman中,要选择body的类型为 x-www-form-urlencoded,这样在headers中就自动变为了 Content-Type : application/x-www-form-urlencoded 编码格式。如下图所示:

        但是这样不支持批量插入数据啊,如果改用 json 字符串来传值的话,类型设置为 application/json,点击发送的话,会报错,后台接收不到值,为 null

        但可以入参后再转换,参考如下:

        @PostMapping("/ali-receive") public void aliReceive(@RequestParam("message") String message) { ReceiveLog receiveLog = JSON.parseObject(message, ReceiveLog.class); }

        解决Spring/SpringBoot @RequestParam注解无法读取application/json格式数据:www.jb51.net/article/265478.htm

        @RequestParam 接受JSON的字符串:

        @RequestParam

        1.用来处理Content-Type: 为 application/x-www-form-urlencoded编码的内容。(Http协议中,如果不指定Content-Type,则默认传递的参数就是application/x-www-form-urlencoded类型)

        @RequestParam可以接受简单类型的属性,也可以接受对象类型。

        2.用来处理 multipart/form-data (表单上传的)

        如何使用@RequestParam 接受JSON的字符串

        - 前端代码

        const message = { "data": { "userInfo": "2804951212", "offerId": offerId, "action": "distribution", "categoryNav": categoryNav }, "gmtBorn": time, "msgId": time, "type": "PRODUCT_COLLECTION", "userInfo": "chrome" }; $.ajax({ contentType :'application/x-www-form-urlencoded', type:'post', url: baseUrl+'/ali-receive', data:"message="+JSON.stringify(message) });

        后端代码

           @PostMapping("/ali-receive")     public void aliReceive(@RequestParam("message") String message) {                 ReceiveLog receiveLog = JSON.parseObject(message, ReceiveLog.class);     }

        @RequestBody

        一般用来处理 Content-Type: 为application/json

        不推荐使用@RequestParam接收application/json,这时候就需要使用到@RequestBody。

        @RequestBody

        注解@RequestBody接收的参数是来自requestBody中,即请求体。一般用于处理非 Content-Type: application/x-www-form-urlencoded编码格式的数据,比如:application/jsonapplication/xml等类型的数据。

        application/json类型的数据而言,使用注解@RequestBody可以将body里面所有的json数据传到后端,后端再进行解析。

        GET请求中,因为没有HttpEntity,所以@RequestBody并不适用。

        POST请求中,通过HttpEntity传递的参数,必须要在请求头中声明数据的类型Content-Type,SpringMVC通过使用

        HandlerAdapter 配置的HttpMessageConverters来解析HttpEntity中的数据,然后绑定到相应的bean上。

        向表中批量插入数据

        举个批量插入数据的例子,Controller层的写法如下图所示:

        由于@RequestBody可用来处理 Content-Typeapplication/json 编码的内容,所以在postman中,选择body的类型为row -> JSON(application/json),这样在 Headers 中也会自动变为 Content-Type : application/json 编码格式。body内的数据如下图所示:

        批量向表中插入两条数据,这里的 saveBatchNovel()方法已经封装了 JPAsaveAll() 方法。body 里面的 json 语句的 key 值要与后端实体类的属性一一对应。

        注意:前端使用$.ajax的话,一定要指定 contentType: "application/json;charset=utf-8;",默认为 application/x-www-form-urlencoded

        后端解析json数据

        上述示例是传递到实体类中的具体写法,那么如果传递到非实体类中,body里面的json数据需要怎么解析呢?我们再来看下面这个例子:

        在body中,我们还是输入上面的json数据,根据分析,上面的json数据是一个List数组内嵌套着map对象,那么在后台的接收形式可写为 List<Map<String, String>>,具体代码如下图所示:

        postman请求:

        控制台输出:

        得出结论,通过@RequestBody可以解析Body中json格式的数据。

        POST请求时

        @RequestBody --> JSON字符串部分

        @RequestParam --> 请求参数部分

        application/json格局图

        form-data、x-www-form-urlencoded格局图

        1、从content-type方面总结:

        ① form-data、x-www-form-urlencoded:不可以用@RequestBody;可以用@RequestParam。见postman的格局,这两种方式的时候没有json字符串部分。

        ② application/json:json字符串部分可以用@RequestBody;url中的?后面参数可以用@RequestParam。见postman的格局

        2、从两种注解方式总结:

        @RequestBody

        (@RequestBody Map map) (@RequestBody Object object) application/json时候可用 form-data、x-www-form-urlencoded时候不可用

        @RequestParam

        (@RequestParam Map map) application/json时候,json字符串部分不可用,url中的?后面添加参数即可用,form-data、x-www-form-urlencoded时候可用,但是要将Headers里的Content-Type删掉

        (@RequestParam String waterEleId,@RequestParam String enterpriseName) application/json时候,json字符串部分不可用,url中的?后面添加参数即可用 form-data、x-www-form-urlencoded时候可用,且参数可以没有顺序(即前端传过来的参数或者url中的参数顺序不必和后台接口中的参数顺序一致,只要字段名相同就可以),但是要将Headers里的Content-Type删掉

        (@RequestParam Object object) 不管application/json、form-data、x-www-form-urlencoded都不可用

        既不是@RequestBody也不是@RequestParam,没有指定参数哪种接收方式

        (Map map) (Object object) application/json时候:json字符串部分不可用,url中的?后面添加参数不可用。 因为没有指定,它也不知道到底是用json字符串部分还是?后面添加参数部分,所以干脆都不可以用 form-data、x-www-form-urlencoded时都不可用,见图二 (HttpServletRequest request) application/json不可用 form-data、x-www-form-urlencoded时可用

        GET请求

        @RequestBody

        RequestBody -- Map / Object GET请求中不可以使用@RequestBody

        @RequestParam

        (@RequestParam Map map) 在url中的?后面添加参数即可使用

        (@RequestParam String waterEleId,@RequestParam String enterpriseName) 在url中的?后面添加参数即可使用

        (@RequestParam Object object) GET请求中不可以使用

        当使用GET请求时,通过postman添加?后面的参数,不用在url中自己一个一个拼,点击Params,在下面key-value中输入就自动拼接到url中

        举栗子

        上传文件,包含了图中圈出来的两部分

        如果这样,没有@RequestParam,那么url?后的参数就拿不到

        @RequestMapping(value = "/leadingIn", method = RequestMethod.POST) public ResponseObj<Boolean> leadingIn(Map formData, HttpServletRequest request, Map<String, InputStream> files) { }

        如果control中这样接收,本来想formData只接收url?后的参数,结果将{ "retCode": null, "data": true }这部分内容也拿到了,真实意外之喜。字符串这部分内容还可以从request中取到,见下面完整方法。

        @RequestMapping(value = "/leadingIn", method = RequestMethod.POST) public ResponseObj<Boolean> leadingIn(@RequestParam Map formData, HttpServletRequest request, Map<String, InputStream> files) { }

        完整方法

        /** * 导入 */ @RequestMapping(value = "/leadingIn", method = RequestMethod.POST) public ResponseObj<Boolean> leadingIn(@RequestParam Map formData, HttpServletRequest request, Map<String, InputStream> files) { //测试 try { MultipartHttpServletRequest mulRequest = (MultipartHttpServletRequest) request; Set<Map.Entry<String, MultipartFile>> set = mulRequest.getFileMap().entrySet(); Map<String, InputStream> listFile = new LinkedHashMap<>(); System.out.println("个数" + set.size()); for (Map.Entry<String, MultipartFile> each : set) { String fileName = each.getKey(); MultipartFile file = each.getValue(); //这里需要上传FTP try { listFile.put(fileName, file.getInputStream()); } catch (Exception ex) { return new ResponseObj<>(false, null); } } String formjson = mulRequest.getParameter("content"); ObjectMapper mapper = new ObjectMapper(); mapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY); mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); // boolean result = iInstallWorkOrder.upLoadFile(listFile); boolean result = true; return new ResponseObj<>(result, null); } catch (Exception ex) { System.out.println(ex.toString()); return new ResponseObj<>(false, null); } }

        按F12看一下Network里对应请求:

        使用@RequestParam:Content-Type为application/x-www-form-urlencoded,参数在FormData中

        使用@RequestBody:Content-Type为application/json,参数在Request PayLoad中

        总结

        •在GET请求中,不能使用@RequestBody。

        •在POST请求,可以使用@RequestBody和@RequestParam,但是如果使用@RequestBody,对于参数转化的配置必须统一。

        可以使用多个@RequestParam获取数据,@RequestBody不可以 举个例子,在SpringMVC配置了HttpMessageConverters处理栈中,指定json转化的格式,如Date转成‘yyyy-MM-dd’,则参数接收对象包含的字段如果是Date类型,就只能让客户端传递年月日的格式,不能传时分秒。因为不同的接口,它的参数可能对时间参数有不同的格式要求,所以这样做会让客户端调用同事对参数的格式有点困惑,所以说扩展性不高。 如果使用@RequestParam来接受参数,可以在接受参数的model中设置@DateFormat指定所需要接受时间参数的格式。 另外,使用@RequestBody接受的参数是不会被Servlet转化统一放在request对象的Param参数集中,@RequestParam是可以的。

        另外,还有一种应用场景,接口规范为resultful风格时,举个例子:如果要获取某个id下此条问题答案的查询次数的话,则后台就需要动态获取参数,其注解为@PathVariable,并且requestMapping中的value应为value="/{id}/queryNum",截图如下:

        到此这篇关于Java中POST、GET、@RequestBody和@RequestParam区别详析的文章就介绍到这了,更多相关POST GET @RequestBody和@RequestParam区别内容请搜索自由互联以前的文章或继续浏览下面的相关文章希望大家以后多多支持自由互联!

        参考:

        @RequestParam @RequestBody @PathVariable 等参数绑定注解详解

        blog.csdn.net/walkerjong/article/details/7946109

        Java中如何区分POST、GET请求与@RequestBody、@RequestParam使用差异?

        my.oschina.net/u/3372000/blog/906217

        www.jianshu.com/p/4981911d5e15

        cloud.tencent.com/developer/article/1414464

        本文共计2279个文字,预计阅读时间需要10分钟。

        Java中如何区分POST、GET请求与@RequestBody、@RequestParam使用差异?

        目录 + @RequestParam + @RequestBody + 后端解析JSON数据 + POST请求时 + 总结 + 参考:@RequestParam + 注解@RequestParam接收的参数来自HTTP请求体或请求URL的QueryString。@RequestParam可以接收简单类型属性,也支持复杂类型属性。

        目录
        • @RequestParam
        • @RequestBody
          • 后端解析json数据
        • POST请求时
          • 总结
            • 参考:

              @RequestParam

              注解@RequestParam接收的参数是来自HTTP请求体或请求url的QueryString中。

              RequestParam可以接受简单类型的属性,也可以接受对象类型。

              @RequestParam有三个配置参数:

              • required表示是否必须,默认为true,必须。
              • defaultValue可设置请求参数的默认值。
              • value为接收url的参数名(相当于key值)。

              @RequestParam用来处理 Content-Typeapplication/x-www-form-urlencoded 编码的内容,Content-Type默认为该属性。@RequestParam也可用于其它类型的请求,例如:POST、DELETE等请求

              所以在postman中,要选择body的类型为 x-www-form-urlencoded,这样在headers中就自动变为了 Content-Type : application/x-www-form-urlencoded 编码格式。如下图所示:

              但是这样不支持批量插入数据啊,如果改用 json 字符串来传值的话,类型设置为 application/json,点击发送的话,会报错,后台接收不到值,为 null

              但可以入参后再转换,参考如下:

              @PostMapping("/ali-receive") public void aliReceive(@RequestParam("message") String message) { ReceiveLog receiveLog = JSON.parseObject(message, ReceiveLog.class); }

              解决Spring/SpringBoot @RequestParam注解无法读取application/json格式数据:www.jb51.net/article/265478.htm

              @RequestParam 接受JSON的字符串:

              @RequestParam

              1.用来处理Content-Type: 为 application/x-www-form-urlencoded编码的内容。(Http协议中,如果不指定Content-Type,则默认传递的参数就是application/x-www-form-urlencoded类型)

              @RequestParam可以接受简单类型的属性,也可以接受对象类型。

              2.用来处理 multipart/form-data (表单上传的)

              如何使用@RequestParam 接受JSON的字符串

              - 前端代码

              const message = { "data": { "userInfo": "2804951212", "offerId": offerId, "action": "distribution", "categoryNav": categoryNav }, "gmtBorn": time, "msgId": time, "type": "PRODUCT_COLLECTION", "userInfo": "chrome" }; $.ajax({ contentType :'application/x-www-form-urlencoded', type:'post', url: baseUrl+'/ali-receive', data:"message="+JSON.stringify(message) });

              后端代码

                 @PostMapping("/ali-receive")     public void aliReceive(@RequestParam("message") String message) {                 ReceiveLog receiveLog = JSON.parseObject(message, ReceiveLog.class);     }

              @RequestBody

              一般用来处理 Content-Type: 为application/json

              不推荐使用@RequestParam接收application/json,这时候就需要使用到@RequestBody。

              @RequestBody

              注解@RequestBody接收的参数是来自requestBody中,即请求体。一般用于处理非 Content-Type: application/x-www-form-urlencoded编码格式的数据,比如:application/jsonapplication/xml等类型的数据。

              application/json类型的数据而言,使用注解@RequestBody可以将body里面所有的json数据传到后端,后端再进行解析。

              GET请求中,因为没有HttpEntity,所以@RequestBody并不适用。

              POST请求中,通过HttpEntity传递的参数,必须要在请求头中声明数据的类型Content-Type,SpringMVC通过使用

              HandlerAdapter 配置的HttpMessageConverters来解析HttpEntity中的数据,然后绑定到相应的bean上。

              向表中批量插入数据

              举个批量插入数据的例子,Controller层的写法如下图所示:

              由于@RequestBody可用来处理 Content-Typeapplication/json 编码的内容,所以在postman中,选择body的类型为row -> JSON(application/json),这样在 Headers 中也会自动变为 Content-Type : application/json 编码格式。body内的数据如下图所示:

              批量向表中插入两条数据,这里的 saveBatchNovel()方法已经封装了 JPAsaveAll() 方法。body 里面的 json 语句的 key 值要与后端实体类的属性一一对应。

              注意:前端使用$.ajax的话,一定要指定 contentType: "application/json;charset=utf-8;",默认为 application/x-www-form-urlencoded

              后端解析json数据

              上述示例是传递到实体类中的具体写法,那么如果传递到非实体类中,body里面的json数据需要怎么解析呢?我们再来看下面这个例子:

              在body中,我们还是输入上面的json数据,根据分析,上面的json数据是一个List数组内嵌套着map对象,那么在后台的接收形式可写为 List<Map<String, String>>,具体代码如下图所示:

              postman请求:

              控制台输出:

              得出结论,通过@RequestBody可以解析Body中json格式的数据。

              POST请求时

              @RequestBody --> JSON字符串部分

              @RequestParam --> 请求参数部分

              application/json格局图

              form-data、x-www-form-urlencoded格局图

              1、从content-type方面总结:

              ① form-data、x-www-form-urlencoded:不可以用@RequestBody;可以用@RequestParam。见postman的格局,这两种方式的时候没有json字符串部分。

              ② application/json:json字符串部分可以用@RequestBody;url中的?后面参数可以用@RequestParam。见postman的格局

              2、从两种注解方式总结:

              @RequestBody

              (@RequestBody Map map) (@RequestBody Object object) application/json时候可用 form-data、x-www-form-urlencoded时候不可用

              @RequestParam

              (@RequestParam Map map) application/json时候,json字符串部分不可用,url中的?后面添加参数即可用,form-data、x-www-form-urlencoded时候可用,但是要将Headers里的Content-Type删掉

              (@RequestParam String waterEleId,@RequestParam String enterpriseName) application/json时候,json字符串部分不可用,url中的?后面添加参数即可用 form-data、x-www-form-urlencoded时候可用,且参数可以没有顺序(即前端传过来的参数或者url中的参数顺序不必和后台接口中的参数顺序一致,只要字段名相同就可以),但是要将Headers里的Content-Type删掉

              (@RequestParam Object object) 不管application/json、form-data、x-www-form-urlencoded都不可用

              既不是@RequestBody也不是@RequestParam,没有指定参数哪种接收方式

              (Map map) (Object object) application/json时候:json字符串部分不可用,url中的?后面添加参数不可用。 因为没有指定,它也不知道到底是用json字符串部分还是?后面添加参数部分,所以干脆都不可以用 form-data、x-www-form-urlencoded时都不可用,见图二 (HttpServletRequest request) application/json不可用 form-data、x-www-form-urlencoded时可用

              GET请求

              @RequestBody

              RequestBody -- Map / Object GET请求中不可以使用@RequestBody

              @RequestParam

              (@RequestParam Map map) 在url中的?后面添加参数即可使用

              (@RequestParam String waterEleId,@RequestParam String enterpriseName) 在url中的?后面添加参数即可使用

              (@RequestParam Object object) GET请求中不可以使用

              当使用GET请求时,通过postman添加?后面的参数,不用在url中自己一个一个拼,点击Params,在下面key-value中输入就自动拼接到url中

              举栗子

              上传文件,包含了图中圈出来的两部分

              如果这样,没有@RequestParam,那么url?后的参数就拿不到

              @RequestMapping(value = "/leadingIn", method = RequestMethod.POST) public ResponseObj<Boolean> leadingIn(Map formData, HttpServletRequest request, Map<String, InputStream> files) { }

              如果control中这样接收,本来想formData只接收url?后的参数,结果将{ "retCode": null, "data": true }这部分内容也拿到了,真实意外之喜。字符串这部分内容还可以从request中取到,见下面完整方法。

              @RequestMapping(value = "/leadingIn", method = RequestMethod.POST) public ResponseObj<Boolean> leadingIn(@RequestParam Map formData, HttpServletRequest request, Map<String, InputStream> files) { }

              完整方法

              /** * 导入 */ @RequestMapping(value = "/leadingIn", method = RequestMethod.POST) public ResponseObj<Boolean> leadingIn(@RequestParam Map formData, HttpServletRequest request, Map<String, InputStream> files) { //测试 try { MultipartHttpServletRequest mulRequest = (MultipartHttpServletRequest) request; Set<Map.Entry<String, MultipartFile>> set = mulRequest.getFileMap().entrySet(); Map<String, InputStream> listFile = new LinkedHashMap<>(); System.out.println("个数" + set.size()); for (Map.Entry<String, MultipartFile> each : set) { String fileName = each.getKey(); MultipartFile file = each.getValue(); //这里需要上传FTP try { listFile.put(fileName, file.getInputStream()); } catch (Exception ex) { return new ResponseObj<>(false, null); } } String formjson = mulRequest.getParameter("content"); ObjectMapper mapper = new ObjectMapper(); mapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY); mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); // boolean result = iInstallWorkOrder.upLoadFile(listFile); boolean result = true; return new ResponseObj<>(result, null); } catch (Exception ex) { System.out.println(ex.toString()); return new ResponseObj<>(false, null); } }

              按F12看一下Network里对应请求:

              使用@RequestParam:Content-Type为application/x-www-form-urlencoded,参数在FormData中

              使用@RequestBody:Content-Type为application/json,参数在Request PayLoad中

              总结

              •在GET请求中,不能使用@RequestBody。

              •在POST请求,可以使用@RequestBody和@RequestParam,但是如果使用@RequestBody,对于参数转化的配置必须统一。

              可以使用多个@RequestParam获取数据,@RequestBody不可以 举个例子,在SpringMVC配置了HttpMessageConverters处理栈中,指定json转化的格式,如Date转成‘yyyy-MM-dd’,则参数接收对象包含的字段如果是Date类型,就只能让客户端传递年月日的格式,不能传时分秒。因为不同的接口,它的参数可能对时间参数有不同的格式要求,所以这样做会让客户端调用同事对参数的格式有点困惑,所以说扩展性不高。 如果使用@RequestParam来接受参数,可以在接受参数的model中设置@DateFormat指定所需要接受时间参数的格式。 另外,使用@RequestBody接受的参数是不会被Servlet转化统一放在request对象的Param参数集中,@RequestParam是可以的。

              另外,还有一种应用场景,接口规范为resultful风格时,举个例子:如果要获取某个id下此条问题答案的查询次数的话,则后台就需要动态获取参数,其注解为@PathVariable,并且requestMapping中的value应为value="/{id}/queryNum",截图如下:

              到此这篇关于Java中POST、GET、@RequestBody和@RequestParam区别详析的文章就介绍到这了,更多相关POST GET @RequestBody和@RequestParam区别内容请搜索自由互联以前的文章或继续浏览下面的相关文章希望大家以后多多支持自由互联!

              参考:

              @RequestParam @RequestBody @PathVariable 等参数绑定注解详解

              blog.csdn.net/walkerjong/article/details/7946109

              Java中如何区分POST、GET请求与@RequestBody、@RequestParam使用差异?

              my.oschina.net/u/3372000/blog/906217

              www.jianshu.com/p/4981911d5e15

              cloud.tencent.com/developer/article/1414464