com.microsoft.azure.storage.blob

Class BlockBlobURL

java.lang.Object

com.microsoft.azure.storage.blob.StorageURL

com.microsoft.azure.storage.blob.BlobURL

com.microsoft.azure.storage.blob.BlockBlobURL

public final class BlockBlobURL
extends BlobURL

Represents a URL to a block blob. It may be obtained by direct construction or via the create method on a ContainerURL object. This class does not hold any state about a particular blob but is instead a convenient way of sending off appropriate requests to the resource on the service. Please refer to the Azure Docs for more information on block blobs.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_BLOCKS Indicates the maximum number of blocks allowed in a block blob.
static int	MAX_PUT_BLOB_BYTES Indicates the maximum number of bytes that can be sent in a call to upload.
static int	MAX_STAGE_BLOCK_BYTES Indicates the maximum number of bytes that can be sent in a call to stageBlock.

Fields inherited from class com.microsoft.azure.storage.blob.StorageURL

storageClient

Constructor Summary

Constructors

Constructor and Description
BlockBlobURL(URL url, com.microsoft.rest.v2.http.HttpPipeline pipeline) Creates a new BlockBlobURL object.

Method Summary

Modifier and Type	Method and Description
io.reactivex.Single<BlockBlobCommitBlockListResponse>	commitBlockList(List<String> base64BlockIDs, BlobHTTPHeaders headers, Metadata metadata, BlobAccessConditions accessConditions) Writes a blob by specifying the list of block IDs that are to make up the blob.
io.reactivex.Single<BlockBlobGetBlockListResponse>	getBlockList(BlockListType listType, LeaseAccessConditions leaseAccessConditions) Returns the list of blocks that have been uploaded as part of a block blob using the specified block list filter.
io.reactivex.Single<BlockBlobStageBlockResponse>	stageBlock(String base64BlockID, io.reactivex.Flowable<ByteBuffer> data, long length, LeaseAccessConditions leaseAccessConditions) Uploads the specified block to the block blob's "staging area" to be later committed by a call to commitBlockList.
io.reactivex.Single<BlockBlobStageBlockFromURLResponse>	stageBlockFromURL(String base64BlockID, URL sourceURL, BlobRange sourceRange, byte[] sourceContentMD5, LeaseAccessConditions leaseAccessConditions) Creates a new block to be committed as part of a blob where the contents are read from a URL.
io.reactivex.Single<BlockBlobUploadResponse>	upload(io.reactivex.Flowable<ByteBuffer> data, long length, BlobHTTPHeaders headers, Metadata metadata, BlobAccessConditions accessConditions) Creates a new block blob, or updates the content of an existing block blob.
BlockBlobURL	withPipeline(com.microsoft.rest.v2.http.HttpPipeline pipeline) Creates a new BlockBlobURL with the given pipeline.
BlockBlobURL	withSnapshot(String snapshot) Creates a new BlockBlobURL with the given snapshot.

Methods inherited from class com.microsoft.azure.storage.blob.BlobURL

abortCopyFromURL, acquireLease, breakLease, changeLease, createSnapshot, delete, download, getProperties, releaseLease, renewLease, setHTTPHeaders, setMetadata, setTier, startCopyFromURL, toAppendBlobURL, toBlockBlobURL, toPageBlobURL, undelete

Methods inherited from class com.microsoft.azure.storage.blob.StorageURL

appendToURLPath, createPipeline, toString, toURL

Methods inherited from class java.lang.Object

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

Field Detail

MAX_PUT_BLOB_BYTES

public static final int MAX_PUT_BLOB_BYTES

Indicates the maximum number of bytes that can be sent in a call to upload.

See Also:

Constant Field Values

MAX_STAGE_BLOCK_BYTES

public static final int MAX_STAGE_BLOCK_BYTES

Indicates the maximum number of bytes that can be sent in a call to stageBlock.

See Also:

Constant Field Values

MAX_BLOCKS

public static final int MAX_BLOCKS

Indicates the maximum number of blocks allowed in a block blob.

See Also:

Constant Field Values

Constructor Detail

BlockBlobURL

public BlockBlobURL(URL url,
                    com.microsoft.rest.v2.http.HttpPipeline pipeline)

Creates a new BlockBlobURL object.

Parameters:

url - A java.net.URL to a block blob.

pipeline - An HttpPipeline for sending requests.

Method Detail

withPipeline

public BlockBlobURL withPipeline(com.microsoft.rest.v2.http.HttpPipeline pipeline)

Creates a new BlockBlobURL with the given pipeline.

Overrides:

withPipeline in class BlobURL

Parameters:

pipeline - An HttpPipeline object to set.

Returns:

A BlockBlobURL object with the given pipeline.

withSnapshot

public BlockBlobURL withSnapshot(String snapshot)
                          throws MalformedURLException,
                                 UnknownHostException

Creates a new BlockBlobURL with the given snapshot.

Overrides:

withSnapshot in class BlobURL

