AppendBlobClient Klasse

@Deprecated
public static final int MAX_APPEND_BLOCK_BYTES

Als veraltet markiert

Gibt die maximale Anzahl von Bytes an, die in einem Aufruf von appendBlock gesendet werden können.

@Deprecated
public static final int MAX_BLOCKS

Als veraltet markiert

Gibt die maximale Anzahl von Blöcken an, die in einem Anfügeblob zulässig sind.

public AppendBlobItem appendBlock(InputStream data, long length)

Committent einen neuen Datenblock an das Ende des vorhandenen Anfügeblobs.

Beachten Sie, dass die übergebenen Daten wiedergegeben werden müssen, wenn Wiederholungsversuche aktiviert sind (Standard). Anders ausgedrückt: Die Flux muss bei jedem Abonnieren die gleichen Daten erzeugen. Für Dienstversionen 2022-11-02 und höher beträgt die maximale Blockgröße 100 MB. Bei früheren Versionen beträgt die maximale Blockgröße 4 MB. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlock(data, length).getBlobCommittedBlockCount());

Parameter:

Gibt zurück:

public AppendBlobItem appendBlockFromUrl(String sourceUrl, BlobRange sourceRange)

Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.

Codebeispiele

System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlockFromUrl(sourceUrl, new BlobRange(offset, count)).getBlobCommittedBlockCount());

Parameter:

Gibt zurück:

public Response appendBlockFromUrlWithResponse(AppendBlobAppendBlockFromUrlOptions options, Duration timeout, Context context)

Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.

Codebeispiele

AppendBlobRequestConditions appendBlobRequestConditions = new AppendBlobRequestConditions()
     .setAppendPosition(POSITION)
     .setMaxSize(maxSize);

 BlobRequestConditions modifiedRequestConditions = new BlobRequestConditions()
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));

 Context context = new Context("key", "value");

 System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlockFromUrlWithResponse(new AppendBlobAppendBlockFromUrlOptions(sourceUrl)
         .setSourceRange(new BlobRange(offset, count))
         .setDestinationRequestConditions(appendBlobRequestConditions)
         .setSourceRequestConditions(modifiedRequestConditions), timeout,
         context).getValue().getBlobCommittedBlockCount());

Parameter:

Gibt zurück:

public Response appendBlockFromUrlWithResponse(String sourceUrl, BlobRange sourceRange, byte[] sourceContentMd5, AppendBlobRequestConditions destRequestConditions, BlobRequestConditions sourceRequestConditions, Duration timeout, Context context)

Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.

Codebeispiele

AppendBlobRequestConditions appendBlobRequestConditions = new AppendBlobRequestConditions()
     .setAppendPosition(POSITION)
     .setMaxSize(maxSize);

 BlobRequestConditions modifiedRequestConditions = new BlobRequestConditions()
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));

 Context context = new Context("key", "value");

 System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlockFromUrlWithResponse(sourceUrl, new BlobRange(offset, count), null,
         appendBlobRequestConditions, modifiedRequestConditions, timeout,
         context).getValue().getBlobCommittedBlockCount());

Parameter:

Gibt zurück:

public Response appendBlockWithResponse(InputStream data, long length, byte[] contentMd5, AppendBlobRequestConditions appendBlobRequestConditions, Duration timeout, Context context)

Committent einen neuen Datenblock an das Ende des vorhandenen Anfügeblobs.

Beachten Sie, dass die übergebenen Daten wiedergegeben werden müssen, wenn Wiederholungsversuche aktiviert sind (Standard). Anders ausgedrückt: Die Flux muss bei jedem Abonnieren die gleichen Daten erzeugen. Für Dienstversionen 2022-11-02 und höher beträgt die maximale Blockgröße 100 MB. Bei früheren Versionen beträgt die maximale Blockgröße 4 MB. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

byte[] md5 = MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8));
 AppendBlobRequestConditions requestConditions = new AppendBlobRequestConditions()
     .setAppendPosition(POSITION)
     .setMaxSize(maxSize);
 Context context = new Context("key", "value");

 System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlockWithResponse(data, length, md5, requestConditions, timeout, context)
         .getValue().getBlobCommittedBlockCount());

Parameter:

Gibt zurück:

public AppendBlobItem create()

Erstellt ein Anfügeblob mit einer Länge von 0 Länge. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen. Standardmäßig überschreibt diese Methode kein vorhandenes Blob.

Codebeispiele

System.out.printf("Created AppendBlob at %s%n", client.create().getLastModified());

Gibt zurück:

public AppendBlobItem create(boolean overwrite)

Erstellt ein Anfügeblob mit einer Länge von 0 Länge. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Codebeispiele

boolean overwrite = false; // Default value
 System.out.printf("Created AppendBlob at %s%n", client.create(overwrite).getLastModified());

Parameter:

Gibt zurück:

public AppendBlobItem createIfNotExists()

Erstellt ein Anfügeblob mit einer Länge von 0 Länge, wenn es nicht vorhanden ist. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Codebeispiele

client.createIfNotExists();
 System.out.println("Created AppendBlob");

Gibt zurück:

public Response createIfNotExistsWithResponse(AppendBlobCreateOptions options, Duration timeout, Context context)

