SpringBoot项目使用RestTemplate发送请求踩坑记录

开发背景

系统要对接飞鹅云打印机进行打印，需要通过指定接口打印数据
因为使用SpringBoot开发，刚好用RestTemplate+postForObject发送POST请求并接受结果。

设置请求头(Content-Type)

接口要求请求头中要带Content-Type: application/x-www-form-urlencoded

思路:
先创建个实现ClientHttpRequestInterceptor接口的类，在intercept(…)方法中对请求头设置，在使用RestTemplate的时候设置或添加这个Interceptor类，然后再发送请求

MyPostInterceptor类：

@Component
public class MyPostInterceptor implements ClientHttpRequestInterceptor {
    private Logger logger = LoggerFactory.getLogger(this.getClass());

    //设置默认请求头为application/x-www-form-urlencoded
    private MediaType mediaType = MediaType.APPLICATION_FORM_URLENCODED;

    /**
     *参考链接https://www.cnblogs.com/yihuihui/p/13211699.html
     */
    @Override
    public ClientHttpResponse intercept(HttpRequest request, byte[] body, ClientHttpRequestExecution execution) throws IOException {
        //设置请求头
        request.getHeaders().setContentType(mediaType);

        //另一种设置方法
//        request.getHeaders().add("Content-Type",MediaType.APPLICATION_FORM_URLENCODED_VALUE);

        logger.info("===request: {}, {}, {}", request.getURI().getHost(), request.getURI().getPath(),request.getHeaders());
        logger.info("===requestBody: {}", new String(body,UTF_8));
        return execution.execute(request, body);
    }

    //Get/Set忽略
}

发送请求：

	//myPostInterceptor自动注入省略...
	
	//构建数据实体类feiEPrintBody...

	RestTemplate restTemplate = new RestTemplate();
	//设置请求类型,NORMAL_HEADER=MediaType.APPLICATION_FORM_URLENCODED
	myPostInterceptor.setMediaType(NORMAL_HEADER);
    restTemplate.setInterceptors(Collections.singletonList(myPostInterceptor));
    //另一种设置方法
//  restTemplate.getInterceptors().add(myPostInterceptor);

	//增加返回消息转换类，详见下方踩坑1
    restTemplate.getMessageConverters().add(new PostMappingJackson2HttpMessageConverter());
    //提交数据并获取结果，这里也有坑，详见踩坑2
    //OPEN_API为接口网址
    JSONObject result = restTemplate.postForObject(OPEN_API,feiEPrintBody.builderMultiValueMap(),JSONObject.class);

踩坑1

RestTemplate的默认处理响应类型为application/json，但接口返回数据格式为text/html，RestTemplate无法转换信息报错：UnknownContentTypeException

org.springframework.web.client.UnknownContentTypeException: Could not extract response: no suitable HttpMessageConverter found for response type [class com.alibaba.fastjson.JSONObject] and content type [text/html;charset=UTF-8]
	at org.springframework.web.client.HttpMessageConverterExtractor.extractData(HttpMessageConverterExtractor.java:126)
	...

解决：给RestTemplate增加一个处理指定响应数据类型的HttpMessageConverter
这里知道接口返回的是json格式，所以这里继承spring中默认的MappingJackson2HttpMessageConverter

/**
 * POST返回信息 TEXT_HTML转换类
 * 参考https://blog.csdn.net/kinginblue/article/details/52706155
 */
public class PostMappingJackson2HttpMessageConverter extends MappingJackson2HttpMessageConverter {
    public PostMappingJackson2HttpMessageConverter(){
        List<MediaType> mediaTypes;
        mediaTypes = new ArrayList<>();
        //设置消息转换类的响应类型
        mediaTypes.add(MediaType.TEXT_HTML);
        setSupportedMediaTypes(mediaTypes);
    }
}

踩坑2

设置请求头后，一开始使用以下方式发送数据，接口报错，一开始以为是请求头设置没有生效找了半天

//feiEPrintBody为pojo
JSONObject result = restTemplate.postForObject(OPEN_API,feiEPrintBody,JSONObject.class);

后面经群友提示，application/x-www-form-urlencoded不能传json格式的body，排查后发现，直接传对象会被RestTemplate转为json格式，修改后才解决

解决：改用LinkedMultiValueMap存字段
Tip：必须要使用LinkedMultiValueMap，用MultiValueMap仍有转为Json的问题
这里直接在存数据类里加个新建方法，然后在发送方法里调用

 //FeiEPrintBody构建传值map
    public MultiValueMap builderMultiValueMap() {
        LinkedMultiValueMap<String, Object> postParameters = new LinkedMultiValueMap<>();
        postParameters.add("user", getUser());
        postParameters.add("stime", getStime());
        postParameters.add("sig", getSig());
        postParameters.add("apiname", getApiName());
        postParameters.add("sn", sn);
        postParameters.add("content", content);
        if (times > 0) {
            postParameters.add("times", String.valueOf(times));
        }
        if (img != null) {
            postParameters.add("img", img);
        }
        return postParameters;
    }

//OPEN_API为接口网址
JSONObject result = restTemplate.postForObject(OPEN_API,feiEPrintBody.builderMultiValueMap(),JSONObject.class);

设置后提交的Body变化了，接口调用成功

解决后吐槽：快乐撸码五分钟，苦逼Debug两小时