CloudBlockBlob クラス
- java.
lang. Object - ListBlobItem
- CloudBlob
- com.
microsoft. azure. storage. blob. CloudBlockBlob
- com.
public class CloudBlockBlob extends CloudBlob
一連のブロックとしてアップロードされる BLOB を表します。
コンストラクターの概要
| コンストラクター | 説明 |
|---|---|
| CloudBlockBlob(final CloudBlockBlob otherBlob) |
別のクラウド ブロック BLOB から値をコピーして、 クラスのインスタンスを作成します。 |
| CloudBlockBlob(final StorageUri blobAbsoluteUri) |
指定した絶対 StorageUri を使用して、 クラスのインスタンスを作成します。 |
| CloudBlockBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials) |
指定した絶対 StorageUri と資格情報を使用して、 クラスのインスタンスを作成します。 |
| CloudBlockBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials) |
指定した絶対 StorageUri、スナップショット ID、資格情報を使用して、 クラスのインスタンスを作成します。 |
| CloudBlockBlob(final URI blobAbsoluteUri) |
指定した絶対 URI を使用して、 クラスのインスタンスを作成します。 |
| CloudBlockBlob(final URI blobAbsoluteUri, final StorageCredentials credentials) |
指定した絶対 URI と資格情報を使用して、 クラスのインスタンスを作成します。 |
| CloudBlockBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials) |
指定した絶対 URI、スナップショット ID、資格情報を使用して、 クラスのインスタンスを作成します。 |
| CloudBlockBlob(String blobName, String snapshotID, CloudBlobContainer container) |
指定した型、名前、スナップショット ID、およびコンテナーを使用して、 クラスのインスタンスを作成します。 |
メソッドの概要
継承メンバー
コンストラクターの詳細
CloudBlockBlob
public CloudBlockBlob(final CloudBlockBlob otherBlob)
別のクラウド ブロック BLOB から値をコピーして、 クラスのインスタンスを作成します。
Parameters:
CloudBlockBlobコピーするブロック BLOB を表す オブジェクト。
CloudBlockBlob
public CloudBlockBlob(final StorageUri blobAbsoluteUri)
指定した絶対 StorageUri を使用して、 クラスのインスタンスを作成します。
Parameters:
Throws:
CloudBlockBlob
public CloudBlockBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)
指定した絶対 StorageUri と資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
Throws:
CloudBlockBlob
public CloudBlockBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)
指定した絶対 StorageUri、スナップショット ID、資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
String該当する場合は、スナップショットバージョンを表す 。
Throws:
CloudBlockBlob
public CloudBlockBlob(final URI blobAbsoluteUri)
指定した絶対 URI を使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI BLOB の絶対 URI を表す オブジェクト。
Throws:
CloudBlockBlob
public CloudBlockBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)
指定した絶対 URI と資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI BLOB の絶対 URI を表す オブジェクト。
Throws:
CloudBlockBlob
public CloudBlockBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)
指定した絶対 URI、スナップショット ID、資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI BLOB の絶対 URI を表す オブジェクト。
String該当する場合は、スナップショットバージョンを表す 。
Throws:
CloudBlockBlob
protected CloudBlockBlob(String blobName, String snapshotID, CloudBlobContainer container)
指定した型、名前、スナップショット ID、およびコンテナーを使用して、 クラスのインスタンスを作成します。
Parameters:
String該当する場合は、スナップショットバージョンを表す 。
Throws:
メソッドの詳細
commitBlockList
public void commitBlockList(final Iterable
ブロック リストをストレージ サービスにコミットします。 BLOB の一部として書き込まれるには、前の uploadBlock 操作でブロックがサーバーに正常に書き込まれている必要があります。
Parameters:
Throws:
commitBlockList
public void commitBlockList(final Iterable
指定したリース ID、要求オプション、および操作コンテキストを使用して、ブロック リストをストレージ サービスにコミットします。 BLOB の一部として書き込まれるには、前の uploadBlock 操作でブロックがサーバーに正常に書き込まれている必要があります。
Parameters:
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
commitBlockList
public void commitBlockList(final Iterable
指定したリース ID、要求オプション、および操作コンテキストを使用して、ブロック リストをストレージ サービスにコミットします。 BLOB の一部として書き込まれるには、前の uploadBlock 操作でブロックがサーバーに正常に書き込まれている必要があります。
Parameters:
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
createBlockFromURI
public void createBlockFromURI(final String blockId, final URI copySource, final Long offset, final Long length)
指定したブロック ID とソース URL を使用して、ブロック BLOB の一部としてコミットされるブロックを作成します。
Parameters:
String Base-64 でエンコードされたブロック ID を表す 。 特定の BLOB の場合、すべてのブロック ID の長さは同じである必要があります。
URIソース データの 。 パブリックである任意の Azure BLOB またはファイルを指すか、URL に共有アクセス署名を含めることができます。
longソースの開始点として使用するオフセットを表す 。
Long BLOB の末尾までコピーまたはnullコピーするバイト数を表す 。
Throws:
createBlockFromURI
public void createBlockFromURI(final String blockId, final URI copySource, final Long offset, final Long length, String md5, final AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したブロック ID、指定したソース URL、指定したリース ID、要求オプション、操作コンテキストを使用して、ブロック BLOB の一部としてコミットされるブロックを作成します。
Parameters:
String Base-64 でエンコードされたブロック ID を表す 。 特定の BLOB の場合、すべてのブロック ID の長さは同じである必要があります。
URIソース データの 。 パブリックである任意の Azure BLOB またはファイルを指すか、URL に共有アクセス署名を含めることができます。
longソースの開始点として使用するオフセットを表す 。
Long BLOB の末尾までコピーまたはnullコピーするバイト数を表す 。
Stringソースのバイト範囲に対して計算された MD5 を表す 。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
downloadBlockList
public ArrayList
コミットされたブロック リストをブロック BLOB からダウンロードします。
コミットされたブロック リストには、ブロック BLOB に正常にコミットされたブロックの一覧が含まれます。 コミットされたブロックの一覧は、BLOB にコミットされた順序と同じ順序で返されます。 コミット後のブロック一覧にブロックは複数回出現できません。
Returns:
ArrayListブロック BLOB からダウンロードされたコミット済みのリスト ブロック項目を表す オブジェクトのオブジェクトBlockEntry。Throws:
downloadBlockList
public ArrayList
指定したブロック 一覧フィルター、要求オプション、および操作コンテキストを使用して、ブロック BLOB からブロック リストをダウンロードします。
コミットされたブロック リストには、ブロック BLOB に正常にコミットされたブロックの一覧が含まれます。 コミットされたブロックの一覧は、BLOB にコミットされた順序と同じ順序で返されます。 コミット後のブロック一覧にブロックは複数回出現できません。
Parameters:
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
ArrayListブロック BLOB からダウンロードされたリスト ブロック項目を表す オブジェクトのオブジェクトBlockEntry。Throws:
downloadText
public String downloadText()
プラットフォームの既定のエンコードを使用して、BLOB を文字列にダウンロードします。
Returns:
String BLOB の内容を表す 。Throws:
downloadText
public String downloadText(final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したエンコードを使用して、BLOB を文字列にダウンロードします。
Parameters:
Stringコンテンツのエンコードに使用する文字セットの名前を表す 。 null の場合、プラットフォームの既定のエンコードが使用されます。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String BLOB の内容を表す 。Throws:
isStreamWriteSizeModified
public boolean isStreamWriteSizeModified()
既定の streamWriteSize が変更されたかどうかを示すフラグを取得します。
openOutputStream
public BlobOutputStream openOutputStream()
ブロック BLOB にデータを書き込む出力ストリームを作成して開きます。 サービスに BLOB が既に存在する場合は、上書きされます。
上書きを回避し、代わりにエラーをスローするには、適切な AccessConditionと共に openOutputStream(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) オーバーロードを使用してください。
Returns:
Throws:
openOutputStream
public BlobOutputStream openOutputStream(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、ブロック BLOB にデータを書き込む出力ストリームを作成して開きます。 サービスに BLOB が既に存在する場合は、上書きされます。
上書きを回避し、代わりにエラーをスローするには、 を使用してgenerateIfNotExistsCondition()生成された をAccessCondition渡してください。
Parameters:
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
setStreamWriteSizeInBytes
public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
への書き込み時にバッファーに格納するバイト数を BlobOutputStream設定します。
Parameters:
intオブジェクトの使用中BlobOutputStreamにブロック BLOB に書き込む最大ブロック サイズ (バイト単位) を表す 。16 KB から 100 MB までの範囲。
Throws:
streamWriteSizeInBytes 。
startCopy
public final String startCopy(final CloudBlockBlob sourceBlob)
ブロック BLOB のコンテンツ、プロパティ、およびメタデータの新しいブロック BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudBlockBlobコピーするソース BLOB を表す オブジェクト。
Returns:
Stringコピー操作に関連付けられているコピー ID を表す 。Throws:
startCopy
public final String startCopy(final CloudBlockBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、ブロック BLOB のコンテンツ、プロパティ、メタデータの新しいブロック BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudBlockBlobコピーするソース BLOB を表す オブジェクト。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Stringコピー操作に関連付けられているコピー ID を表す 。Throws:
startCopy
public final String startCopy(final CloudBlockBlob sourceBlob, String contentMd5, boolean syncCopy, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、ブロック BLOB のコンテンツ、プロパティ、メタデータの新しいブロック BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudBlockBlobコピーするソース BLOB を表す オブジェクト。
null 。
boolean BLOB の同期サーバー コピーを有効にする 。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Stringコピー操作に関連付けられているコピー ID を表す 。Throws:
startCopy
public final String startCopy(final CloudBlockBlob sourceBlob, String contentMd5, boolean syncCopy, final StandardBlobTier standardBlobTier, RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
BLOB 層、リハイドレート優先度、指定されたアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、ブロック BLOB のコンテンツ、プロパティ、メタデータの新しいブロック BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudBlockBlobコピーするソース BLOB を表す オブジェクト。
null 。
boolean BLOB の同期サーバー コピーを有効にする 。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Stringコピー操作に関連付けられているコピー ID を表す 。Throws:
startCopy
public final String startCopy(final CloudFile sourceFile)
ファイルの内容、プロパティ、およびメタデータの新しいブロック BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudFileコピーするソース ファイルを表す オブジェクト。
Returns:
Stringコピー操作に関連付けられているコピー ID を表す 。Throws:
startCopy
public final String startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、ファイルのコンテンツ、プロパティ、メタデータの新しいブロック BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudFileコピーするソース ファイルを表す オブジェクト。
null 指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Stringコピー操作に関連付けられているコピー ID を表す 。Throws:
upload
public void upload(final InputStream sourceStream, final long length)
ソース ストリーム データをブロック BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
longストリーム データの長さをバイト単位で表す 。不明な場合は -1。
Throws:
upload
public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、ソース ストリーム データを BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
longストリーム データの長さをバイト単位で表す 。不明な場合は -1。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
upload
public void upload(final InputStream sourceStream, final long length, final StandardBlobTier standardBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、ソース ストリーム データを BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
longストリーム データの長さをバイト単位で表す 。不明な場合は -1。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadBlock
public void uploadBlock(final String blockId, final InputStream sourceStream, final long length)
指定したブロック ID を使用して、ブロック BLOB の一部としてコミットされるブロックをアップロードします。
Parameters:
String Base-64 でエンコードされたブロック ID を表す 。 特定の BLOB の場合、すべてのブロック ID の長さは同じである必要があります。
longストリーム データの長さをバイト単位で表す 。不明な場合は -1。
Throws:
uploadBlock
public void uploadBlock(final String blockId, final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したブロック ID、指定したリース ID、要求オプション、操作コンテキストを使用して、ブロック BLOB の一部としてコミットされるブロックをアップロードします。
Parameters:
String Base-64 でエンコードされたブロック ID を表す 。 特定の BLOB の場合、すべてのブロック ID の長さは同じである必要があります。
longストリーム データの長さをバイト単位で表す 。不明な場合は -1。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final StandardBlobTier standardBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
バイト配列内のデータから BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
byte BLOB に書き込むデータを表す配列。
intデータのアップロードを開始するバイト配列のオフセットを表す 。
int入力バッファーからアップロードするバイト数を表す 。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadFullBlob
protected final void uploadFullBlob(final InputStream sourceStream, final long length, final StandardBlobTier standardBlobTier, final AccessCondition accessCondition, final BlobRequestOptions options, final OperationContext opContext)
1 回の操作で BLOB をアップロードします。
Parameters:
InputStreamアップロードするソース ストリームを表す オブジェクト。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadStandardBlobTier
public void uploadStandardBlobTier(final StandardBlobTier standardBlobTier)
Standard ストレージ アカウントのブロック BLOB に BLOB 層を設定します。
Parameters:
Throws:
uploadStandardBlobTier
public void uploadStandardBlobTier(final StandardBlobTier standardBlobTier, BlobRequestOptions options, OperationContext opContext)
Standard ストレージ アカウントのブロック BLOB の層を設定します。
Parameters:
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadStandardBlobTier
public void uploadStandardBlobTier(final StandardBlobTier standardBlobTier, RehydratePriority rehydratePriority, BlobRequestOptions options, OperationContext opContext)
Standard ストレージ アカウントのブロック BLOB の層を設定します。
Parameters:
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadText
public void uploadText(final String content)
プラットフォームの既定のエンコードを使用して、文字列から BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
String BLOB にアップロードされるコンテンツを表す 。
Throws:
uploadText
public void uploadText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したエンコードを使用して、文字列から BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
String BLOB にアップロードされるコンテンツを表す 。
Stringコンテンツのエンコードに使用する文字セットの名前を表す 。 null の場合、プラットフォームの既定のエンコードが使用されます。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadText
public void uploadText(final String content, final String charsetName, final StandardBlobTier standardBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したエンコードを使用して、文字列から BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
String BLOB にアップロードされるコンテンツを表す 。
Stringコンテンツのエンコードに使用する文字セットの名前を表す 。 null の場合、プラットフォームの既定のエンコードが使用されます。
null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
適用対象
Azure SDK for Java