org.soyatec.windowsazure.blob
Interface IBlob

All Known Subinterfaces:

IBlockBlob, IPageBlob

public interface IBlob

The Blob class specifies contents and properties for blob.

Method Summary

java.lang.String	createSnapshot(org.soyatec.windowsazure.internal.util.NameValueCollection headerParameters) This operation creates a read-only snapshot of a blob.
IBlobContents	getContents(BlobStream stream) The contents of the Blob in various forms.
IBlobContents	getContents(BlobStream stream, java.lang.String snapshot) The contents of the Blob snapshot.
IBlobProperties	getProperties() The properties associated with the blob.
IBlobProperties	getProperties(java.lang.String snapshot) The properties associated with the blob snapshot.
void	setContents(IBlobContents contents) Set the contents of the Blob.
void	setProperties(IBlobProperties properties) Set the properties of a blob.
boolean	updateIfNotModified(IBlobProperties blobProperties, IBlobContents contents) Updates an existing blob if it has not been modified since you retrieve it.

Method Detail

getContents

IBlobContents getContents(BlobStream stream)
                          throws StorageException

The contents of the Blob in various forms.

Returns:

the contents of the Blob.

Throws:

StorageException

getContents

IBlobContents getContents(BlobStream stream,
                          java.lang.String snapshot)
                          throws StorageException

The contents of the Blob snapshot.

Parameters:

stream -

snapshot - The DateTime value that uniquely identifies the snapshot. This value indicates the snapshot version.

Returns:

Throws:

StorageException

setContents

void setContents(IBlobContents contents)
                 throws StorageException

Set the contents of the Blob.

Parameters:

contents -

Throws:

StorageException

getProperties

IBlobProperties getProperties()
                              throws StorageException

The properties associated with the blob.

Returns:

the properties associated with the blob.

Throws:

StorageException

getProperties

IBlobProperties getProperties(java.lang.String snapshot)
                              throws StorageException

The properties associated with the blob snapshot.

Parameters:

snapshot - The DateTime value that uniquely identifies the snapshot. This value indicates the snapshot version.

Returns:

Throws:

StorageException

setProperties

void setProperties(IBlobProperties properties)
                   throws StorageException

Set the properties of a blob.

Parameters:

properties -

Throws:

StorageException

updateIfNotModified

boolean updateIfNotModified(IBlobProperties blobProperties,
                            IBlobContents contents)
                            throws StorageException

Updates an existing blob if it has not been modified since you retrieve it. Use this method to implement optimistic concurrency by avoiding clobbering changes to the blob made by another writer.

Parameters:

blobProperties - The properties of the blob. This object should be one previously obtained from a call to getProperties.

contents - The contents of the blob. The contents of the blob should be readable

Returns:

true if the blob is updated. false if the blob has changed since the last time.

Throws:

StorageException

createSnapshot

java.lang.String createSnapshot(org.soyatec.windowsazure.internal.util.NameValueCollection headerParameters)
                                throws StorageException

This operation creates a read-only snapshot of a blob.

Parameters:

headerParameters - Optional request header parameters

Returns:

Datetime value that uniquely identifies the snapshot. The value indicates the snapshot version, and may be used in subsequent requests to access the snapshot.

Throws:

StorageException