Partager via


CloudAppendBlob Classe

public class CloudAppendBlob extends CloudBlob

Représente un objet blob d’ajout Microsoft Azure.

Récapitulatif du constructeur

Constructeur Description
CloudAppendBlob(final CloudAppendBlob otherBlob)

Crée un instance de la classe en copiant les valeurs d’un autre objet blob d’ajout.

CloudAppendBlob(final StorageUri blobAbsoluteUri)

Crée un instance de la classe à l’aide de l’URI absolu et du client de service de stockage spécifiés.

CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

Crée une instance de la classe à l’aide des informations d’identification Et StorageUri absolues spécifiées.

CloudAppendBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Crée un instance de la classe à l’aide de l’absolu StorageUri, de l’ID de instantané et des informations d’identification spécifiés.

CloudAppendBlob(final URI blobAbsoluteUri)

Crée un instance de la classe à l’aide de l’URI absolu et du client de service de stockage spécifiés.

CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

Crée une instance de la classe à l’aide de l’URI absolu et des informations d’identification spécifiées.

CloudAppendBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Crée un instance de la classe à l’aide de l’URI absolu, de l’ID de instantané et des informations d’identification spécifiés.

CloudAppendBlob(String blobName, String snapshotID, CloudBlobContainer container)

Crée une instance de la classe à l’aide du type, du nom, de l’ID instantané et du conteneur spécifiés.

Résumé de la méthode

Modificateur et type Méthode et description
void append(InputStream sourceStream, final long length)

Ajoute un flux à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void append(InputStream sourceStream, final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute un flux à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Long appendBlock(final InputStream sourceStream, final long length)

Valide un nouveau bloc de données à la fin de l’objet blob.

Long appendBlock(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Valide un nouveau bloc de données à la fin de l’objet blob.

Long appendBlockFromURI(final URI copySource, final Long offset, final Long length)

Ajoute un bloc à l’aide de l’URL source spécifiée.

Long appendBlockFromURI(final URI copySource, final Long offset, final Long length, String md5, final AccessCondition accessCondition, final AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute un bloc à l’aide de l’URL source spécifiée.

void appendFromByteArray(final byte[] buffer, final int offset, final int length)

Ajoute le contenu d’un tableau d’octets à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void appendFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute le contenu d’un tableau d’octets à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void appendFromFile(final String path)

Ajoute un fichier à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void appendFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute un fichier à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void appendText(final String content)

Ajoute une chaîne de texte à un objet blob d’ajout à l’aide de l’encodage par défaut de la plateforme. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void appendText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute une chaîne de texte à un objet blob d’ajout à l’aide de l’encodage spécifié. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs en double qui ne fonctionnent pas dans un scénario de plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void createOrReplace()

Crée un objet blob d’ajout vide. Si l’objet blob existe déjà, cela le remplacera.

Pour éviter le remplacement et générer à la place une erreur, utilisez la createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) surcharge avec le approprié AccessCondition.

void createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Crée un objet blob d’ajout à l’aide des options de requête et du contexte d’opération spécifiés. Si l’objet blob existe déjà, cela le remplacera.

Pour éviter le remplacement et générer une erreur, transmettez un AccessCondition généré à l’aide generateIfNotExistsCondition()de .

BlobOutputStream openWriteExisting()

Ouvre un objet de flux de sortie pour écrire des données dans l’objet blob d’ajout. L’objet blob d’ajout doit déjà exister et sera ajouté à.

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ouvre un objet de flux de sortie pour écrire des données dans l’objet blob d’ajout, à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. L’objet blob d’ajout doit déjà exister et sera ajouté à.

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

BlobOutputStream openWriteNew()

Ouvre un objet de flux de sortie pour écrire des données dans l’objet blob d’ajout. L’objet blob d’ajout n’a pas besoin d’exister. Si l’objet blob existe déjà, cela le remplacera.

Pour éviter le remplacement et générer à la place une erreur, utilisez la openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) surcharge avec le approprié AccessCondition.

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

BlobOutputStream openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ouvre un objet de flux de sortie pour écrire des données dans l’objet blob d’ajout, à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. L’objet blob d’ajout n’a pas besoin d’exister. Si l’objet blob existe déjà, cela le remplacera.

Pour éviter le remplacement et générer une erreur, transmettez un AccessCondition généré à l’aide generateIfNotExistsCondition()de .

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

Définit le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un BlobOutputStream.

final String startCopy(final CloudAppendBlob sourceBlob)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un objet blob d’ajout vers un nouvel objet blob d’ajout.

final String startCopy(final CloudAppendBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un objet blob d’ajout vers un nouvel objet blob d’ajout, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.

void upload(final InputStream sourceStream, final long length)

Charge les données de flux source dans l’objet blob d’ajout. Si l’objet blob existe déjà sur le service, il est remplacé.

Si vous souhaitez ajouter des données à un objet blob déjà existant, consultez appendBlock(final InputStream sourceStream, final long length).

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge les données de flux source dans l’objet blob d’ajout à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. Si l’objet blob existe déjà sur le service, il est remplacé.

Si vous souhaitez ajouter des données à un objet blob déjà existant, consultez appendBlock(final InputStream sourceStream, final long length).

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Membres hérités

CloudBlob.abortCopy(final String copyId) CloudBlob.abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.acquireLease() CloudBlob.acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) CloudBlob.acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.assertCorrectBlobType() CloudBlob.assertNoWriteOperationForSnapshot() CloudBlob.blobServiceClient CloudBlob.breakLease(final Integer breakPeriodInSeconds) CloudBlob.breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.changeLease(final String proposedLeaseId, final AccessCondition accessCondition) CloudBlob.changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container) CloudBlob.CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials) CloudBlob.CloudBlob(final CloudBlob otherBlob) CloudBlob.createSnapshot() CloudBlob.createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.delete() CloudBlob.delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.deleteIfExists() CloudBlob.deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.download(final OutputStream outStream) CloudBlob.download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadAccountInfo() CloudBlob.downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadAccountInformationImpl(final RequestOptions options) CloudBlob.downloadAttributes() CloudBlob.downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRange(final long offset, final Long length, final OutputStream outStream) CloudBlob.downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset) CloudBlob.downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadToByteArray(final byte[] buffer, final int bufferOffset) CloudBlob.downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadToFile(final String path) CloudBlob.downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.exists() CloudBlob.exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding) CloudBlob.generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy) CloudBlob.generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols) CloudBlob.getContainer() CloudBlob.getCopyState() CloudBlob.getMetadata() CloudBlob.getName() CloudBlob.getParent() CloudBlob.getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container) CloudBlob.getProperties() CloudBlob.getQualifiedStorageUri() CloudBlob.getQualifiedUri() CloudBlob.getServiceClient() CloudBlob.getSnapshotID() CloudBlob.getSnapshotQualifiedStorageUri() CloudBlob.getSnapshotQualifiedUri() CloudBlob.getStorageUri() CloudBlob.getStreamMinimumReadSizeInBytes() CloudBlob.getStreamWriteSizeInBytes() CloudBlob.getTransformedAddress(final OperationContext opContext) CloudBlob.getUri() CloudBlob.isSnapshot() CloudBlob.openInputStream() CloudBlob.openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.parent CloudBlob.releaseLease(final AccessCondition accessCondition) CloudBlob.releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.renewLease(final AccessCondition accessCondition) CloudBlob.renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.setContainer(final CloudBlobContainer container) CloudBlob.setMetadata(final HashMap<String, String> metadata) CloudBlob.setProperties(final BlobProperties properties) CloudBlob.setSnapshotID(final String snapshotID) CloudBlob.setStorageUri(final StorageUri storageUri) CloudBlob.setStreamMinimumReadSizeInBytes(final int minimumReadSize) CloudBlob.startCopy(final URI source) CloudBlob.startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options) CloudBlob.streamMinimumReadSizeInBytes CloudBlob.streamWriteSizeInBytes CloudBlob.undelete() CloudBlob.undelete(BlobRequestOptions options, OperationContext opContext) CloudBlob.updateEtagAndLastModifiedFromResponse(HttpURLConnection request) CloudBlob.updateLengthFromResponse(HttpURLConnection request) CloudBlob.uploadFromByteArray(final byte[] buffer, final int offset, final int length) CloudBlob.uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadFromFile(final String path) CloudBlob.uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadMetadata() CloudBlob.uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadProperties() CloudBlob.uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload)

