BlobRequestOptions Classe
- java.
lang. Object - RequestOptions
- com.
microsoft. azure. storage. blob. BlobRequestOptions
- com.
public class BlobRequestOptions extends RequestOptions
Représente un ensemble d’options qui peuvent être spécifiées sur une demande.
Récapitulatif du constructeur
Constructeur | Description |
---|---|
BlobRequestOptions() |
Crée une instance de la classe. |
BlobRequestOptions(final BlobRequestOptions other) |
Crée une instance de la classe en copiant les valeurs d’un autre instance. |
Résumé de la méthode
Modificateur et type | Méthode et description |
---|---|
void |
applyDefaults(final BlobRequestOptions modifiedOptions, final BlobType blobtype)
Applique les valeurs par défaut aux options transmises. |
void |
assertNoEncryptionPolicyOrStrictMode()
Affirmez que si la validation est activée, aucune stratégie de chiffrement n’est spécifiée. |
void |
assertPolicyIfRequired()
Affirmez que si le mode strict est activé, une stratégie de chiffrement est spécifiée. |
Boolean |
getAbsorbConditionalErrorsOnRetry()
Indique si un échec conditionnel doit être absorbé lors d’une nouvelle tentative pour la demande. Pour plus d’informations sur l’absorption des erreurs conditinales sur les valeurs par défaut de nouvelle tentative, consultez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry). |
boolean |
getCommitWriteOnInputStreamException()
qui définit le comportement de gestion des exceptions lors de la lecture à partir de et à l’aide de . Si les données qui ont été lues à partir du flux jusqu’au point de l’exception seront vidées et qu’un nouvel objet blob sera validé avec ces données. Dans le cas contraire, le chargement sera abandonné et aucune donnée n’est validée. Pour plus d’informations sur les valeurs par défaut, consultez setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException). |
Integer |
getConcurrentRequestCount()
Obtient le nombre simultané de requêtes simultanées par opération. Pour plus d’informations sur les valeurs par défaut du nombre de requêtes simultanées, consultez setConcurrentRequestCount(final Integer concurrentRequestCount). |
Blob |
getCustomerProvidedKey()
Obtient la clé fournie par le client à utiliser pour cette demande. |
Boolean |
getDisableContentMD5Validation()
Obtient si le téléchargement et BlobInputStream les méthodes doivent ignorer l’en-tête ContentMD5 de l’objet blob. Pour plus d’informations sur la désactivation des valeurs par défaut de validation MD5 du contenu, consultez setDisableContentMD5Validation(final Boolean disableContentMD5Validation) |
Blob |
getEncryptionPolicy()
Obtient la stratégie de chiffrement à utiliser pour cette demande. Pour plus d’informations sur les valeurs par défaut de la stratégie de chiffrement, consultez setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy). |
Integer |
getSingleBlobPutThresholdInBytes()
Obtient la taille de seuil utilisée pour écrire un objet blob unique. Pour plus d’informations sur les valeurs par défaut de taille de seuil, consultez setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes). |
boolean |
getSkipEtagLocking()
AVERTISSEMENT : le verrouillage etag est automatiquement utilisé dans les téléchargements d’objets blob pour garantir que l’objet blob ne change pas à mi-téléchargement. Ignorez cette validation à vos propres risques. Obtient si le verrouillage et la validation d’etag sur les téléchargements d’objets blob doivent être ignorés. |
Boolean |
getStoreBlobContentMD5()
Obtient si l’en-tête ContentMD5 de l’objet blob doit être défini sur les chargements. Ce champ n’est pas pris en charge pour les objets blob de pages. Pour plus d’informations sur le stockage des valeurs par défaut MD5 du contenu d’objets blob, consultez setStoreBlobContentMD5(final Boolean storeBlobContentMD5) |
Boolean |
getUseTransactionalContentMD5()
Obtient si une opération PUT ou GET de plage utilise l’en-tête Content-MD5 pour appliquer la sécurité transactionnelle. Tous les téléchargements ou téléchargements d’objets blob partiels seront limités à 4 Mo. Pour plus d’informations sur les valeurs par défaut md5 du contenu transactionnel, consultez setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5). |
boolean |
getValidateEncryptionPolicy()
Obtient la clé fournie par le client à utiliser sur la source pour une demande de copie. |
final Blob |
populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client)
Utilise le nombre de requêtes simultanées à partir du client spécifié si , définit une valeur par défaut pour tout le reste et définit les valeurs par défaut telles que définies dans la classe parente. |
final Blob |
populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client, final boolean setStartTime)
Utilise le nombre de requêtes simultanées à partir du client spécifié si , définit une valeur par défaut pour tout le reste et définit les valeurs par défaut telles que définies dans la classe parente. |
void |
setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry)
Définit si un échec conditionnel doit être absorbé lors d’une nouvelle tentative pour la demande. Cette option n’est utilisée que par CloudAppendBlob dans les méthodes upload et openWrite. Par défaut, il est défini sur . Définissez cette valeur sur uniquement pour le scénario d’écriture unique. Vous pouvez modifier la valeur absorbConditionalErrorsOnRetry sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur sur l’objet getDefaultRequestOptions() afin que toutes les requêtes suivantes effectuées via le client de service utilisent cette valeur absorbConditionalErrorsOnRetry. |
void |
setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException)
qui définit le comportement de gestion des exceptions lors de la lecture à partir de et à l’aide de . Si les données qui ont été lues à partir du flux jusqu’au point de l’exception seront vidées et qu’un nouvel objet blob sera validé avec ces données. Dans le cas contraire, le chargement sera abandonné et aucune donnée n’est validée. La valeur par défaut est . |
void |
setConcurrentRequestCount(final Integer concurrentRequestCount)
Définit le nombre simultané de requêtes simultanées par opération. Le nombre de requêtes simultanées par défaut est défini dans le client et est par défaut 1, ce qui n’indique aucune concurrence. Vous pouvez modifier le nombre de requêtes simultanées sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur de l’objet getDefaultRequestOptions() afin que toutes les demandes ultérieures effectuées via le client de service utilisent ce nombre de requêtes simultanées. |
void |
setCustomerProvidedKey(BlobCustomerProvidedKey key)
Définit l’objet BlobCustomerProvidedKey à utiliser pour cette requête. Le chiffrement de clé fourni par le client est pris en charge pour la plupart des demandes de chargement, de téléchargement et de copie dans le stockage d’objets blob, ainsi que pour l’extraction des propriétés et des métadonnées. |
void |
setDisableContentMD5Validation(final Boolean disableContentMD5Validation)
Définit si le téléchargement et BlobInputStream les méthodes doivent ignorer l’en-tête ContentMD5 de l’objet blob. La valeur par défaut disableContentMD5Validation est définie dans le client et est par défaut . Vous pouvez modifier la valeur disableContentMD5Validation sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur de l’objet getDefaultRequestOptions() afin que toutes les requêtes suivantes effectuées via le client de service utilisent la valeur disableContentMD5Validation. |
void |
setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy)
Définit l’objet BlobEncryptionPolicy à utiliser pour cette requête. La valeur BlobEncryptionPolicy par défaut est définie dans le client et est null par défaut, ce qui indique qu’aucun chiffrement n’est indiqué. Vous pouvez modifier blobEncryptionPolicy sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur de l’objet getDefaultRequestOptions() afin que toutes les requêtes ultérieures effectuées via le client de service utilisent cette blobEncryptionPolicy. |
void |
setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes)
Définit la taille de seuil utilisée pour écrire un objet blob unique à utiliser. La taille de seuil par défaut est définie dans le client et est par défaut de 32 Mo. Vous pouvez modifier la taille du seuil de cette demande en définissant cette propriété. Vous pouvez également modifier la valeur sur l’objet getDefaultRequestOptions() afin que toutes les demandes ultérieures effectuées via le client de service utilisent cette taille de seuil. |
void |
setSkipEtagLocking(boolean skipEtagLocking)
AVERTISSEMENT : le verrouillage etag est automatiquement utilisé dans les téléchargements d’objets blob pour garantir que l’objet blob ne change pas à mi-téléchargement. Ignorez cette validation à vos propres risques. Définit si le verrouillage et la validation d’etag sur les téléchargements d’objets blob doivent être ignorés. |
void |
setStoreBlobContentMD5(final Boolean storeBlobContentMD5)
Définit si l’en-tête ContentMD5 de l’objet blob doit être défini sur les chargements. Ce champ n’est pas pris en charge pour les objets blob de pages. La valeur storeBlobContentMD5 par défaut est définie dans le client et est par défaut pour les objets blob de blocs. Vous pouvez modifier la valeur storeBlobContentMD5 sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur sur l’objet getDefaultRequestOptions() afin que toutes les requêtes ultérieures effectuées via le client de service utilisent cette valeur storeBlobContentMD5. |
void |
setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)
Définit si une opération PUT ou GET de plage utilisera l’en-tête Content-MD5 pour appliquer la sécurité transactionnelle. Tous les chargements ou téléchargements d’objets blob partiels seront limités à 4 Mo. La valeur par défaut useTransactionalContentMD5 est définie dans le client et est par défaut . Vous pouvez modifier la valeur useTransactionalContentMD5 sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur sur l’objet getDefaultRequestOptions() afin que toutes les requêtes ultérieures effectuées via le client de service utilisent cette valeur useTransactionalContentMD5. |
void |
setValidateEncryptionPolicy(boolean validateEncryptionPolicy)
Définit l’objet BlobCustomerProvidedKey à utiliser pour un objet blob source. Le chiffrement de clé fourni par le client est pris en charge pour la plupart des demandes de chargement, de téléchargement et de copie dans le stockage d’objets blob, ainsi que pour l’extraction des propriétés et des métadonnées. |
Membres hérités
Détails du constructeur
BlobRequestOptions
public BlobRequestOptions()
Crée une instance de la classe.
BlobRequestOptions
public BlobRequestOptions(final BlobRequestOptions other)
Crée une instance de la classe en copiant les valeurs d’un autre instance.
Paramètres:
Détails de la méthode
applyDefaults
protected static void applyDefaults(final BlobRequestOptions modifiedOptions, final BlobType blobtype)
Applique les valeurs par défaut aux options transmises.
Paramètres:
assertNoEncryptionPolicyOrStrictMode
protected void assertNoEncryptionPolicyOrStrictMode()
Affirmez que si la validation est activée, aucune stratégie de chiffrement n’est spécifiée.
assertPolicyIfRequired
protected void assertPolicyIfRequired()
Affirmez que si le mode strict est activé, une stratégie de chiffrement est spécifiée.
getAbsorbConditionalErrorsOnRetry
public Boolean getAbsorbConditionalErrorsOnRetry()
Indique si un échec conditionnel doit être absorbé lors d’une nouvelle tentative pour la demande. Pour plus d’informations sur l’absorption des erreurs conditinales sur les valeurs par défaut de nouvelle tentative, consultez setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry).
Retours:
getCommitWriteOnInputStreamException
public boolean getCommitWriteOnInputStreamException()
qui définit le comportement de gestion des exceptions lors de la lecture à partir de et à l’aide de . Si les données qui ont été lues à partir du flux jusqu’au point de l’exception seront vidées et qu’un nouvel objet blob sera validé avec ces données. Dans le cas contraire, le chargement sera abandonné et aucune donnée n’est validée.
Pour plus d’informations sur les valeurs par défaut, consultez setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException).
Retours:
true
si les données sont validées en cas d’exception ; sinon, false
.
getConcurrentRequestCount
public Integer getConcurrentRequestCount()
Obtient le nombre simultané de requêtes simultanées par opération. Pour plus d’informations sur les valeurs par défaut du nombre de requêtes simultanées, consultez setConcurrentRequestCount(final Integer concurrentRequestCount).
Retours:
getCustomerProvidedKey
public BlobCustomerProvidedKey getCustomerProvidedKey()
Obtient la clé fournie par le client à utiliser pour cette demande.
Retours:
getDisableContentMD5Validation
public Boolean getDisableContentMD5Validation()
Obtient si le téléchargement et BlobInputStream les méthodes doivent ignorer l’en-tête ContentMD5 de l’objet blob. Pour plus d’informations sur la désactivation des valeurs par défaut de validation MD5 du contenu, consultez setDisableContentMD5Validation(final Boolean disableContentMD5Validation)
Retours:
getEncryptionPolicy
public BlobEncryptionPolicy getEncryptionPolicy()
Obtient la stratégie de chiffrement à utiliser pour cette demande. Pour plus d’informations sur les valeurs par défaut de la stratégie de chiffrement, consultez setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy).
Retours:
getSingleBlobPutThresholdInBytes
public Integer getSingleBlobPutThresholdInBytes()
Obtient la taille de seuil utilisée pour écrire un objet blob unique. Pour plus d’informations sur les valeurs par défaut de taille de seuil, consultez setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes).
Retours:
getSkipEtagLocking
public boolean getSkipEtagLocking()
AVERTISSEMENT : le verrouillage etag est automatiquement utilisé dans les téléchargements d’objets blob pour garantir que l’objet blob ne change pas à mi-téléchargement. Ignorez cette validation à vos propres risques.
Obtient si le verrouillage et la validation d’etag sur les téléchargements d’objets blob doivent être ignorés.
Retours:
true
si le saut est activé ; sinon, false
.
getStoreBlobContentMD5
public Boolean getStoreBlobContentMD5()
Obtient si l’en-tête ContentMD5 de l’objet blob doit être défini sur les chargements. Ce champ n’est pas pris en charge pour les objets blob de pages. Pour plus d’informations sur le stockage des valeurs par défaut MD5 du contenu d’objets blob, consultez setStoreBlobContentMD5(final Boolean storeBlobContentMD5)
Retours:
getUseTransactionalContentMD5
public Boolean getUseTransactionalContentMD5()
Obtient si une opération PUT ou GET de plage utilise l’en-tête Content-MD5 pour appliquer la sécurité transactionnelle. Tous les téléchargements ou téléchargements d’objets blob partiels seront limités à 4 Mo. Pour plus d’informations sur les valeurs par défaut md5 du contenu transactionnel, consultez setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5).
Retours:
getValidateEncryptionPolicy
protected boolean getValidateEncryptionPolicy()
Obtient la clé fournie par le client à utiliser sur la source pour une demande de copie.
Retours:
populateAndApplyDefaults
protected static final BlobRequestOptions populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client)
Utilise le nombre de requêtes simultanées à partir du client spécifié si , définit une valeur par défaut pour tout le reste et définit les valeurs par défaut telles que définies dans la classe parente.
Paramètres:
null
de . En outre, la valeur par défaut de concurrentRequestCount est 1
.
populateAndApplyDefaults
protected static final BlobRequestOptions populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client, final boolean setStartTime)
Utilise le nombre de requêtes simultanées à partir du client spécifié si , définit une valeur par défaut pour tout le reste et définit les valeurs par défaut telles que définies dans la classe parente.
Paramètres:
null
de . En outre, la valeur par défaut de concurrentRequestCount est 1
.
setAbsorbConditionalErrorsOnRetry
public void setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry)
Définit si un échec conditionnel doit être absorbé lors d’une nouvelle tentative pour la demande. Cette option n’est utilisée que par CloudAppendBlob dans les méthodes upload et openWrite. Par défaut, il est défini sur . Définissez cette valeur sur uniquement pour le scénario d’écriture unique.
Vous pouvez modifier la valeur absorbConditionalErrorsOnRetry sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur sur l’objet getDefaultRequestOptions() afin que toutes les requêtes suivantes effectuées via le client de service utilisent cette valeur absorbConditionalErrorsOnRetry.
Paramètres:
setCommitWriteOnInputStreamException
public void setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException)
qui définit le comportement de gestion des exceptions lors de la lecture à partir de et à l’aide de . Si les données qui ont été lues à partir du flux jusqu’au point de l’exception seront vidées et qu’un nouvel objet blob sera validé avec ces données. Dans le cas contraire, le chargement sera abandonné et aucune donnée n’est validée.
La valeur par défaut est .
Paramètres:
true
si les données seront validées en cas d’exception ; sinon, false
.
setConcurrentRequestCount
public void setConcurrentRequestCount(final Integer concurrentRequestCount)
Définit le nombre simultané de requêtes simultanées par opération.
Le nombre de requêtes simultanées par défaut est défini dans le client et est par défaut 1, ce qui n’indique aucune concurrence. Vous pouvez modifier le nombre de requêtes simultanées sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur de l’objet getDefaultRequestOptions() afin que toutes les demandes ultérieures effectuées via le client de service utilisent ce nombre de requêtes simultanées.
Paramètres:
setCustomerProvidedKey
public void setCustomerProvidedKey(BlobCustomerProvidedKey key)
Définit l’objet BlobCustomerProvidedKey à utiliser pour cette requête. Le chiffrement de clé fourni par le client est pris en charge pour la plupart des demandes de chargement, de téléchargement et de copie dans le stockage d’objets blob, ainsi que pour l’extraction des propriétés et des métadonnées.
Paramètres:
setDisableContentMD5Validation
public void setDisableContentMD5Validation(final Boolean disableContentMD5Validation)
Définit si le téléchargement et BlobInputStream les méthodes doivent ignorer l’en-tête ContentMD5 de l’objet blob.
La valeur par défaut disableContentMD5Validation est définie dans le client et est par défaut . Vous pouvez modifier la valeur disableContentMD5Validation sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur de l’objet getDefaultRequestOptions() afin que toutes les requêtes suivantes effectuées via le client de service utilisent la valeur disableContentMD5Validation.
Paramètres:
setEncryptionPolicy
public void setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy)
Définit l’objet BlobEncryptionPolicy à utiliser pour cette requête.
La valeur BlobEncryptionPolicy par défaut est définie dans le client et est null par défaut, ce qui indique qu’aucun chiffrement n’est indiqué. Vous pouvez modifier blobEncryptionPolicy sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur de l’objet getDefaultRequestOptions() afin que toutes les requêtes ultérieures effectuées via le client de service utilisent cette blobEncryptionPolicy.
Paramètres:
setSingleBlobPutThresholdInBytes
public void setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes)
Définit la taille de seuil utilisée pour écrire un objet blob unique à utiliser.
La taille de seuil par défaut est définie dans le client et est par défaut de 32 Mo. Vous pouvez modifier la taille du seuil de cette demande en définissant cette propriété. Vous pouvez également modifier la valeur sur l’objet getDefaultRequestOptions() afin que toutes les demandes ultérieures effectuées via le client de service utilisent cette taille de seuil.
Paramètres:
Exception:
minimumReadSize
est inférieur à 1 Mo ou supérieur à 64 Mo.
setSkipEtagLocking
public void setSkipEtagLocking(boolean skipEtagLocking)
AVERTISSEMENT : le verrouillage etag est automatiquement utilisé dans les téléchargements d’objets blob pour garantir que l’objet blob ne change pas à mi-téléchargement. Ignorez cette validation à vos propres risques.
Définit si le verrouillage et la validation d’etag sur les téléchargements d’objets blob doivent être ignorés.
Paramètres:
true
pour ignorer le verrouillage et la validation d’etag ; sinon, false
.
setStoreBlobContentMD5
public void setStoreBlobContentMD5(final Boolean storeBlobContentMD5)
Définit si l’en-tête ContentMD5 de l’objet blob doit être défini sur les chargements. Ce champ n’est pas pris en charge pour les objets blob de pages.
La valeur storeBlobContentMD5 par défaut est définie dans le client et est par défaut pour les objets blob de blocs. Vous pouvez modifier la valeur storeBlobContentMD5 sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur sur l’objet getDefaultRequestOptions() afin que toutes les requêtes ultérieures effectuées via le client de service utilisent cette valeur storeBlobContentMD5.
Paramètres:
setUseTransactionalContentMD5
public void setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)
Définit si une opération PUT ou GET de plage utilisera l’en-tête Content-MD5 pour appliquer la sécurité transactionnelle. Tous les chargements ou téléchargements d’objets blob partiels seront limités à 4 Mo.
La valeur par défaut useTransactionalContentMD5 est définie dans le client et est par défaut . Vous pouvez modifier la valeur useTransactionalContentMD5 sur cette demande en définissant cette propriété. Vous pouvez également modifier la valeur sur l’objet getDefaultRequestOptions() afin que toutes les requêtes ultérieures effectuées via le client de service utilisent cette valeur useTransactionalContentMD5.
Paramètres:
setValidateEncryptionPolicy
protected void setValidateEncryptionPolicy(boolean validateEncryptionPolicy)
Définit l’objet BlobCustomerProvidedKey à utiliser pour un objet blob source. Le chiffrement de clé fourni par le client est pris en charge pour la plupart des demandes de chargement, de téléchargement et de copie dans le stockage d’objets blob, ainsi que pour l’extraction des propriétés et des métadonnées.
Paramètres:
true
pour exiger la validation ; sinon, false
.
S’applique à
Azure SDK for Java