public class StorageBatch
A batch of operations to be submitted to Google Cloud Storage using a single RPC request.
Example of using a batch request to delete, update and get a blob:
StorageBatch batch = storage.batch();
BlobId firstBlob = BlobId.of("bucket", "blob1"));
BlobId secondBlob = BlobId.of("bucket", "blob2"));
batch.delete(firstBlob).notify(new BatchResult.Callback<Boolean, StorageException>() {
public void success(Boolean result) {
// deleted successfully
}
public void error(StorageException exception) {
// delete failed
}
});
batch.update(BlobInfo.builder(secondBlob).contentType("text/plain").build());
StorageBatchResult<Blob> result = batch.get(secondBlob);
batch.submit();
Blob blob = result.get(); // returns get result or throws StorageException
Methods
delete(BlobId blob, Storage.BlobSourceOption[] options)
public StorageBatchResult<Boolean> delete(BlobId blob, Storage.BlobSourceOption[] options)
Adds a request representing the "delete blob" operation to this batch. Calling StorageBatchResult#get() on the return value yields true upon successful deletion,
false if the blob was not found, or throws a StorageException if the operation
failed.
delete(String bucket, String blob, Storage.BlobSourceOption[] options)
public StorageBatchResult<Boolean> delete(String bucket, String blob, Storage.BlobSourceOption[] options)
Adds a request representing the "delete blob" operation to this batch. Calling StorageBatchResult#get() on the return value yields true upon successful deletion,
false if the blob was not found, or throws a StorageException if the operation
failed.
get(BlobId blob, Storage.BlobGetOption[] options)
public StorageBatchResult<Blob> get(BlobId blob, Storage.BlobGetOption[] options)
Adds a request representing the "get blob" operation to this batch. The options can be
used in the same way as for Storage#get(BlobId, BlobGetOption...). Calling StorageBatchResult#get() on the return value yields the requested Blob if successful,
null if no such blob exists, or throws a StorageException if the operation
failed.
get(String bucket, String blob, Storage.BlobGetOption[] options)
public StorageBatchResult<Blob> get(String bucket, String blob, Storage.BlobGetOption[] options)
Adds a request representing the "get blob" operation to this batch. The options can be
used in the same way as for Storage#get(BlobId, BlobGetOption...). Calling StorageBatchResult#get() on the return value yields the requested Blob if successful,
null if no such blob exists, or throws a StorageException if the operation
failed.
submit()
Submits this batch for processing using a single RPC request.
update(BlobInfo blobInfo, Storage.BlobTargetOption[] options)
public StorageBatchResult<Blob> update(BlobInfo blobInfo, Storage.BlobTargetOption[] options)
