@(springboot)[Resttemplate|messageConverter|Collections.copy]
最近遇到一个小需求,需要http去请求第三方的接口, 于是便想到了用RestTemplate.
首先呢,我加入了spring-boot-starter-web的依赖:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
然后在service类中自动注入了RestTemplate,像这样:
@Autowired
private RestTemplate restTemplate;
你肯定以为万事大吉了,spring boot的自动注入会给我们的restTemplate实例化一个bean,实际上当你启动程序的时候,你会发现你too young,too simple.程序会爆出Field restTemplate in xx.xxxService required a bean of type 'org.springframework.web.client.RestTemplate' that could not be found.
什么,我明明注入了的啊,淡定,经过查找,在https://stackoverflow.com/questions/28024942/how-to-autowire-resttemplate-using-annotations找到了答案,原来在spring boot版本大于1.4的时候,spring boot不会再自动装配定义一个RestTemplate了,你只有自己利用RestTemplateBuilder
来创建RestTemplate.
Bean
public RestTemplate restTemplate(RestTemplateBuilder builder) {
return builder.build();
}
当然这很简单,加入然后继续让程序运行,又来了个惊喜
Could not extract response: no suitable HttpMessageConverter found for response type [class com.xxx.xx] and content type [text/html;charset=UTF-8]
居然没有合适的messageConverter
,这肯定不可能,再定睛一看,content type
怎么是text/html
,讲道理API数据接口返回的都是json
,不应该是text/html
.
询问了下API提供方,他们居然没在接口返回设置content type
,这就导致了明明返回的数据是json
数据格式,而content type
却是text/html
。当然接口提供方也不想改,说别人这么也用的了的,没法,咱继续自个折腾。
根据抛出的异常信息
at org.springframework.web.client.HttpMessageConverterExtractor.extractData(HttpMessageConverterExtractor.java:110)
at org.springframework.web.client.RestTemplate.doExecute(RestTemplate.java:655)
at org.springframework.web.client.RestTemplate.execute(RestTemplate.java:613)
at org.springframework.web.client.RestTemplate.getForObject(RestTemplate.java:287)
进入到HttpMessageConverterExtractor#extractData
方法中的源码查看,找到了重要的逻辑:
for (HttpMessageConverter<?> messageConverter : this.messageConverters) {
if (messageConverter instanceof GenericHttpMessageConverter) {
GenericHttpMessageConverter<?> genericMessageConverter =
(GenericHttpMessageConverter<?>) messageConverter;
if (genericMessageConverter.canRead(this.responseType, null, contentType)) {
if (logger.isDebugEnabled()) {
logger.debug("Reading [" + this.responseType + "] as \"" +
contentType + "\" using [" + messageConverter + "]");
}
return (T) genericMessageConverter.read(this.responseType, null, responseWrapper);
}
}
if (this.responseClass != null) {
if (messageConverter.canRead(this.responseClass, contentType)) {
if (logger.isDebugEnabled()) {
logger.debug("Reading [" + this.responseClass.getName() + "] as \"" +
contentType + "\" using [" + messageConverter + "]");
}
return (T) messageConverter.read((Class) this.responseClass, responseWrapper);
}
}
}
这部分代码就是进行请求响应转换的地方,而
if (messageConverter.canRead(this.responseClass, contentType))
这个就是根据响应返回的content type
判定该converter有没有能力转换处理响应的内容,由于我们是要处理json,所以我们进入AbstractJackson2HttpMessageConverter#canRead
方法,看到
protected boolean canRead(MediaType mediaType) {
if (mediaType == null) {
return true;
}
for (MediaType supportedMediaType : getSupportedMediaTypes()) {
if (supportedMediaType.includes(mediaType)) {
return true;
}
}
return false;
}
这个方法就是根据Converter支持的mediaType列表来判断是否支持该类型的contentType
解析,那看来我们只需要加入MediaType.TEXT_HTML
到AbstractJackson2HttpMessageConverter
支持的MediaType列表中即可。
那要怎么加呢?很明显,就在创建RestTemplate
的时候,如下:
@Bean
public RestTemplate restTemplate(RestTemplateBuilder builder) {
//先获取到converter列表
List<HttpMessageConverter<?>> converters = builder.build().getMessageConverters();
for(HttpMessageConverter<?> converter : converters){
//因为我们只想要jsonConverter支持对text/html的解析
if(converter instanceof MappingJackson2HttpMessageConverter){
try{
//先将原先支持的MediaType列表拷出
List<MediaType> mediaTypeList = new ArrayList<>(converter.getSupportedMediaTypes());
//加入对text/html的支持
mediaTypeList.add(MediaType.TEXT_HTML);
//将已经加入了text/html的MediaType支持列表设置为其支持的媒体类型列表
((MappingJackson2HttpMessageConverter) converter).setSupportedMediaTypes(mediaTypeList);
}catch(Exception e){
e.printStackTrace();
}
}
}
return builder.build();
}
经过这样的处理,RestTemplate
就能处理返回的数据明明是json
格式,而content-type
却给的是text/html
的奇葩响应数据了。
对了,还有一点,当你想要复制一个list的数据到另外一个list,不推荐用
ArrayList <Integer> dest= new ArrayList<Integer>(src.size());
Collections.copy(dest, src);
这样会抛出
Exception in thread "main" java.lang.IndexOutOfBoundsException: Source does not fit in dest
因为其new ArrayList<Integer>(src.size())
,初始化的是容量,容量并不等于元素的数量大小,而Collections.copy
中
int srcSize = src.size();
if (srcSize > dest.size())
throw new IndexOutOfBoundsException("Source does not fit in dest");
比较的是列表所含元素的个数,所以就会抛出异常了。正确的方法是直接new的时候传进去,像这样:
ArrayList <Integer> dest= new ArrayList<Integer>(src);
这样就好了,还省了一行代码,Perfect~.