org.aoju.bus.http.bodys

Class ResponseBody

java.lang.Object

org.aoju.bus.http.bodys.ResponseBody

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

FileInterceptor.DownloadFileProgressResponseBody, RealResponseBody

public abstract class ResponseBody
extends Object
implements Closeable

从源服务器到客户机应用程序的一次性流，包含响应主体的原始字节。 到web服务器的活动连接支持每个响应主体。 这对客户机应用程序施加了义务和限制，每个响应主体由一个有限的资源(如socket(实时网络响应)或一个打开的 文件(用于缓存的响应)来支持。如果不关闭响应体，将会泄漏资源并减慢或崩溃 这个类和Response都实现了Closeable。关闭一个响应就是关闭它的响应体。如果您 调用NewCall.execute()或实现Callback.onResponse(org.aoju.bus.http.NewCall, org.aoju.bus.http.Response)，则必须通过 调用以下任何方法来关闭此主体:

• Response.close()
• Response.body().close()
• Response.body().source().close()
• Response.body().charStream().close()
• Response.body().byteStream().close()
• Response.body().bytes()
• Response.body().string()

这个类可以用来传输非常大的响应。例如，可以使用这个类来读取大于分配给当前进程的整个内存的响应。 它甚至可以传输大于当前设备总存储的响应，这是视频流应用程序的一个常见需求 因为这个类不会在内存中缓冲完整的响应，所以应用程序可能不会重新读取响应的字节。使用bytes() 或string()将整个响应读入内存。或者使用source()、byteStream() 或charStream()来处理响应

Since:

JDK 1.8+

Version:

5.5.0

Author:

Kimi Liu

Constructor Summary

Constructors

Constructor and Description
ResponseBody()

Method Summary

Modifier and Type	Method and Description
byte[]	bytes()
InputStream	byteStream()
Reader	charStream()
void	close()
abstract long	contentLength()
abstract MediaType	contentType()
static ResponseBody	create(MediaType contentType, byte[] content) 新的响应体，它传输content
static ResponseBody	create(MediaType contentType, ByteString content) 新的响应体，它传输content
static ResponseBody	create(MediaType contentType, long contentLength, BufferSource content) 新的响应体，它传输content
static ResponseBody	create(MediaType contentType, String content) 返回一个传输content的新响应体。如果contentType是非空且缺少字符集，则使用UTF-8
abstract BufferSource	source()
String	string()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ResponseBody

public ResponseBody()

Method Detail

create

public static ResponseBody create(MediaType contentType,
                                  String content)

返回一个传输content的新响应体。如果contentType是非空且缺少字符集，则使用UTF-8

Parameters:

contentType - 媒体类型

content - 内容

Returns:

新响应体

create

public static ResponseBody create(MediaType contentType,
                                  byte[] content)

新的响应体，它传输content

Parameters:

contentType - 媒体类型

content - 内容

Returns:

新响应体

create

public static ResponseBody create(MediaType contentType,
                                  ByteString content)

新的响应体，它传输content

Parameters:

contentType - 媒体类型

content - 内容

Returns:

新响应体

create

public static ResponseBody create(MediaType contentType,
                                  long contentLength,
                                  BufferSource content)

新的响应体，它传输content

Parameters:

contentType - 媒体类型

contentLength - 内容大小

content - 内容

Returns:

新响应体

contentType

public abstract MediaType contentType()

contentLength

public abstract long contentLength()

byteStream

public final InputStream byteStream()

source

public abstract BufferSource source()

bytes

public final byte[] bytes()
                   throws IOException

Throws:

IOException

charStream

public final Reader charStream()

string

public final String string()
                    throws IOException

Throws:

IOException

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable