Partager via


RequestOptions Classe

  • java.lang.Object
    • com.microsoft.azure.storage.RequestOptions

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 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).

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 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).

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:

other - Objet 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:

modifiedOptions - Options d’entrée à partir de laquelle copier lors de l’application des valeurs par défaut

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:

Valeur pour indiquer si la conservation du socket https doit être désactivée.

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:

Objet LocationMode qui représente le mode d’emplacement de cette demande.

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:

Durée d’exécution maximale actuelle, en millisecondes, pour cette demande.

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:

Durée d’expiration de l’opération actuelle, en millisecondes, pour cette demande.

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:

Objet RetryPolicyFactory qui représente la stratégie de nouvelle tentative actuelle.

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:

Valeur de délai d’attente actuel, en millisecondes, pour cette demande.

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:

modifiedOptions
clientOptions
setStartTime

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:

Valeur qui indique si toutes les données écrites et lues doivent être chiffrées.

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:

disableHttpsSocketKeepAlive - Valeur pour indiquer si la conservation du socket https doit être désactivée.

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:

locationMode - locationMode à définir

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:

maximumExecutionTimeInMs - Durée d’exécution maximale, en millisecondes, à utiliser pour cette requête.

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:

requireEncryption - Valeur qui indique si toutes les données écrites et lues doivent être chiffrées.

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:

retryPolicyFactory - l’objet RetryPolicyFactory à utiliser lors de l’envoi de demandes de service.

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:

timeoutIntervalInMs - Délai d’attente, en millisecondes, à utiliser pour cette demande.

S’applique à