Détails du constructeur

CloudAppendBlob

public CloudAppendBlob(final CloudAppendBlob otherBlob)

Crée un instance de la classe en copiant les valeurs d’un autre objet blob d’ajout.

Parameters:

otherBlob - Objet CloudAppendBlob qui représente l’objet blob d’ajout à copier.

CloudAppendBlob

public CloudAppendBlob(final StorageUri blobAbsoluteUri)

Crée un instance de la classe à l’aide de l’URI absolu et du client de service de stockage spécifiés.

Parameters:

blobAbsoluteUri - Objet StorageUri qui représente l’URI absolu de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

CloudAppendBlob

public CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

Crée une instance de la classe à l’aide des informations d’identification Et StorageUri absolues spécifiées.

Parameters:

blobAbsoluteUri - Objet StorageUri qui représente l’URI absolu de l’objet blob.
credentials - Objet StorageCredentials utilisé pour authentifier l’accès.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

CloudAppendBlob

public CloudAppendBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Crée un instance de la classe à l’aide de l’absolu StorageUri, de l’ID de instantané et des informations d’identification spécifiés.

Parameters:

blobAbsoluteUri - Objet StorageUri qui représente l’URI absolu de l’objet blob.
snapshotID - String qui représente la version instantané, le cas échéant.
credentials - Objet StorageCredentials utilisé pour authentifier l’accès.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

CloudAppendBlob

public CloudAppendBlob(final URI blobAbsoluteUri)

Crée un instance de la classe à l’aide de l’URI absolu et du client de service de stockage spécifiés.

Parameters:

blobAbsoluteUri - Objet java.net.URI qui représente l’URI absolu de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

CloudAppendBlob

public CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

Crée une instance de la classe à l’aide de l’URI absolu et des informations d’identification spécifiées.

Parameters:

blobAbsoluteUri - Objet java.net.URI qui représente l’URI absolu de l’objet blob.
credentials - Objet StorageCredentials utilisé pour authentifier l’accès.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

CloudAppendBlob

public CloudAppendBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Crée un instance de la classe à l’aide de l’URI absolu, de l’ID de instantané et des informations d’identification spécifiés.

Parameters:

blobAbsoluteUri - Objet java.net.URI qui représente l’URI absolu de l’objet blob.
snapshotID - String qui représente la version instantané, le cas échéant.
credentials - Objet StorageCredentials utilisé pour authentifier l’accès.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

CloudAppendBlob

protected CloudAppendBlob(String blobName, String snapshotID, CloudBlobContainer container)

Crée une instance de la classe à l’aide du type, du nom, de l’ID instantané et du conteneur spécifiés.

Parameters:

blobName - Le nom de l’objet Blob.
snapshotID - String qui représente la version instantané, le cas échéant.
container - Référence au conteneur parent.

Throws:

URISyntaxException - Si l’URI de ressource n’est pas valide.

Détails de la méthode

append

public void append(InputStream sourceStream, final long length)

Ajoute un flux à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

sourceStream - Objet InputStream fournissant le contenu d’objet blob à ajouter.
length - long qui représente la longueur, en octets, des données de flux ou -1 si elle est inconnue.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException - Si une exception d’E/S s’est produite.

append

