解决 Spring RestTemplate post传递参数时报错问题

2023-08-01 23:20:06 77

今天跟同事接口联调，使用RestTemplate请求服务端的post接口(使用python开发)。诡异的是，post请求，返回500InternalServerError，而使用get请求，返回正常。代码如下：

HashMaphashMap=Maps.newHashMap();
hashMap.put("data",JSONObject.toJSONString(params));
url="http://mydomain/dataDownLoad.cgi?data={data}";
json=restTemplate.getForObject(url,String.class,hashMap);
System.out.println("getjson:"+json);
url="http://mydomain/dataDownLoad.cgi";
json=restTemplate.postForObject(url,hashMap,String.class);
System.out.println("hasmappostjson:"+json);

结果为：

getjson:{'status':0,'statusInfo':{'global':'OK'},'data':'http://mydomain/dataDownLoad.cgi?downLoadData=358300d5f9e1cc512efc178caaa0b061'}

500InternalServerError

最后经过另一位同学帮忙排查，发现RestTemplate在postForObject时，不可使用HashMap。而应该是MultiValueMap。改为如下：

MultiValueMapparamMap=newLinkedMultiValueMap<>();
paramMap.add("data",JSONObject.toJSONString(params));
url="http://mydomain/dataDownLoad.cgi";
json=restTemplate.postForObject(url,paramMap,String.class);
System.out.println("postjson:"+json);

结果为：

postjson:{'status':0,'statusInfo':{'global':'OK'},'data':'http://mydomain/dataDownLoad.cgi?downLoadData=f2fc328513886e51b3b67d35043985ae'}

然后我想起之前使用RestTemplate发起post请求时，使用POJO作为参数，是可行的。再次测试：

url="http://mydomain/dataDownLoad.cgi";
PostDatapostData=newPostData();
postData.setData(JSONObject.toJSONString(params));
json=restTemplate.postForObject(url,paramMap,String.class);
System.out.println("postDatajson:"+json);

返回：500InternalServerError。

到现在为止接口调通了。但问题的探究才刚刚开始。

RestTemplate的post参数为什么使用MultiValueMap而不能使用HashMap？

为什么post接口，get请求也可以正确返回？

为什么java服务端可以接收POJO参数，python服务端不可以？python服务端使用CGI（CommonGatewayInterface），与cgi有关系吗？

何为MultiValueMap

IDEA中command+N，搜索类MultiValueMap，发现apache的commons-collections包有一个MultiValueMap类，spring-core包中有一个接口MultiValueMap，及其实现类LinkedMultiValueMap。显然看spring包。

首先看LinkedMultiValueMap，实现MultiValueMap接口，只有一个域：Map>targetMap=newLinkedHashMap>()。其中value为newLinkedList()。再看接口方法：

publicinterfaceMultiValueMapextendsMap>{
VgetFirst(Kkey);//targetMap.get(key).get(0)
voidadd(Kkey,Vvalue);//targetMap.get(key).add(value)
voidset(Kkey,Vvalue);//targetMap.set(key,Lists.newLinkedList(value))
voidsetAll(Mapvalues);//将普通map转为LinkedMultiValueMap
MaptoSingleValueMap();//只保留所有LinkedList的第一个值，转为LinkedHashMap
}

综上，LinkedMultiValueMap实际就是Key-LinkedList的map。

RestTemplate怎么处理post参数

首先查看RestTemplate源码，首先将请求封装成HttpEntityRequestCallback类对象，然后再处理请求。

Override
publicTpostForObject(Stringurl,Objectrequest,ClassresponseType,Object...uriVariables)
throwsRestClientException{
//请求包装成httpEntityCallback
RequestCallbackrequestCallback=httpEntityCallback(request,responseType);
HttpMessageConverterExtractorresponseExtractor=
newHttpMessageConverterExtractor(responseType,getMessageConverters(),logger);
//处理请求
returnexecute(url,HttpMethod.POST,requestCallback,responseExtractor,uriVariables);
}

那么HttpEntityRequestCallback是什么样的呢？如下，实际是把请求数据放在了一个HttpEntity中。如果requestBody是HttpEntity类型，就直接转；否则，放在HttpEntity的body中。

//请求内容封装在一个HttpEntity对象中。
privateHttpEntityRequestCallback(ObjectrequestBody,TyperesponseType){
super(responseType);
if(requestBodyinstanceofHttpEntity){
this.requestEntity=(HttpEntity)requestBody;
}
elseif(requestBody!=null){
this.requestEntity=newHttpEntity

解决 Spring RestTemplate post传递参数时报错问题

RestTemplate的post参数为什么使用MultiValueMap而不能使用HashMap？

热门推荐

随机推荐