Potoki odporności
Łącz strategie w potoki odporności.
Potoki odporności to bezpłatna lekcja C# Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej C# Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs C# Academy zawiera 4 lekcji w sumie.
Łączenie strategii
Rzeczywista odporność aplikacji zwykle wymaga współdziałania kilku strategii. Polly v8 pozwala połączyć je w jeden potok odporności za pomocą obiektu ResiliencePipelineBuilder.
ResiliencePipelineBuilder
Łączysz wywołania Add..., a następnie kończysz konfigurację za pomocą Build(). Wynikiem jest wielokrotnego użytku, bezpieczny wątkowo obiekt ResiliencePipeline, za pośrednictwem którego wykonujesz wywołania.
var pipeline = new ResiliencePipelineBuilder()
.AddRetry(new RetryStrategyOptions())
.AddTimeout(TimeSpan.FromSeconds(5))
.Build();Kolejność ma znaczenie
Strategie są wykonywane od zewnątrz do wewnątrz: pierwsza dodana strategia opakowuje pozostałe. Typowa, poprawna kolejność to limit czasu dla pojedynczej próby wewnątrz ponawiania, z ogólnym limitem czasu i circuit breakerem umieszczonymi na zewnątrz.
var pipeline = new ResiliencePipelineBuilder()
.AddTimeout(TimeSpan.FromSeconds(10)) // overall
.AddRetry(new RetryStrategyOptions())
.AddCircuitBreaker(new CircuitBreakerStrategyOptions())
.AddTimeout(TimeSpan.FromSeconds(2)) // per attempt
.Build();Potoki typowane
Gdy strategie analizują wynik, na przykład fallback lub ponawianie zależne od wyniku, użyj generycznego obiektu ResiliencePipelineBuilder<T>, aby potok znał typ zwracanej wartości.
var pipeline = new ResiliencePipelineBuilder<HttpResponseMessage>()
.AddRetry(new HttpRetryStrategyOptions())
.Build();Wykonywanie ze stanem
Aby uniknąć alokacji związanych z domknięciami, przekaż stan do ExecuteAsync. Polly przekaże go z powrotem do wywołania zwrotnego.
await pipeline.ExecuteAsync(
static async (state, token) => await state.CallAsync(token),
myService);ResiliencePipelineProvider
Zamiast budować potoki bezpośrednio w kodzie, zarejestruj nazwane potoki w DI i pobieraj je za pośrednictwem ResiliencePipelineProvider. Centralizuje to konfigurację.
builder.Services.AddResiliencePipeline("db", pipeline =>
{
pipeline.AddRetry(new RetryStrategyOptions())
.AddTimeout(TimeSpan.FromSeconds(3));
});Pobieranie nazwanego potoku
Wstrzyknij ResiliencePipelineProvider<string> i pobierz potok za pomocą klucza w dowolnym miejscu, w którym go potrzebujesz.
public class OrderService
{
private readonly ResiliencePipeline _pipeline;
public OrderService(ResiliencePipelineProvider<string> provider)
{
_pipeline = provider.GetPipeline("db");
}
}Odporność dla HttpClient
Metoda rozszerzająca AddResilienceHandler dołącza potok do typowanego lub nazwanego obiektu HttpClient, stosując go do każdego wychodzącego żądania.
builder.Services.AddHttpClient<CatalogClient>()
.AddResilienceHandler("catalog", b =>
{
b.AddRetry(new HttpRetryStrategyOptions());
b.AddCircuitBreaker(new HttpCircuitBreakerStrategyOptions());
});Standardowy handler odporności
Firma Microsoft udostępnia kompletny, gotowy do użycia handler AddStandardResilienceHandler, który łączy rozsądnie skonfigurowane ponawianie, circuit breaker, limit czasu i ograniczanie przepustowości w zalecanej kolejności.
builder.Services.AddHttpClient<CatalogClient>()
.AddStandardResilienceHandler();Potoki można wielokrotnie wykorzystywać i są lekkie
Zbuduj potok raz i używaj go ponownie przy wielu wykonaniach. Potoki są niezmienne i bezpieczne wątkowo, więc ich współdzielenie jest zarówno bezpieczne, jak i wydajne.
Mechanizmy obserwowalności
Każda strategia udostępnia wywołania zwrotne, takie jak OnRetry, OnOpened, OnTimeout i OnFallback, a Polly emituje dane telemetryczne, które można podłączyć do rejestrowania i metryk, uzyskując pełny wgląd w działanie aplikacji.
Szybki test
Przetestuj potoki odporności.
Podsumowanie
Obiekt ResiliencePipelineBuilder łączy ponawianie, circuit breaker, limit czasu i fallback w jeden potok wielokrotnego użytku; kolejność jest od zewnątrz do wewnątrz, więc ma znaczenie. Użyj generycznego konstruktora dla strategii analizujących wyniki, rejestruj nazwane potoki za pomocą AddResiliencePipeline i pobieraj je przez ResiliencePipelineProvider. W przypadku HTTP metoda AddResilienceHandler lub AddStandardResilienceHandler chroni każde żądanie.
Często zadawane pytania
Czy lekcja „Potoki odporności” jest bezpłatna?
Tak — pełny tekst „Potoki odporności” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu C# Academy, przejdź na CoddyKit PRO. Kurs C# Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Potoki odporności”?
Łącz strategie w potoki odporności. Ćwiczysz C# Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć C# Academy?
Nie wymagamy żadnego doświadczenia. C# Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Potoki odporności”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji C# Academy?
Tak. Każda lekcja C# Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Zasady ponawiania prób
- Wzorzec circuit breaker
- Zasady limitu czasu i wartości zastępczych
- Potoki odporności