Parameters:

snapshot - A String of the snapshot identifier.

Returns:

A BlockBlobURL object with the given pipeline.

Throws:

MalformedURLException - Appending the specified snapshot produced an invalid URL.

UnknownHostException - If the url contains an improperly formatted ipaddress or unknown host address.

upload

public io.reactivex.Single<BlockBlobUploadResponse> upload(io.reactivex.Flowable<ByteBuffer> data,
                                                           long length,
                                                           BlobHTTPHeaders headers,
                                                           Metadata metadata,
                                                           BlobAccessConditions accessConditions)

Creates a new block blob, or updates the content of an existing block blob. Updating an existing block blob overwrites any existing metadata on the blob. Partial updates are not supported with PutBlob; the content of the existing blob is overwritten with the new content. To perform a partial update of a block blob's, use PutBlock and PutBlockList. For more information, see the Azure Docs. For more efficient bulk-upload scenarios, please refer to the TransferManager for convenience methods.

Parameters:

data - The data to write to the blob.

length - The exact length of the data. It is important that this value match precisely the length of the data emitted by the Flowable.

headers - BlobHTTPHeaders

metadata - Metadata

accessConditions - BlobAccessConditions

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=upload_download "Sample code for BlockBlobURL.upload")] \n For more samples, please see the [Samples file](https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)

stageBlock

public io.reactivex.Single<BlockBlobStageBlockResponse> stageBlock(String base64BlockID,
                                                                   io.reactivex.Flowable<ByteBuffer> data,
                                                                   long length,
                                                                   LeaseAccessConditions leaseAccessConditions)

Uploads the specified block to the block blob's "staging area" to be later committed by a call to commitBlockList. For more information, see the Azure Docs.

Parameters:

base64BlockID - A Base64 encoded String that specifies the ID for this block. Note that all block ids for a given blob must be the same length.

data - The data to write to the block.

length - The exact length of the data. It is important that this value match precisely the length of the data emitted by the Flowable.

leaseAccessConditions - LeaseAccessConditions

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=blocks "Sample code for BlockBlobURL.stageBlock")] \n For more samples, please see the [Samples file](https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)

stageBlockFromURL

public io.reactivex.Single<BlockBlobStageBlockFromURLResponse> stageBlockFromURL(String base64BlockID,
                                                                                 URL sourceURL,
                                                                                 BlobRange sourceRange,
                                                                                 byte[] sourceContentMD5,
                                                                                 LeaseAccessConditions leaseAccessConditions)

Creates a new block to be committed as part of a blob where the contents are read from a URL. For more information, see the Azure Docs.

Parameters:

base64BlockID - A Base64 encoded String that specifies the ID for this block. Note that all block ids for a given blob must be the same length.

sourceURL - The url to the blob that will be the source of the copy. A source blob in the same storage account can be authenticated via Shared Key. However, if the source is a blob in another account, the source blob must either be public or must be authenticated via a shared access signature. If the source blob is public, no authentication is required to perform the operation.

sourceRange - BlobRange

sourceContentMD5 - An MD5 hash of the block content from the source blob. If specified, the service will calculate the MD5 of the received data and fail the request if it does not match the provided MD5.

leaseAccessConditions - LeaseAccessConditions

Returns:

Emits the successful response.

API Note:

[!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=block_from_url "Sample code for BlockBlobURL.stageBlockFromURL")]

getBlockList

public io.reactivex.Single<BlockBlobGetBlockListResponse> getBlockList(BlockListType listType,
                                                                       LeaseAccessConditions leaseAccessConditions)

Returns the list of blocks that have been uploaded as part of a block blob using the specified block list filter. For more information, see the Azure Docs.

Parameters:

listType - Specifies which type of blocks to return.

leaseAccessConditions - LeaseAccessConditions

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=blocks "Sample code for BlockBlobURL.getBlockList")] \n For more samples, please see the [Samples file](https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)

commitBlockList

public io.reactivex.Single<BlockBlobCommitBlockListResponse> commitBlockList(List<String> base64BlockIDs,
                                                                             BlobHTTPHeaders headers,
                                                                             Metadata metadata,
                                                                             BlobAccessConditions accessConditions)

Writes a blob by specifying the list of block IDs that are to make up the blob. In order to be written as part of a blob, a block must have been successfully written to the server in a prior stageBlock operation. You can call commitBlockList to update a blob by uploading only those blocks that have changed, then committing the new and existing blocks together. Any blocks not specified in the block list and permanently deleted. For more information, see the Azure Docs. For more efficient bulk-upload scenarios, please refer to the TransferManager for convenience methods.

Parameters:

base64BlockIDs - A list of base64 encode Strings that specifies the block IDs to be committed.

headers - BlobHTTPHeaders

metadata - Metadata

accessConditions - BlobAccessConditions

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=blocks "Sample code for BlockBlobURL.commitBlockList")] \n For more samples, please see the [Samples file](https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)