RequestOptions Classe
- java.
lang. Object - com.
microsoft. azure. storage. RequestOptions
- com.
public class RequestOptions
Représente les options à utiliser lors du traitement d’une demande donnée.
Récapitulatif du constructeur
Constructeur | Description |
---|---|
RequestOptions() |
Crée une instance de la classe. |
RequestOptions(final RequestOptions 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 |
applyBaseDefaultsInternal(final RequestOptions modifiedOptions)
Remplit le délai d’expiration, la stratégie de nouvelle tentative et le mode d’emplacement par défaut à partir du client s’ils sont null. |
Boolean |
disableHttpsSocketKeepAlive()
Obtient une valeur pour indiquer si la conservation du socket https doit être désactivée. Utiliser pour désactiver keep-alive ; Sinon. Pour plus d’informations sur disableHttpsSocketKeepAlive defaults, consultez getDefaultRequestOptions() |
final Location |
getLocationMode()
Obtient le mode d’emplacement par défaut pour cette requête. Pour plus d’informations sur le mode d’emplacement, consultez setLocationMode(final LocationMode locationMode). |
Integer |
getMaximumExecutionTimeInMs()
Obtient la durée d’exécution maximale de cette requête. Pour plus d’informations sur les valeurs par défaut du temps d’exécution maximal, consultez setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs). |
Long |
getOperationExpiryTimeInMs()
RÉSERVÉ À UN USAGE INTERNE. Retourne l’heure à laquelle cette opération expire. Cette valeur est calculée en ajoutant l’heure de début de l’opération et la durée d’exécution maximale et sera null si la durée d’exécution maximale est null. Pour plus d’informations sur le temps d’exécution maximal, consultez setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs). |
final Retry |
getRetryPolicyFactory()
Obtient la stratégie de nouvelle tentative à utiliser pour cette demande. Pour plus d’informations sur les valeurs par défaut de la stratégie de nouvelle tentative, consultez setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory). |
final Integer |
getTimeoutIntervalInMs()
Retourne la valeur de délai d’expiration pour cette demande. Pour plus d’informations sur les valeurs par défaut du délai d’expiration, consultez setTimeoutIntervalInMs(final Integer timeoutIntervalInMs). |
void |
populateRequestOptions(RequestOptions modifiedOptions, final RequestOptions clientOptions, final boolean setStartTime)
Remplit les champs Null du premier objet requestOptions avec les valeurs du deuxième objet requestOptions. |
Boolean |
requireEncryption()
Obtient une valeur pour indiquer si toutes les données écrites et lues doivent être chiffrées. Utiliser pour chiffrer/déchiffrer des données pour les transactions ; Sinon. Pour plus d’informations sur exiger des valeurs de chiffrement par défaut, consultez setRequireEncryption(Boolean requireEncryption). |
void |
setDisableHttpsSocketKeepAlive(Boolean disableHttpsSocketKeepAlive)
Définit une valeur pour indiquer si la conservation du socket https doit être désactivée. Utiliser pour désactiver keep-alive ; Sinon La valeur par défaut est définie dans le client et est par défaut true, ce qui indique que la conservation du socket https sera désactivée. Vous pouvez modifier la valeur de 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 la valeur appropriée. La définition de keep-alive sur les sockets https consiste à contourner un bogue dans la machine virtuelle JVM où les délais d’expiration de connexion ne sont pas respectés sur les demandes retentées. Dans ce cas, vous pouvez choisir d’utiliser socket keep-alive comme secours. Malheureusement, la valeur du délai d’expiration doit être extraite d’une propriété JVM plutôt que configurée localement. Par conséquent, dans de rares cas, la machine virtuelle JVM a configuré des durées de conservation de courte durée de vie agressives, il peut ne pas être utile d’autoriser l’utilisation de keep-alives de moins qu’elles interfèrent avec les opérations de transfert de données à long terme. |
void |
setLocationMode(final LocationMode locationMode)
Définit le LocationMode pour cette demande. La valeur par défaut LocationMode est définie dans le client et est par défaut PRIMARY_ONLY. Vous pouvez modifier le LocationMode 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 ce .LocationMode |
void |
setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs)
Définit la durée d’exécution maximale à utiliser lors de l’exécution de cette demande. L’intervalle de temps d’exécution maximal commence au moment où le client commence à générer la demande. La durée maximale d’exécution est vérifiée par intermittence lors du chargement des données, du téléchargement des données et avant l’exécution des nouvelles tentatives. Le service continue de charger, de télécharger et de réessayer jusqu’à ce que la durée d’exécution maximale soit atteinte. À ce moment-là, tous les téléchargements ou téléchargements partiels seront annulés et une exception sera levée. L’exécution maximale par défaut est définie dans le client et est null par défaut, ce qui indique aucune durée maximale. Vous pouvez modifier la durée maximale d’exécution 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 la durée d’exécution maximale. |
void |
setRequireEncryption(Boolean requireEncryption)
Définit une valeur pour indiquer si toutes les données écrites et lues doivent être chiffrées. Utiliser pour chiffrer/déchiffrer des données pour les transactions ; Sinon. La valeur par défaut est définie dans le client et est par défaut false, ce qui indique que le chiffrement n’est pas requis. Vous pouvez modifier la valeur de 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 la valeur appropriée. |
final void |
setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory)
Définit l’objet RetryPolicyFactory à utiliser pour cette requête. La valeur par défaut RetryPolicyFactory est définie dans le client et est par défaut RetryExponentialRetry. Vous pouvez modifier retryPolicyFactory 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 ce retryPolicyFactory. |
final void |
setTimeoutIntervalInMs(final Integer timeoutIntervalInMs)
Définit le délai d’attente à utiliser pour effectuer cette demande. L’intervalle de délai d’expiration du serveur commence au moment où la demande complète a été reçue par le service et que le serveur commence à traiter la réponse. Si l’intervalle de délai d’attente s’écoule avant que la réponse ne soit retournée au client, l’opération expire. L’intervalle de délai d’expiration est réinitialisé à chaque nouvelle tentative, si la demande est retentée. Le délai d’attente du serveur par défaut est défini dans le client et est null par défaut, ce qui indique qu’il n’y a pas de délai d’attente du serveur. Vous pouvez modifier le délai d’expiration du serveur 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 délai d’expiration du serveur. |
Détails du constructeur
RequestOptions
public RequestOptions()
Crée une instance de la classe.
RequestOptions
public RequestOptions(final RequestOptions other)
Crée une instance de la classe en copiant les valeurs d’un autre instance.
Parameters:
RequestOptions
qui représente les options de demande à copier.
Détails de la méthode
applyBaseDefaultsInternal
protected static void applyBaseDefaultsInternal(final RequestOptions modifiedOptions)
Remplit le délai d’expiration, la stratégie de nouvelle tentative et le mode d’emplacement par défaut à partir du client s’ils sont null.
Parameters:
disableHttpsSocketKeepAlive
public Boolean disableHttpsSocketKeepAlive()
Obtient une valeur pour indiquer si la conservation du socket https doit être désactivée. Utiliser pour désactiver keep-alive ; Sinon. Pour plus d’informations sur disableHttpsSocketKeepAlive defaults, consultez getDefaultRequestOptions()
Returns:
getLocationMode
public final LocationMode getLocationMode()
Obtient le mode d’emplacement par défaut pour cette requête. Pour plus d’informations sur le mode d’emplacement, consultez setLocationMode(final LocationMode locationMode).
Returns:
getMaximumExecutionTimeInMs
public Integer getMaximumExecutionTimeInMs()
Obtient la durée d’exécution maximale de cette requête. Pour plus d’informations sur les valeurs par défaut du temps d’exécution maximal, consultez setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs).
Returns:
getOperationExpiryTimeInMs
public Long getOperationExpiryTimeInMs()
RÉSERVÉ À UN USAGE INTERNE.
Retourne l’heure à laquelle cette opération expire. Cette valeur est calculée en ajoutant l’heure de début de l’opération et la durée d’exécution maximale et sera null si la durée d’exécution maximale est null. Pour plus d’informations sur le temps d’exécution maximal, consultez setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs).
Returns:
getRetryPolicyFactory
public final RetryPolicyFactory getRetryPolicyFactory()
Obtient la stratégie de nouvelle tentative à utiliser pour cette demande. Pour plus d’informations sur les valeurs par défaut de la stratégie de nouvelle tentative, consultez setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory).
Returns:
getTimeoutIntervalInMs
public final Integer getTimeoutIntervalInMs()
Retourne la valeur de délai d’expiration pour cette demande. Pour plus d’informations sur les valeurs par défaut du délai d’expiration, consultez setTimeoutIntervalInMs(final Integer timeoutIntervalInMs).
Returns:
populateRequestOptions
protected static void populateRequestOptions(RequestOptions modifiedOptions, final RequestOptions clientOptions, final boolean setStartTime)
Remplit les champs Null du premier objet requestOptions avec les valeurs du deuxième objet requestOptions.
Parameters:
requireEncryption
public Boolean requireEncryption()
Obtient une valeur pour indiquer si toutes les données écrites et lues doivent être chiffrées. Utiliser pour chiffrer/déchiffrer des données pour les transactions ; Sinon. Pour plus d’informations sur exiger des valeurs de chiffrement par défaut, consultez setRequireEncryption(Boolean requireEncryption).
Returns:
setDisableHttpsSocketKeepAlive
public void setDisableHttpsSocketKeepAlive(Boolean disableHttpsSocketKeepAlive)
Définit une valeur pour indiquer si la conservation du socket https doit être désactivée. Utiliser pour désactiver keep-alive ; Sinon
La valeur par défaut est définie dans le client et est par défaut true, ce qui indique que la conservation du socket https sera désactivée. Vous pouvez modifier la valeur de 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 la valeur appropriée.
La définition de keep-alive sur les sockets https consiste à contourner un bogue dans la machine virtuelle JVM où les délais d’expiration de connexion ne sont pas respectés sur les demandes retentées. Dans ce cas, vous pouvez choisir d’utiliser socket keep-alive comme secours. Malheureusement, la valeur du délai d’expiration doit être extraite d’une propriété JVM plutôt que configurée localement. Par conséquent, dans de rares cas, la machine virtuelle JVM a configuré des durées de conservation de courte durée de vie agressives, il peut ne pas être utile d’autoriser l’utilisation de keep-alives de moins qu’elles interfèrent avec les opérations de transfert de données à long terme.
Parameters:
setLocationMode
public void setLocationMode(final LocationMode locationMode)
Définit le LocationMode pour cette demande.
La valeur par défaut LocationMode est définie dans le client et est par défaut PRIMARY_ONLY. Vous pouvez modifier le LocationMode 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 ce .LocationMode
Parameters:
setMaximumExecutionTimeInMs
public void setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs)
Définit la durée d’exécution maximale à utiliser lors de l’exécution de cette demande.
L’intervalle de temps d’exécution maximal commence au moment où le client commence à générer la demande. La durée maximale d’exécution est vérifiée par intermittence lors du chargement des données, du téléchargement des données et avant l’exécution des nouvelles tentatives. Le service continue de charger, de télécharger et de réessayer jusqu’à ce que la durée d’exécution maximale soit atteinte. À ce moment-là, tous les téléchargements ou téléchargements partiels seront annulés et une exception sera levée.
L’exécution maximale par défaut est définie dans le client et est null par défaut, ce qui indique aucune durée maximale. Vous pouvez modifier la durée maximale d’exécution 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 la durée d’exécution maximale.
Parameters:
setRequireEncryption
public void setRequireEncryption(Boolean requireEncryption)
Définit une valeur pour indiquer si toutes les données écrites et lues doivent être chiffrées. Utiliser pour chiffrer/déchiffrer des données pour les transactions ; Sinon.
La valeur par défaut est définie dans le client et est par défaut false, ce qui indique que le chiffrement n’est pas requis. Vous pouvez modifier la valeur de 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 la valeur appropriée.
Parameters:
setRetryPolicyFactory
public final void setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory)
Définit l’objet RetryPolicyFactory à utiliser pour cette requête.
La valeur par défaut RetryPolicyFactory est définie dans le client et est par défaut RetryExponentialRetry. Vous pouvez modifier retryPolicyFactory 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 ce retryPolicyFactory.
Parameters:
setTimeoutIntervalInMs
public final void setTimeoutIntervalInMs(final Integer timeoutIntervalInMs)
Définit le délai d’attente à utiliser pour effectuer cette demande.
L’intervalle de délai d’expiration du serveur commence au moment où la demande complète a été reçue par le service et que le serveur commence à traiter la réponse. Si l’intervalle de délai d’attente s’écoule avant que la réponse ne soit retournée au client, l’opération expire. L’intervalle de délai d’expiration est réinitialisé à chaque nouvelle tentative, si la demande est retentée.
Le délai d’attente du serveur par défaut est défini dans le client et est null par défaut, ce qui indique qu’il n’y a pas de délai d’attente du serveur. Vous pouvez modifier le délai d’expiration du serveur 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 délai d’expiration du serveur.
Parameters:
S’applique à
Azure SDK for Java