RestTemplate响应中如何获取输入流InputStream

 更新时间:2023年01月11日 10:45:14   作者:SmilingRon  
这篇文章主要介绍了RestTemplate响应中如何获取输入流InputStream问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教

RestTemplate调用接口如何获取输入流

由于项目需求,需要获取RestTemplate请求响应的输入流。如下:

首先需要获取一个RestTemplate实例:

RestTemplate rest = new RestTemplate();

一般的使用方式如下:

String message = rest.getForObject(url, String.class);
// or
String message = rest.postForObject(url, paramObject, String.class);

若要获取InputStream,需要使用到spring提供Resource接口和ResponseEntity类,方式如下:

ResponseEntity<Resource> entity = rest.postForEntity(url, paramObject, Resource.class);
InputStream in = entity.getBody().getInputStream();

当然,我们也可以先使用entity对响应做出判断,比如检查响应状态:

if (entity.getStatusCode().equals(HttpStatus.OK)) {
    // ...
}

SpringRestTemplate解析

RESTful

简单来说,RESTful是基于Http协议,面向资源和语义的设计风格。它可以看做是Http协议的一种严格实现,基于Http资源(URI)和语义(Get/Post/Put/Delete等)

作为对比,PRC则是面向过程(资源+语义),而对协议没有固定要求的设计风格。它的目的是将远程方法当做本地方法一样调用,相比于RESTful的面向资源和语义,它将两者结合起来,作为我们平时开发过程中的方法。

​ 比如一个订单查询系统,用RESTful风格的写法是这样的

// 这里查询用的是Http语义GET,对应的新增为POST,删除为DELETE,修改为PUT
GET
/order/123

用PRC风格的写法是这样的

/order/queryOrder/123

RPC对比

总结来看,RESTful和PRC有以下不同。

​ 1、RESTful基于Http协议,而RPC对协议没有固定要求,一般会采用效率较高的协议。

​ 2、RESTful面向资源和语义,而RPC面向过程。即RESTful提供的资源表达十分明确,提供了多种语义作为资源的操作方法,例如上面的订单查询。RPC则会为同一个资源提供多个操作方法,对外并没有十分明确的资源概念。

RestTemplate

RestTemplate整体UML.jpg

HttpMessageConverter及序列化

​序列化就是将对象转化为可以传输的二进制,反序列化就是将二进制转化为程序内部的对象。序列化/反序列化主要体现在程序I/O这个过程中,包括网络I/O和磁盘I/O。在网络中Http报文是以二进制字符串的形式传递的,这种是反序列化前的存在形式,我们要在Java中处理,则还需要进行反序列化操作。

我们可以通过HttpServletRequest的getInputStream()方法获取请求报文的原始内容,HttpServletResponse的getOutputStream()方法写入响应报文,这些方式都是通过流的形式来处理数据,如果要转化为对象,还需要我们进一步处理。在面向对象的模式中,每次都需要读取流中的原始数据并转化为对象,这样显然是很麻烦的,如果能将请求和响应都自动封装为我们想要的对象,那不是很好嘛。HttpMessageConverter提供的就是这样的功能,将原始的请求报文和响应报文封装为对象。

public interface HttpMessageConverter<T> {
	boolean canRead(Class<?> clazz, @Nullable MediaType mediaType);
	boolean canWrite(Class<?> clazz, @Nullable MediaType mediaType);
	List<MediaType> getSupportedMediaTypes();
	T read(Class<? extends T> clazz, HttpInputMessage inputMessage)
			throws IOException, HttpMessageNotReadableException;
	void write(T t, @Nullable MediaType contentType, HttpOutputMessage outputMessage)
			throws IOException, HttpMessageNotWritableException;
}

​HttpMessageConverter中出现了成对的read和write方法。每种Converter负责处理其各自支持的MimeType,can**()方法通过判断当前Converter和需要处理的MimeType是否一致,如果一致则能处理,否则不能处理。如果能处理,则再通过read/write()方法进行操作,其本质上也是通过输入输出流处理数据,我们来看下StringHttpMessageConverter是如何将请求报文转化为String对象的:

