CloudAppendBlob Klasse
- java.
lang. Object - ListBlobItem
- CloudBlob
- com.
microsoft. azure. storage. blob. CloudAppendBlob
- com.
public class CloudAppendBlob extends CloudBlob
Stellt ein Microsoft Azure Append-Blob dar.
Zusammenfassung zum Konstruktor
Konstruktor | Beschreibung |
---|---|
CloudAppendBlob(final CloudAppendBlob otherBlob) |
Erstellt eine instance der -Klasse durch Kopieren von Werten aus einem anderen Anfügeblob. |
CloudAppendBlob(final StorageUri blobAbsoluteUri) |
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients. |
CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials) |
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten StorageUri und der angegebenen Anmeldeinformationen. |
CloudAppendBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials) |
Erstellt eine instance der -Klasse unter Verwendung der angegebenen absoluten StorageUri- Momentaufnahme-ID und der angegebenen Anmeldeinformationen. |
CloudAppendBlob(final URI blobAbsoluteUri) |
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients. |
CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials) |
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und der angegebenen Anmeldeinformationen. |
CloudAppendBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials) |
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI, Momentaufnahme ID und Anmeldeinformationen. |
CloudAppendBlob(String blobName, String snapshotID, CloudBlobContainer container) |
Erstellt eine instance der Klasse unter Verwendung des angegebenen Typs, namens, Momentaufnahme ID und Des Containers. |
Methodenzusammenfassung
Modifizierer und Typ | Methode und Beschreibung |
---|---|
void |
append(InputStream sourceStream, final long length)
Fügt einen Stream an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
append(InputStream sourceStream, final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt einen Stream an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
Long |
appendBlock(final InputStream sourceStream, final long length)
Committent einen neuen Datenblock an das Ende des Blobs. |
Long |
appendBlock(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Committent einen neuen Datenblock an das Ende des Blobs. |
Long |
appendBlockFromURI(final URI copySource, final Long offset, final Long length)
Fügt einen Block unter Verwendung der angegebenen Quell-URL an. |
Long |
appendBlockFromURI(final URI copySource, final Long offset, final Long length, String md5, final AccessCondition accessCondition, final AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt einen Block unter Verwendung der angegebenen Quell-URL an. |
void |
appendFromByteArray(final byte[] buffer, final int offset, final int length)
Fügt den Inhalt eines Bytearrays an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
appendFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt den Inhalt eines Bytearrays an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
appendFromFile(final String path)
Fügt eine Datei an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
appendFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt eine Datei an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
appendText(final String content)
Fügt eine Textzeichenfolge mithilfe der Standardcodierung der Plattform an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
appendText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt eine Textzeichenfolge mithilfe der angegebenen Codierung an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
createOrReplace()
Erstellt ein leeres Anfügeblob. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, verwenden Sie die createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überladung mit der entsprechenden AccessCondition. |
void |
createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Erstellt ein Anfügeblob unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte . |
Blob |
openWriteExisting()
Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Anfügeblob. Das Anfügeblob muss bereits vorhanden sein und wird an angefügt. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
Blob |
openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Anfügeblob unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts. Das Anfügeblob muss bereits vorhanden sein und wird an angefügt. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
Blob |
openWriteNew()
Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Anfügeblob. Das Anfügeblob muss noch nicht vorhanden sein. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, verwenden Sie die openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überladung mit der entsprechenden AccessCondition. Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
Blob |
openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Anfügeblob unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts. Das Anfügeblob muss noch nicht vorhanden sein. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte . Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Legt die Anzahl der Bytes fest, die beim Schreiben in eine gepuffert BlobOutputStreamwerden sollen. |
final String |
startCopy(final CloudAppendBlob sourceBlob)
Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Anfügeblobs in ein neues Anfügeblob zu beginnen. |
final String |
startCopy(final CloudAppendBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Anfügeblobs unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts in ein neues Anfügeblob zu beginnen. |
void |
upload(final InputStream sourceStream, final long length)
Lädt die Quellstreamdaten in das Anfügeblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben. Wenn Sie Daten an ein bereits vorhandenes Blob anfügen möchten, lesen appendBlock(final InputStream sourceStream, final long length)Sie . Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
void |
upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Lädt die Quellstreamdaten unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts in das Anfügeblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben. Wenn Sie Daten an ein bereits vorhandenes Blob anfügen möchten, lesen appendBlock(final InputStream sourceStream, final long length)Sie . Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist. |
Geerbte Elemente
Details zum Konstruktor
CloudAppendBlob
public CloudAppendBlob(final CloudAppendBlob otherBlob)
Erstellt eine instance der -Klasse durch Kopieren von Werten aus einem anderen Anfügeblob.
Parameters:
CloudAppendBlob
-Objekt, das das zu kopierende Anfügeblob darstellt.
CloudAppendBlob
public CloudAppendBlob(final StorageUri blobAbsoluteUri)
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients.
Parameters:
Throws:
CloudAppendBlob
public CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten StorageUri und der angegebenen Anmeldeinformationen.
Parameters:
Throws:
CloudAppendBlob
public CloudAppendBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)
Erstellt eine instance der -Klasse unter Verwendung der angegebenen absoluten StorageUri- Momentaufnahme-ID und der angegebenen Anmeldeinformationen.
Parameters:
String
, die ggf. die Momentaufnahme Version darstellt.
Throws:
CloudAppendBlob
public CloudAppendBlob(final URI blobAbsoluteUri)
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients.
Parameters:
java.net.URI
-Objekt, das den absoluten URI für das Blob darstellt.
Throws:
CloudAppendBlob
public CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und der angegebenen Anmeldeinformationen.
Parameters:
java.net.URI
-Objekt, das den absoluten URI für das Blob darstellt.
Throws:
CloudAppendBlob
public CloudAppendBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI, Momentaufnahme ID und Anmeldeinformationen.
Parameters:
java.net.URI
-Objekt, das den absoluten URI für das Blob darstellt.
String
, die ggf. die Momentaufnahme Version darstellt.
Throws:
CloudAppendBlob
protected CloudAppendBlob(String blobName, String snapshotID, CloudBlobContainer container)
Erstellt eine instance der Klasse unter Verwendung des angegebenen Typs, namens, Momentaufnahme ID und Des Containers.
Parameters:
String
, die ggf. die Momentaufnahme Version darstellt.
Throws:
Details zur Methode
append
public void append(InputStream sourceStream, final long length)
Fügt einen Stream an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
long
, der die Länge der Datenstromdaten in Bytes darstellt, oder -1, wenn unbekannt.
Throws:
append
public void append(InputStream sourceStream, final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt einen Stream an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
long
, der die Länge der Datenstromdaten in Bytes darstellt, oder -1, wenn unbekannt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
appendBlock
public Long appendBlock(final InputStream sourceStream, final long length)
Committent einen neuen Datenblock an das Ende des Blobs.
Parameters:
long
, der die Länge der Datenstromdaten in Bytes darstellt, oder -1, wenn unbekannt.
Returns:
Throws:
appendBlock
public Long appendBlock(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Committent einen neuen Datenblock an das Ende des Blobs.
Parameters:
long
, der die Länge der Datenstromdaten in Bytes darstellt, oder -1, wenn unbekannt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
Throws:
appendBlockFromURI
public Long appendBlockFromURI(final URI copySource, final Long offset, final Long length)
Fügt einen Block unter Verwendung der angegebenen Quell-URL an.
Parameters:
URI
der Quelldaten. Sie kann auf ein beliebiges Azure-Blob oder eine Datei verweisen, die öffentlich ist, oder die URL kann eine Shared Access Signature enthalten.
long
, der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.
Long
, der die Anzahl der Bytes darstellt, die bis zum Ende des Blobs kopiert oder null
kopiert werden sollen.
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)
Fügt einen Block unter Verwendung der angegebenen Quell-URL an.
Parameters:
URI
der Quelldaten. Sie kann auf ein beliebiges Azure-Blob oder eine Datei verweisen, die öffentlich ist, oder die URL kann eine Shared Access Signature enthalten.
long
, der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.
Long
, der die Anzahl der Bytes darstellt, die bis zum Ende des Blobs kopiert oder null
kopiert werden sollen.
String
, der den MD5 darstellt, der für den Bytebereich der Quelle kaluklatiert ist.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
Throws:
appendFromByteArray
public void appendFromByteArray(final byte[] buffer, final int offset, final int length)
Fügt den Inhalt eines Bytearrays an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
byte
Array, das die Daten darstellt, die an das Blob angefügt werden sollen.
int
, der den Offset des Bytearrays darstellt, aus dem der Datenupload gestartet werden soll.
int
, der die Anzahl der Bytes darstellt, die aus dem Eingabepuffer hochgeladen werden sollen.
Throws:
appendFromByteArray
public void appendFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt den Inhalt eines Bytearrays an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
byte
Array, das die Daten darstellt, die an das Blob angefügt werden sollen.
int
, der den Offset des Bytearrays darstellt, aus dem der Datenupload gestartet werden soll.
int
, der die Anzahl der Bytes darstellt, die aus dem Eingabepuffer hochgeladen werden sollen.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
appendFromFile
public void appendFromFile(final String path)
Fügt eine Datei an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
String
, der den Pfad zur datei darstellt, die angefügt werden soll.
Throws:
appendFromFile
public void appendFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt eine Datei an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
String
, der den Pfad zur datei darstellt, die angefügt werden soll.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
appendText
public void appendText(final String content)
Fügt eine Textzeichenfolge mithilfe der Standardcodierung der Plattform an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
String
, der den Inhalt darstellt, der an das Blob angefügt wird.
Throws:
appendText
public void appendText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Fügt eine Textzeichenfolge mithilfe der angegebenen Codierung an ein Anfügeblob an. Diese API sollte ausschließlich in einem Szenario mit einem einzelnen Writer verwendet werden, da die API intern den bedingten Header für anfüge-Offset verwendet, um doppelte Blöcke zu vermeiden, die in einem Szenario mit mehreren Writern nicht funktionieren.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
String
, der den Inhalt darstellt, der an das Blob angefügt wird.
String
, der den Namen des Zeichensatzes darstellt, das zum Codieren des Inhalts verwendet werden soll. Bei NULL wird die Standardcodierung der Plattform verwendet.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
createOrReplace
public void createOrReplace()
Erstellt ein leeres Anfügeblob. Wenn das Blob bereits vorhanden ist, wird es ersetzt.
Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, verwenden Sie die createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überladung mit der entsprechenden AccessCondition.
Throws:
createOrReplace
public void createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Erstellt ein Anfügeblob unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts. Wenn das Blob bereits vorhanden ist, wird es ersetzt.
Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte .
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
openWriteExisting
public BlobOutputStream openWriteExisting()
Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Anfügeblob. Das Anfügeblob muss bereits vorhanden sein und wird an angefügt.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Returns:
Throws:
openWriteExisting
public BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Anfügeblob unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts. Das Anfügeblob muss bereits vorhanden sein und wird an angefügt.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
Throws:
openWriteNew
public BlobOutputStream openWriteNew()
Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Anfügeblob. Das Anfügeblob muss noch nicht vorhanden sein. Wenn das Blob bereits vorhanden ist, wird es ersetzt.
Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, verwenden Sie die openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überladung mit der entsprechenden AccessCondition.
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Returns:
Throws:
openWriteNew
public BlobOutputStream openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Anfügeblob unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts. Das Anfügeblob muss noch nicht vorhanden sein. Wenn das Blob bereits vorhanden ist, wird es ersetzt.
Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte .
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
Throws:
setStreamWriteSizeInBytes
public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Legt die Anzahl der Bytes fest, die beim Schreiben in eine gepuffert BlobOutputStreamwerden sollen.
Parameters:
int
, der die maximale Blockgröße in Bytes für das Schreiben in ein Anfügeblob während der Verwendung eines BlobOutputStream -Objekts darstellt, einschließlich 16 KB bis 4 MB.
Throws:
streamWriteSizeInBytes
kleiner als 16 KB oder größer als 4 MB ist.
startCopy
public final String startCopy(final CloudAppendBlob sourceBlob)
Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Anfügeblobs in ein neues Anfügeblob zu beginnen.
Parameters:
CloudAppendBlob
-Objekt, das das zu kopierende Quellblob darstellt.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
startCopy
public final String startCopy(final CloudAppendBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Anfügeblobs unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts in ein neues Anfügeblob zu beginnen.
Parameters:
CloudAppendBlob
-Objekt, das das zu kopierende Quellblob darstellt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
upload
public void upload(final InputStream sourceStream, final long length)
Lädt die Quellstreamdaten in das Anfügeblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.
Wenn Sie Daten an ein bereits vorhandenes Blob anfügen möchten, lesen appendBlock(final InputStream sourceStream, final long length)Sie .
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
long
, der die Länge der Datenstromdaten in Bytes darstellt, oder -1, wenn unbekannt.
Throws:
upload
public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Lädt die Quellstreamdaten unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts in das Anfügeblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.
Wenn Sie Daten an ein bereits vorhandenes Blob anfügen möchten, lesen appendBlock(final InputStream sourceStream, final long length)Sie .
Wenn Sie Schreibvorgänge in einem einzelnen Writer-Szenario ausführen, überprüfen setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Sie, ob das Festlegen dieses Flags auf für Sie akzeptabel ist.
Parameters:
long
, der die Länge der Datenstromdaten in Bytes darstellt, oder -1, wenn unbekannt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
Gilt für:
Azure SDK for Java