Erstellt ein Anfügeblob mit einer Länge von 0 Länge, wenn es nicht vorhanden ist. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Codebeispiele

BlobHttpHeaders headers = new BlobHttpHeaders()
     .setContentType("binary")
     .setContentLanguage("en-US");
 Map<String, String> metadata = Collections.singletonMap("metadata", "value");
 Map<String, String> tags = Collections.singletonMap("tags", "value");
 Context context = new Context("key", "value");

 Response<AppendBlobItem> response = client.createIfNotExistsWithResponse(new AppendBlobCreateOptions()
     .setHeaders(headers).setMetadata(metadata).setTags(tags), timeout, context);
 if (response.getStatusCode() == 409) {
     System.out.println("Already existed.");
 } else {
     System.out.printf("Create completed with status %d%n", response.getStatusCode());
 }

Parameter:

Gibt zurück:

public Response createWithResponse(BlobHttpHeaders headers, Map metadata, BlobRequestConditions requestConditions, Duration timeout, Context context)

Erstellt ein Anfügeblob mit einer Länge von 0 Länge. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Um ein Überschreiben zu vermeiden, übergeben Sie "*" an setIfNoneMatch(String ifNoneMatch).

Codebeispiele

BlobHttpHeaders headers = new BlobHttpHeaders()
     .setContentType("binary")
     .setContentLanguage("en-US");
 Map<String, String> metadata = Collections.singletonMap("metadata", "value");
 BlobRequestConditions requestConditions = new BlobRequestConditions()
     .setLeaseId(leaseId)
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
 Context context = new Context("key", "value");

 System.out.printf("Created AppendBlob at %s%n",
     client.createWithResponse(headers, metadata, requestConditions, timeout, context).getValue()
         .getLastModified());

Parameter:

Gibt zurück:

public Response createWithResponse(AppendBlobCreateOptions options, Duration timeout, Context context)

Erstellt ein Anfügeblob mit einer Länge von 0 Länge. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Um ein Überschreiben zu vermeiden, übergeben Sie "*" an setIfNoneMatch(String ifNoneMatch).

Codebeispiele

BlobHttpHeaders headers = new BlobHttpHeaders()
     .setContentType("binary")
     .setContentLanguage("en-US");
 Map<String, String> metadata = Collections.singletonMap("metadata", "value");
 Map<String, String> tags = Collections.singletonMap("tags", "value");
 BlobRequestConditions requestConditions = new BlobRequestConditions()
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
 Context context = new Context("key", "value");

 System.out.printf("Created AppendBlob at %s%n",
     client.createWithResponse(new AppendBlobCreateOptions().setHeaders(headers).setMetadata(metadata)
         .setTags(tags).setRequestConditions(requestConditions), timeout, context).getValue()
         .getLastModified());

Parameter:

Gibt zurück:

public BlobOutputStream getBlobOutputStream()

Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben. Wenn das Blob bereits im Dienst vorhanden ist, werden neue Daten an das vorhandene Blob angefügt.

Gibt zurück:

public BlobOutputStream getBlobOutputStream(boolean overwrite)

Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben. Wenn überschreiben angegeben truewird, wird das vorhandene Blob gelöscht und neu erstellt, falls Daten im Blob vorhanden sind. Wenn überschreiben angegeben falseist, werden neue Daten an das vorhandene Blob angefügt.

Parameter:

Gibt zurück:

public BlobOutputStream getBlobOutputStream(AppendBlobRequestConditions requestConditions)

Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben.

Parameter:

Gibt zurück:

public AppendBlobClient getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)

Erstellt einen neuen AppendBlobClient mit dem angegebenen customerProvidedKey.

Überschreibt:

Parameter:

Gibt zurück:

public AppendBlobClient getEncryptionScopeClient(String encryptionScope)

Erstellt einen neuen AppendBlobClient mit dem angegebenen encryptionScope.

Überschreibt:

Parameter:

Gibt zurück:

public int getMaxAppendBlockBytes()

Rufen Sie die maximale Anzahl von Anfügeblockbytes basierend auf der verwendeten Dienstversion ab. Die Dienstversionen 2022-11-02 und höher unterstützen das Hochladen von Blockbytes bis zu 100 MB, alle älteren Dienstversionen unterstützen bis zu 4 MB.

Gibt zurück:

public int getMaxBlocks()

Rufen Sie die maximale Anzahl von Blöcken ab, die in einem Anfügeblob zulässig sind.

Gibt zurück:

public void seal()

Versiegelt ein Anfügeblob, sodass es schreibgeschützt ist. Bei nachfolgenden Anfügevorgängen tritt ein Fehler auf.

Codebeispiele

client.seal();
 System.out.println("Sealed AppendBlob");

public Response sealWithResponse(AppendBlobSealOptions options, Duration timeout, Context context)

Versiegelt ein Anfügeblob, sodass es schreibgeschützt ist. Bei nachfolgenden Anfügevorgängen tritt ein Fehler auf.

Codebeispiele

AppendBlobRequestConditions requestConditions = new AppendBlobRequestConditions().setLeaseId(leaseId)
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
 Context context = new Context("key", "value");

 client.sealWithResponse(new AppendBlobSealOptions().setRequestConditions(requestConditions), timeout, context);
 System.out.println("Sealed AppendBlob");

Parameter:

Gibt zurück: