PolicyHttpMessageHandler Classe

Définition

public ref class PolicyHttpMessageHandler : System::Net::Http::DelegatingHandler

public class PolicyHttpMessageHandler : System.Net.Http.DelegatingHandler

type PolicyHttpMessageHandler = class
    inherit DelegatingHandler

Public Class PolicyHttpMessageHandler
Inherits DelegatingHandler

Héritage

Object

HttpMessageHandler

DelegatingHandler

PolicyHttpMessageHandler

Remarques

Cette implémentation du gestionnaire de messages prend en charge l’utilisation des stratégies fournies par la bibliothèque Polly pour la gestion et la résilience des erreurs temporaires.

La documentation fournie ici est axée sur l’utilisation de Polly avec le IHttpClientFactory. Consultez le projet Polly et sa documentation pour obtenir des informations faisant autorité sur Polly.

Les méthodes d’extension sur PollyHttpClientBuilderExtensions sont conçues comme un moyen pratique et correct de créer un PolicyHttpMessageHandler.

La AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) méthode prend en charge la création d’une PolicyHttpMessageHandler stratégie pour n’importe quel type de stratégie. Cela inclut les stratégies non réactives, telles que le délai d’expiration ou le cache, qui ne nécessitent pas d’abord l’échec de la requête sous-jacente.

PolicyHttpMessageHandleret les PollyHttpClientBuilderExtensions méthodes pratiques n’acceptent que le générique IAsyncPolicy`1 . Les instances de stratégie générique peuvent être créées à l’aide des méthodes génériques sur Policy , telles que TimeoutAsync``1(System.Int32).

Pour adapter un code non générique IAsyncPolicyexistant, utilisez du code comme suit :

policy.AsAsyncPolicy<HttpResponseMessage>()

La AddTransientHttpErrorPolicy(IHttpClientBuilder, Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>) méthode est une méthode pratique qui prend en charge l’application d’une stratégie pour les demandes qui échouent en raison d’une défaillance de connexion ou d’une erreur de serveur (code http status 5XX). Ce type de méthode prend uniquement en charge les stratégies réactives telles que Réessayer, Circuit-Breaker ou Secours. Cette méthode n’est fournie qu’à des fins pratiques ; nous vous recommandons de créer vos propres stratégies si nécessaire si cela ne répond pas à vos besoins.

Soyez prudent lorsque vous utilisez des stratégies telles que Réessayer ou Délai d’expiration, car HttpClient fournit son propre délai d’expiration via Timeout. Lors de la combinaison de nouvelle tentative et de délai d’expiration, Timeout agit comme un délai d’expiration pour toutes les tentatives ; une stratégie Polly Timeout peut être configurée après une stratégie de nouvelle tentative dans la séquence de configuration, pour fournir un délai d’expiration par essai.

Toutes les stratégies fournies par Polly sont conçues pour être efficaces lorsqu’elles sont utilisées de manière durable. Certaines stratégies telles que bulkhead et Circuit-Breaker maintenir l’état et doivent être étendues entre les appels que vous souhaitez partager l’état Bulkhead ou Circuit-Breaker. Veillez à garantir les durées de vie correctes lors de l’utilisation de stratégies et de gestionnaires de messages dans des scénarios personnalisés. Les méthodes d’extension fournies par PollyHttpClientBuilderExtensions sont conçues pour attribuer une longue durée de vie aux stratégies et garantir qu’elles peuvent être utilisées lorsque la fonctionnalité de rotation du gestionnaire est active.

le PolicyHttpMessageHandler attache un contexte à avant d’exécuter HttpRequestMessage un Policy, s’il n’en existe pas déjà un. Le Context sera fourni à la stratégie pour une utilisation à l’intérieur et Policy dans d’autres gestionnaires de messages.

Constructeurs

Propriétés

Méthodes

S’applique à