public abstract class ResumableUploadCallable<RequestT,ResponseT>A ResumableUploadCallable is an API-transport-independent wrapper for the Resumable Upload protocol. Operates directly on the request object and input stream payload.
Type Parameters |
|
|---|---|
| Name | Description |
RequestT |
|
ResponseT |
|
Constructors
ResumableUploadCallable()
protected ResumableUploadCallable()Methods
futureCall(RequestT request, InputStreamSupplier payloadSupplier, @Nullable ApiCallContext context, @Nullable ResumableUploadOptions options)
public abstract ResumableUploadFuture<ResponseT> futureCall(RequestT request, InputStreamSupplier payloadSupplier, @Nullable ApiCallContext context, @Nullable ResumableUploadOptions options)Performs a new resumable upload asynchronously with call context and options overrides.
Streams from the provided payloadSupplier are consumed asynchronously by the
returned ResumableUploadFuture and will be closed automatically upon completion,
failure, or cancellation.
| Parameters | |
|---|---|
| Name | Description |
request |
RequestTthe request message |
payloadSupplier |
InputStreamSuppliersupplier of the data payload input stream to upload and close |
context |
@org.jspecify.annotations.Nullable com.google.api.gax.rpc.ApiCallContextcall context overrides; may be |
options |
@org.jspecify.annotations.Nullable com.google.api.gax.rpc.ResumableUploadOptionsrequest-level upload options overrides; may be |
| Returns | |
|---|---|
| Type | Description |
ResumableUploadFuture<ResponseT> |
future for tracking and controlling the upload |
futureCall(RequestT request, InputStreamSupplier payloadSupplier, @Nullable ResumableUploadOptions options)
public ResumableUploadFuture<ResponseT> futureCall(RequestT request, InputStreamSupplier payloadSupplier, @Nullable ResumableUploadOptions options)Performs a new resumable upload asynchronously with options overrides and default call context.
Streams from the provided payloadSupplier are consumed asynchronously by the
returned ResumableUploadFuture and will be closed automatically upon completion,
failure, or cancellation.
| Parameters | |
|---|---|
| Name | Description |
request |
RequestTthe request message |
payloadSupplier |
InputStreamSuppliersupplier of the data payload input stream to upload and close |
options |
@org.jspecify.annotations.Nullable com.google.api.gax.rpc.ResumableUploadOptionsrequest-level upload options overrides; may be |
| Returns | |
|---|---|
| Type | Description |
ResumableUploadFuture<ResponseT> |
future for tracking and controlling the upload |
resumeCall(String sessionUrl, InputStreamSupplier payloadSupplier, @Nullable ResumableUploadOptions options)
public abstract ResumableUploadFuture<ResponseT> resumeCall(String sessionUrl, InputStreamSupplier payloadSupplier, @Nullable ResumableUploadOptions options)Resumes an existing resumable upload session asynchronously using a saved session URL.
Resuming queries the server for the last committed byte offset and skips the stream forward
to that offset before resuming chunk transmission. payloadSupplier must supply a stream
positioned at byte 0 of the original payload.
Streams from the provided payloadSupplier are consumed asynchronously by the
returned ResumableUploadFuture and will be closed automatically upon completion,
failure, or cancellation.
| Parameters | |
|---|---|
| Name | Description |
sessionUrl |
Stringthe upload session URL |
payloadSupplier |
InputStreamSuppliersupplier of the data payload input stream to upload and close |
options |
@org.jspecify.annotations.Nullable com.google.api.gax.rpc.ResumableUploadOptionsupload options overrides; may be |
| Returns | |
|---|---|
| Type | Description |
ResumableUploadFuture<ResponseT> |
future for tracking and controlling the upload |