public void append(InputStream sourceStream, final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute un flux à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

sourceStream - Objet InputStream fournissant le contenu d’objet blob à ajouter.
length - long qui représente la longueur, en octets, des données de flux ou -1 si elle est inconnue.
accessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException - Si une exception d’E/S s’est produite.

appendBlock

public Long appendBlock(final InputStream sourceStream, final long length)

Valide un nouveau bloc de données à la fin de l’objet blob.

Parameters:

sourceStream - Objet InputStream qui représente le flux d’entrée à écrire dans l’objet blob d’ajout.
length - long qui représente la longueur, en octets, des données de flux ou -1 si elle est inconnue.

Returns:

Décalage auquel le bloc a été ajouté.

Throws:

IOException - Si une exception d’E/S s’est produite.
StorageException - Si une erreur de service de stockage s’est produite.

appendBlock

public Long appendBlock(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Valide un nouveau bloc de données à la fin de l’objet blob.

Parameters:

sourceStream - Objet InputStream qui représente le flux d’entrée à écrire dans l’objet blob Append.
length - long qui représente la longueur, en octets, des données de flux ou -1 si elle est inconnue.
accessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Décalage auquel le bloc a été ajouté.

Throws:

IOException - Si une exception d’E/S s’est produite.
StorageException - Si une erreur de service de stockage s’est produite.

appendBlockFromURI

public Long appendBlockFromURI(final URI copySource, final Long offset, final Long length)

Ajoute un bloc à l’aide de l’URL source spécifiée.

Parameters:

copySource - de URI la source de données. Il peut pointer vers n’importe quel objet blob ou fichier Azure qui est public ou l’URL peut inclure une signature d’accès partagé.
offset - long qui représente le décalage à utiliser comme point de départ de la source.
length - Long qui représente le nombre d’octets à copier ou null à copier jusqu’à la fin de l’objet blob.

Returns:

Décalage auquel le bloc a été ajouté.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

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)

Ajoute un bloc à l’aide de l’URL source spécifiée.

Parameters:

copySource - de URI la source de données. Il peut pointer vers n’importe quel objet blob ou fichier Azure qui est public ou l’URL peut inclure une signature d’accès partagé.
offset - long qui représente le décalage à utiliser comme point de départ de la source.
length - Long qui représente le nombre d’octets à copier ou null à copier jusqu’à la fin de l’objet blob.
md5 - String qui représente le MD5 caluclaté pour la plage d’octets de la source.
accessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob.
sourceAccessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob source.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Décalage auquel le bloc a été ajouté.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

appendFromByteArray

public void appendFromByteArray(final byte[] buffer, final int offset, final int length)

Ajoute le contenu d’un tableau d’octets à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

buffer - Tableau byte qui représente les données à ajouter à l’objet blob.
offset - int qui représente le décalage du tableau d’octets à partir duquel démarrer le chargement des données.
length - int qui représente le nombre d’octets à charger à partir de la mémoire tampon d’entrée.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException - Si une exception d’E/S s’est produite.

appendFromByteArray

public void appendFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute le contenu d’un tableau d’octets à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

buffer - Tableau byte qui représente les données à ajouter à l’objet blob.
offset - int qui représente le décalage du tableau d’octets à partir duquel démarrer le chargement des données.
length - int qui représente le nombre d’octets à charger à partir de la mémoire tampon d’entrée.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException - Si une exception d’E/S s’est produite.

appendFromFile

public void appendFromFile(final String path)

Ajoute un fichier à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

path - String qui représente le chemin d’accès au fichier à ajouter.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException - Si une exception d’E/S s’est produite.

appendFromFile

public void appendFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute un fichier à un objet blob d’ajout. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

path - String qui représente le chemin d’accès au fichier à ajouter.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException - Si une exception d’E/S s’est produite.

appendText

public void appendText(final String content)

Ajoute une chaîne de texte à un objet blob d’ajout à l’aide de l’encodage par défaut de la plateforme. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs dupliqués qui ne fonctionnent pas dans un scénario à plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) unique, examinez et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

content - String qui représente le contenu qui sera ajouté à l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException - Si une exception d’E/S s’est produite.

appendText

public void appendText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ajoute une chaîne de texte à un objet blob d’ajout à l’aide de l’encodage spécifié. Cette API doit être utilisée strictement dans un scénario d’écriture unique, car l’API utilise en interne l’en-tête conditionnel append-offset pour éviter les blocs en double qui ne fonctionnent pas dans un scénario de plusieurs enregistreurs.

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

content - String qui représente le contenu qui sera ajouté à l’objet blob.
charsetName - String qui représente le nom de l’ensemble de caractères à utiliser pour encoder le contenu. Si la valeur est null, l’encodage par défaut de la plateforme est utilisé.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException - Si une exception d’E/S s’est produite.

createOrReplace

public void createOrReplace()

Crée un objet blob d’ajout vide. Si l’objet blob existe déjà, cela le remplacera.

Pour éviter le remplacement et générer à la place une erreur, utilisez la createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) surcharge avec le approprié AccessCondition.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

createOrReplace

