Package software.amazon.awssdk.core

Class ResponseBytes<ResponseT>

java.lang.Object

software.amazon.awssdk.core.BytesWrapper

software.amazon.awssdk.core.ResponseBytes<ResponseT>

public final class ResponseBytes<ResponseT>
extends BytesWrapper

An in-memory representation of the service's response from a streaming operation. This usually obtained by calling the "bytes" form of a streaming operation, like S3's getObjectBytes. Can also be retrieved by passing ResponseTransformer.toBytes() or AsyncResponseTransformer.toBytes() to a streaming output operation.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
static <ResponseT> ResponseBytes<ResponseT>	fromByteArray(ResponseT response, byte[] bytes)	Create ResponseBytes from a Byte array.
static <ResponseT> ResponseBytes<ResponseT>	fromByteArrayUnsafe(ResponseT response, byte[] bytes)	Create ResponseBytes from a Byte array without copying the contents of the byte array.
static <ResponseT> ResponseBytes<ResponseT>	fromInputStream(ResponseT response, InputStream stream)	Create ResponseBytes from a Byte array.
int	hashCode()
ResponseT	response()
String	toString()

Methods inherited from class software.amazon.awssdk.core.BytesWrapper

asByteArray, asByteArrayUnsafe, asByteBuffer, asContentStreamProvider, asInputStream, asString, asUtf8String

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

fromInputStream

public static <ResponseT> ResponseBytes<ResponseT> fromInputStream(ResponseT response,
                                                                   InputStream stream)
                                                            throws UncheckedIOException

Create ResponseBytes from a Byte array. This will copy the contents of the byte array.

Throws:

UncheckedIOException

fromByteArray

public static <ResponseT> ResponseBytes<ResponseT> fromByteArray(ResponseT response,
                                                                 byte[] bytes)

Create ResponseBytes from a Byte array. This will copy the contents of the byte array.

fromByteArrayUnsafe

public static <ResponseT> ResponseBytes<ResponseT> fromByteArrayUnsafe(ResponseT response,
                                                                       byte[] bytes)

Create ResponseBytes from a Byte array without copying the contents of the byte array. This introduces concurrency risks, allowing: (1) the caller to modify the byte array stored in this SdkBytes implementation AND (2) any users of BytesWrapper.asByteArrayUnsafe() to modify the byte array passed into this SdkBytes implementation.

As the method name implies, this is unsafe. Use fromByteArray(Object, byte[]) unless you're sure you know the risks.

response

public ResponseT response()

Returns:

the unmarshalled response object from the service.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class BytesWrapper

hashCode

public int hashCode()

Overrides:

hashCode in class BytesWrapper