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