public void createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Crée un objet blob d’ajout à l’aide des options de requête et du contexte d’opération spécifiés. Si l’objet blob existe déjà, cela le remplacera.

Pour éviter le remplacement et générer une erreur, transmettez un AccessCondition généré à l’aide generateIfNotExistsCondition()de .

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

openWriteExisting

public BlobOutputStream openWriteExisting()

Ouvre un objet de flux de sortie pour écrire des données dans l’objet blob d’ajout. L’objet blob d’ajout doit déjà exister et sera ajouté à.

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Returns:

Objet BlobOutputStream utilisé pour écrire des données dans l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

openWriteExisting

public BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ouvre un objet de flux de sortie pour écrire des données dans l’objet blob d’ajout, à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. L’objet blob d’ajout doit déjà exister et sera ajouté à.

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Objet BlobOutputStream utilisé pour écrire des données dans l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

openWriteNew

public BlobOutputStream openWriteNew()

Ouvre un objet de flux de sortie pour écrire des données dans l’objet blob d’ajout. L’objet blob d’ajout n’a pas besoin d’exister. Si l’objet blob existe déjà, cela le remplacera.

Pour éviter le remplacement et générer à la place une erreur, utilisez la openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) surcharge avec le approprié AccessCondition.

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Returns:

Objet BlobOutputStream utilisé pour écrire des données dans l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

openWriteNew

public BlobOutputStream openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ouvre un objet de flux de sortie pour écrire des données dans l’objet blob d’ajout, à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. L’objet blob d’ajout n’a pas besoin d’exister. Si l’objet blob existe déjà, cela le remplacera.

Pour éviter le remplacement et générer une erreur, transmettez un AccessCondition généré à l’aide generateIfNotExistsCondition()de .

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Objet BlobOutputStream utilisé pour écrire des données dans l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

setStreamWriteSizeInBytes

public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

Définit le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un BlobOutputStream.

Parameters:

streamWriteSizeInBytes - int qui représente la taille de bloc maximale, en octets, pour l’écriture dans un objet blob d’ajout lors de l’utilisation d’un BlobOutputStream objet, allant de 16 Ko à 4 Mo inclus.

Throws:

IllegalArgumentException - Si streamWriteSizeInBytes est inférieur à 16 Ko ou supérieur à 4 Mo.

startCopy

public final String startCopy(final CloudAppendBlob sourceBlob)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un objet blob d’ajout vers un nouvel objet blob d’ajout.

Parameters:

sourceBlob - Objet CloudAppendBlob qui représente l’objet blob source à copier.

Returns:

String qui représente l’ID de copie associé à l’opération de copie.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException

startCopy

public final String startCopy(final CloudAppendBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un objet blob d’ajout vers un nouvel objet blob d’ajout, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.

Parameters:

sourceBlob - Objet CloudAppendBlob qui représente l’objet blob source à copier.
sourceAccessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob source.
destinationAccessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob de destination.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

String qui représente l’ID de copie associé à l’opération de copie.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException

upload

public void upload(final InputStream sourceStream, final long length)

Charge les données de flux source dans l’objet blob d’ajout. Si l’objet blob existe déjà sur le service, il est remplacé.

Si vous souhaitez ajouter des données à un objet blob déjà existant, consultez appendBlock(final InputStream sourceStream, final long length).

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

sourceStream - Objet InputStream à lire.
length - long qui représente la longueur, en octets, des données de flux, ou -1 si elle est inconnue.

Throws:

IOException - Si une exception d’E/S s’est produite.
StorageException - Si une erreur de service de stockage s’est produite.

upload

public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge les données de flux source dans l’objet blob d’ajout à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. Si l’objet blob existe déjà sur le service, il est remplacé.

Si vous souhaitez ajouter des données à un objet blob déjà existant, consultez appendBlock(final InputStream sourceStream, final long length).

Si vous effectuez des écritures dans un scénario d’écriture unique, examinez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) et vérifiez si la définition de cet indicateur sur est acceptable pour vous.

Parameters:

sourceStream - Objet InputStream à lire.
length - long qui représente la longueur, en octets, des données de flux, ou -1 si elle est inconnue.
accessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

IOException - Si une exception d’E/S s’est produite.
StorageException - Si une erreur de service de stockage s’est produite.

S’applique à