CloudAppendBlob クラス
- java.
lang. Object - ListBlobItem
- CloudBlob
- com.
microsoft. azure. storage. blob. CloudAppendBlob
- com.
public class CloudAppendBlob extends CloudBlob
Microsoft Azure Append BLOB を表します。
コンストラクターの概要
メソッドの概要
継承メンバー
コンストラクターの詳細
CloudAppendBlob
public CloudAppendBlob(final CloudAppendBlob otherBlob)
別の追加 BLOB から値をコピーして、 クラスのインスタンスを作成します。
Parameters:
CloudAppendBlob
コピーする追加 BLOB を表す オブジェクト。
CloudAppendBlob
public CloudAppendBlob(final StorageUri blobAbsoluteUri)
指定した絶対 URI とストレージ サービス クライアントを使用して、 クラスのインスタンスを作成します。
Parameters:
Throws:
CloudAppendBlob
public CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)
指定した絶対 StorageUri と資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
Throws:
CloudAppendBlob
public CloudAppendBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)
指定した絶対 StorageUri、スナップショット ID、資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
String
スナップショットバージョンを表す 。該当する場合は 。
Throws:
CloudAppendBlob
public CloudAppendBlob(final URI blobAbsoluteUri)
指定した絶対 URI とストレージ サービス クライアントを使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI
BLOB の絶対 URI を表す オブジェクト。
Throws:
CloudAppendBlob
public CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)
指定した絶対 URI と資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI
BLOB の絶対 URI を表す オブジェクト。
Throws:
CloudAppendBlob
public CloudAppendBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)
指定した絶対 URI、スナップショット ID、資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI
BLOB の絶対 URI を表す オブジェクト。
String
スナップショットバージョンを表す 。該当する場合は 。
Throws:
CloudAppendBlob
protected CloudAppendBlob(String blobName, String snapshotID, CloudBlobContainer container)
指定した型、名前、スナップショット ID、およびコンテナーを使用して、 クラスのインスタンスを作成します。
Parameters:
String
スナップショットバージョンを表す 。該当する場合は 。
Throws:
メソッドの詳細
append
public void append(InputStream sourceStream, final long length)
追加 BLOB にストリームを追加します。 この API は、複数のライター シナリオでは機能しない重複ブロックを回避するために、アペンド オフセット条件付きヘッダーを内部的に使用するため、1 つのライター シナリオでは厳密に使用する必要があります。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
long
ストリーム データの長さをバイト単位で表す 。不明な場合は -1。
Throws:
append
public void append(InputStream sourceStream, final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
追加 BLOB にストリームを追加します。 この API は、複数のライター シナリオでは機能しない重複ブロックを回避するために、アペンド オフセット条件付きヘッダーを内部的に使用するため、1 つのライター シナリオでは厳密に使用する必要があります。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
long
ストリーム データの長さをバイト単位で表す 。不明な場合は -1。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
appendBlock
public Long appendBlock(final InputStream sourceStream, final long length)
新しいデータ ブロックを BLOB の末尾にコミットします。
Parameters:
long
ストリーム データの長さをバイト単位で表す 。不明な場合は -1。
Returns:
Throws:
appendBlock
public Long appendBlock(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
新しいデータ ブロックを BLOB の末尾にコミットします。
Parameters:
long
ストリーム データの長さをバイト単位で表す 。不明な場合は -1。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
appendBlockFromURI
public Long appendBlockFromURI(final URI copySource, final Long offset, final Long length)
指定したソース URL を使用して、ブロックを追加します。
Parameters:
URI
ソース データの 。 パブリックである任意の Azure BLOB またはファイルを指すか、URL に共有アクセス署名を含めることができます。
long
ソースの開始点として使用するオフセットを表す 。
Long
BLOB の末尾までコピーまたはnull
コピーするバイト数を表す 。
Returns:
Throws:
appendBlockFromURI
public Long appendBlockFromURI(final URI copySource, final Long offset, final Long length, String md5, final AccessCondition accessCondition, final AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したソース URL を使用して、ブロックを追加します。
Parameters:
URI
ソース データの 。 パブリックである任意の Azure BLOB またはファイルを指すか、URL に共有アクセス署名を含めることができます。
long
ソースの開始点として使用するオフセットを表す 。
Long
BLOB の末尾までコピーまたはnull
コピーするバイト数を表す 。
String
ソースのバイト範囲に対して計算された MD5 を表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
appendFromByteArray
public void appendFromByteArray(final byte[] buffer, final int offset, final int length)
バイト配列の内容を追加 BLOB に追加します。この API は、複数のライター シナリオでは機能しない重複ブロックを回避するために、アペンド オフセット条件付きヘッダーを内部的に使用するため、1 つのライター シナリオでは厳密に使用する必要があります。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
byte
BLOB に追加するデータを表す配列。
int
データのアップロードを開始するバイト配列のオフセットを表す 。
int
入力バッファーからアップロードするバイト数を表す 。
Throws:
appendFromByteArray
public void appendFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
バイト配列の内容を追加 BLOB に追加します。この API は、複数のライター シナリオでは機能しない重複ブロックを回避するために、アペンド オフセット条件付きヘッダーを内部的に使用するため、1 つのライター シナリオでは厳密に使用する必要があります。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
byte
BLOB に追加するデータを表す配列。
int
データのアップロードを開始するバイト配列のオフセットを表す 。
int
入力バッファーからアップロードするバイト数を表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
appendFromFile
public void appendFromFile(final String path)
追加 BLOB にファイルを追加します。 この API は、複数のライター シナリオでは機能しない重複ブロックを回避するために、アペンド オフセット条件付きヘッダーを内部的に使用するため、1 つのライター シナリオでは厳密に使用する必要があります。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
String
追加するファイルへのパスを表す 。
Throws:
appendFromFile
public void appendFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
追加 BLOB にファイルを追加します。 この API は、複数のライター シナリオでは機能しない重複ブロックを回避するために、アペンド オフセット条件付きヘッダーを内部的に使用するため、1 つのライター シナリオでは厳密に使用する必要があります。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
String
追加するファイルへのパスを表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
appendText
public void appendText(final String content)
プラットフォームの既定のエンコードを使用して、追加 BLOB にテキストの文字列を追加します。 この API は、複数のライター シナリオでは機能しない重複ブロックを回避するために、アペンド オフセット条件付きヘッダーを内部的に使用するため、1 つのライター シナリオでは厳密に使用する必要があります。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
String
BLOB に追加されるコンテンツを表す 。
Throws:
appendText
public void appendText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したエンコードを使用して、追加 BLOB にテキストの文字列を追加します。 この API は、複数のライター シナリオでは機能しない重複ブロックを回避するために、アペンド オフセット条件付きヘッダーを内部的に使用するため、1 つのライター シナリオでは厳密に使用する必要があります。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
String
BLOB に追加されるコンテンツを表す 。
String
コンテンツのエンコードに使用する文字セットの名前を表す 。 null の場合、プラットフォームの既定のエンコードが使用されます。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
createOrReplace
public void createOrReplace()
空の追加 BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。
上書きを回避し、代わりにエラーをスローするには、適切な AccessConditionと共に createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) オーバーロードを使用してください。
Throws:
createOrReplace
public void createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、追加 BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。
上書きを回避し、代わりにエラーをスローするには、 を使用してgenerateIfNotExistsCondition()生成された をAccessCondition渡してください。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
openWriteExisting
public BlobOutputStream openWriteExisting()
出力ストリーム オブジェクトを開き、追加 BLOB にデータを書き込みます。 追加 BLOB は既に存在している必要があり、追加されます。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Returns:
Throws:
openWriteExisting
public BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、追加 BLOB にデータを書き込む出力ストリーム オブジェクトを開きます。 追加 BLOB は既に存在している必要があり、追加されます。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
openWriteNew
public BlobOutputStream openWriteNew()
出力ストリーム オブジェクトを開き、追加 BLOB にデータを書き込みます。 追加 BLOB がまだ存在している必要はありません。 BLOB が既に存在する場合は、これが置き換えられます。
上書きを回避し、代わりにエラーをスローするには、適切な AccessConditionと共に openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) オーバーロードを使用してください。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Returns:
Throws:
openWriteNew
public BlobOutputStream openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、追加 BLOB にデータを書き込む出力ストリーム オブジェクトを開きます。 追加 BLOB がまだ存在している必要はありません。 BLOB が既に存在する場合は、これが置き換えられます。
上書きを回避し、代わりにエラーをスローするには、 を使用してgenerateIfNotExistsCondition()生成された をAccessCondition渡してください。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
setStreamWriteSizeInBytes
public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
への書き込み時にバッファーに格納するバイト数を BlobOutputStream設定します。
Parameters:
int
オブジェクトの使用中BlobOutputStreamに追加 BLOB に書き込む最大ブロック サイズ (バイト単位) を表す 。16 KB から 4 MB の範囲。
Throws:
streamWriteSizeInBytes
。
startCopy
public final String startCopy(final CloudAppendBlob sourceBlob)
サービスに対して、追加 BLOB の内容、プロパティ、およびメタデータの新しい追加 BLOB へのコピーを開始するように要求します。
Parameters:
CloudAppendBlob
コピーするソース BLOB を表す オブジェクト。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
startCopy
public final String startCopy(final CloudAppendBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、追加 BLOB の内容、プロパティ、メタデータの新しい追加 BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudAppendBlob
コピーするソース BLOB を表す オブジェクト。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
upload
public void upload(final InputStream sourceStream, final long length)
ソース ストリーム データを追加 BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
既存の BLOB にデータを追加する場合は、「 」を参照してください appendBlock(final InputStream sourceStream, final long length)。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
long
ストリーム データの長さをバイト単位で表す 。不明な場合は -1。
Throws:
upload
public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、ソース ストリーム データを追加 BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
既存の BLOB にデータを追加する場合は、「 」を参照してください appendBlock(final InputStream sourceStream, final long length)。
1 つのライター シナリオで書き込みを行う場合は、このフラグを に設定することが許容されるかどうかを確認 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) してください。
Parameters:
long
ストリーム データの長さをバイト単位で表す 。不明な場合は -1。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
適用対象
Azure SDK for Java