Package software.amazon.awssdk.core.internal.async

Class ByteBuffersAsyncRequestBody

java.lang.Object

software.amazon.awssdk.core.internal.async.ByteBuffersAsyncRequestBody

All Implemented Interfaces:

AutoCloseable, org.reactivestreams.Publisher<ByteBuffer>, AsyncRequestBody, SdkPublisher<ByteBuffer>, SdkAutoCloseable

@SdkInternalApi
public final class ByteBuffersAsyncRequestBody
extends Object
implements AsyncRequestBody, SdkAutoCloseable

An implementation of AsyncRequestBody for providing data from the supplied ByteBuffer array. This is created using static methods on AsyncRequestBody

Subscription Behavior:

• Each subscriber receives a read-only view of the buffered data
• Subscribers receive data independently based on their own demand signaling
• If the body is closed, new subscribers will receive an error immediately

Resource Management:

The body should be closed when no longer needed to free buffered data and notify active subscribers. Closing the body will:

• Clear all buffered data
• Send error notifications to all active subscribers
• Prevent new subscriptions

See Also:

AsyncRequestBody.fromBytes(byte[]), AsyncRequestBody.fromBytesUnsafe(byte[]), AsyncRequestBody.fromByteBuffer(ByteBuffer), AsyncRequestBody.fromByteBufferUnsafe(ByteBuffer), AsyncRequestBody.fromByteBuffers(ByteBuffer...), AsyncRequestBody.fromByteBuffersUnsafe(ByteBuffer...), AsyncRequestBody.fromString(String)

Nested Class Summary

Nested classes/interfaces inherited from interface software.amazon.awssdk.core.async.AsyncRequestBody

AsyncRequestBody.BodyType

Method Summary

Modifier and Type	Method	Description
String	body()	Each AsyncRequestBody should return a well-formed name that can be used to identify the implementation.
List<ByteBuffer>	bufferedData()
void	close()
Optional<Long>	contentLength()
String	contentType()
static ByteBuffersAsyncRequestBody	from(byte[] bytes)
static ByteBuffersAsyncRequestBody	from(String mimetype, byte[] bytes)
static ByteBuffersAsyncRequestBody	of(Long length, ByteBuffer... buffers)
static ByteBuffersAsyncRequestBody	of(String mimetype, Long length, ByteBuffer... buffers)
static ByteBuffersAsyncRequestBody	of(String mimetype, ByteBuffer... buffers)
static ByteBuffersAsyncRequestBody	of(ByteBuffer... buffers)
static ByteBuffersAsyncRequestBody	of(List<ByteBuffer> buffers)
static ByteBuffersAsyncRequestBody	of(List<ByteBuffer> buffers, long length)
void	subscribe(org.reactivestreams.Subscriber<? super ByteBuffer> subscriber)

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awssdk.core.async.AsyncRequestBody

split, split, splitCloseable, splitCloseable

Methods inherited from interface software.amazon.awssdk.core.async.SdkPublisher

addTrailingData, buffer, doAfterOnCancel, doAfterOnComplete, doAfterOnError, filter, filter, flatMapIterable, limit, map, subscribe

Method Detail

contentLength

public Optional<Long> contentLength()

Specified by:

contentLength in interface AsyncRequestBody

Returns:

The content length of the data being produced.

contentType

public String contentType()

Specified by:

contentType in interface AsyncRequestBody

Returns:

The content type of the data being produced.

subscribe

public void subscribe(org.reactivestreams.Subscriber<? super ByteBuffer> subscriber)

Specified by:

subscribe in interface org.reactivestreams.Publisher<ByteBuffer>

body

public String body()

Description copied from interface: AsyncRequestBody

Each AsyncRequestBody should return a well-formed name that can be used to identify the implementation. The body name should only include alphanumeric characters.

Specified by:

body in interface AsyncRequestBody

Returns:

String containing the identifying name of this AsyncRequestBody implementation.

of

public static ByteBuffersAsyncRequestBody of(List<ByteBuffer> buffers,
                                             long length)

of

public static ByteBuffersAsyncRequestBody of(List<ByteBuffer> buffers)

of

public static ByteBuffersAsyncRequestBody of(ByteBuffer... buffers)

of

public static ByteBuffersAsyncRequestBody of(Long length,
                                             ByteBuffer... buffers)

of

public static ByteBuffersAsyncRequestBody of(String mimetype,
                                             ByteBuffer... buffers)

of

public static ByteBuffersAsyncRequestBody of(String mimetype,
                                             Long length,
                                             ByteBuffer... buffers)

from

public static ByteBuffersAsyncRequestBody from(byte[] bytes)

from

public static ByteBuffersAsyncRequestBody from(String mimetype,
                                               byte[] bytes)

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface SdkAutoCloseable

bufferedData

@SdkTestInternalApi
public List<ByteBuffer> bufferedData()