// 判断当前Converter是否支持此类型的转换,只有是String时才会支持
@Override
public boolean supports(Class<?> clazz) {
	return String.class == clazz;
}

// 从HttpInputMessage读取输入流,并转化为String对象
@Override
protected String readInternal(Class<? extends String> clazz, HttpInputMessage inputMessage) throws IOException {
	Charset charset = getContentTypeCharset(inputMessage.getHeaders().getContentType());
	return StreamUtils.copyToString(inputMessage.getBody(), charset);
}

// 从InputStream中读取原始的报文数据
public static String copyToString(@Nullable InputStream in, Charset charset) throws IOException {
    if (in == null) {
        return "";
    } else {
        StringBuilder out = new StringBuilder();
        InputStreamReader reader = new InputStreamReader(in, charset);
        char[] buffer = new char[4096];

        int charsRead;
        while((charsRead = reader.read(buffer)) != -1) {
            out.append(buffer, 0, charsRead);
        }

        return out.toString();
    }
}

组件替换

从上面的UML可以看出,RestTemplate中定义了一组Http语义的模板方法,并通过HttpAccessor创建了HttpRequest对象再执行请求。也就是说,RestTemplate中并没有创建请求,请求是委托给HttpAccessor创建的,HttpAccessor可以切换请求工厂,这样就给我们提供了切换请求,即Http组件的操作。

通过HttpAccessor的ClientHttpRequestFactory属性来切换不同的HTTP组件:HttpAccessor默认使用SimpleClientHttpRequestFactory来创建一个ClientHttpRequest,如果通过HttpAccessor提供的setRequestFactory()方法替换掉其默认的工厂,就可以实现HTTP组件切换。RestTemplate提供了以ClientHttpRequestFactory为参数的构造方法,其内部调用了setRequestFactory()。

通过看ClientHttpRequestFactory的实现类,可以发现常见的Http组件有HttpComponents、OkHttp、Netty4Client等,在这里不做深入探究。

​总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • 一文搞懂Java中的注解和反射

    一文搞懂Java中的注解和反射

    这篇文章主要给大家介绍了关于Java中注解和反射的原理及使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-06-06
  • java 异常之手动抛出与自动抛出的实例讲解

    java 异常之手动抛出与自动抛出的实例讲解

    这篇文章主要介绍了java 异常之手动抛出与自动抛出的实例讲解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-02-02
  • Java生成压缩文件的实例代码

    Java生成压缩文件的实例代码

    在工作过程中,需要将一个文件夹生成压缩文件,然后提供给用户下载。下面通过实例代码给大家介绍Java生成压缩文件的方法,感兴趣的朋友一起看看吧
    2018-06-06
  • Java流操作之数据流实例代码

    Java流操作之数据流实例代码

    这篇文章主要介绍了Java流操作之数据流实例代码,具有一定借鉴价值,需要的朋友可以参考下
    2018-01-01
  • 浅谈java中为什么实体类需要实现序列化

    浅谈java中为什么实体类需要实现序列化

    下面小编就为大家带来一篇浅谈java中为什么实体类需要实现序列化。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-05-05
  • java反射_改变private中的变量及方法的简单实例

    java反射_改变private中的变量及方法的简单实例

    下面小编就为大家带来一篇java反射_改变private中的变量及方法的简单实例。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-06-06
  • Java Thread多线程开发中Object类详细讲解

    Java Thread多线程开发中Object类详细讲解

    这篇文章主要介绍了Java Thread多线程开发中Object类,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习吧
    2023-03-03
  • JAVA内存溢出解决方案图解

    JAVA内存溢出解决方案图解

    这篇文章主要介绍了JAVA内存溢出解决方案图解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-10-10
  • SpringBoot接口中如何直接返回图片数据

    SpringBoot接口中如何直接返回图片数据

    这篇文章主要介绍了SpringBoot接口中如何直接返回图片数据,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-03-03
  • 一篇文章带你复习java知识点

    一篇文章带你复习java知识点

    以下简单介绍了下我对于这些java基本知识点和技术点的一些看法和心得,这些内容都源自于我这些年来使用java的一些总结,希望能够给你带来帮助
    2021-06-06

最新评论