0Pricing
C# Academy · Lekcja

Zasady buforowania i unieważnianie

Kontroluj czas życia bufora i jego tagi.

Zasady buforowania i unieważnianie 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.

Polityki nazwane

Zamiast powtarzać ustawienia cache dla każdego endpointu, należy raz zdefiniować wielokrotnego użytku polityki nazwane i odwoływać się do nich po nazwie.

builder.Services.AddOutputCache(options =>
{
    options.AddPolicy("Short", policy =>
        policy.Expire(TimeSpan.FromSeconds(10)));
    options.AddPolicy("Long", policy =>
        policy.Expire(TimeSpan.FromMinutes(10)));
});

Stosowanie nazwanej polityki

Podczas buforowania endpointu odwołaj się do polityki za pomocą jej nazwy.

app.MapGet("/catalog", GetCatalog)
   .CacheOutput("Long");

Tagi cache

Tagi grupują powiązane wpisy cache, dzięki czemu można unieważnić je razem. Otaguj endpoint za pomocą Tag w jego polityce.

app.MapGet("/products", GetProducts)
   .CacheOutput(policy => policy
        .Expire(TimeSpan.FromMinutes(5))
        .Tag("products"));

IOutputCacheStore

Unieważnianie odbywa się za pośrednictwem IOutputCacheStore. Wstrzyknij go i wywołaj EvictByTagAsync, aby usunąć każdy wpis opatrzony danym tagiem.

app.MapPost("/products", async (
    Product p, AppDb db, IOutputCacheStore cache, CancellationToken ct) =>
{
    db.Products.Add(p);
    await db.SaveChangesAsync(ct);
    await cache.EvictByTagAsync("products", ct);
    return Results.Created($"/products/{p.Id}", p);
});

Dlaczego unieważniać po zapisie

Lista z cache staje się nieaktualna w chwili, gdy zmienią się dane źródłowe. Usuwanie wpisów oznaczonych odpowiednim tagiem po każdym utworzeniu, zaktualizowaniu lub usunięciu danych zapewnia świeżość odczytów bez czekania na wygaśnięcie.

// After any mutation:
await cache.EvictByTagAsync("products", ct);

Tagowanie zasobów

Taguj na bardziej szczegółowym poziomie, aby usuwać tylko buforowane odpowiedzi dotyczące jednego elementu, a nie całej kolekcji.

app.MapGet("/products/{id}", GetProduct)
   .CacheOutput(policy => policy.Tag("products"));
// Evict the single item's detail + the list together
await cache.EvictByTagAsync("products", ct);

Vary-By w polityce

Połącz czas wygaśnięcia, tagi i reguły Vary-By w jednej nazwanej polityce, aby zdefiniować kompletną umowę dotyczącą buforowania.

options.AddPolicy("ProductList", policy => policy
    .Expire(TimeSpan.FromMinutes(5))
    .Tag("products")
    .SetVaryByQuery("page", "size"));

Niestandardowa wartość Vary-By

VaryByValue pozwala oprzeć klucz cache na dowolnych danych żądania, takich jak identyfikator tenanta odczytany z requestu.

policy.VaryByValue(context =>
    new KeyValuePair<string, string>(
        "tenant",
        context.Request.Headers["X-Tenant"].ToString()));

Usuwanie z cache a wygasanie

Istnieją dwa sposoby, na jakie wpisy opuszczają cache:

  • Wygaśnięcie: automatyczne, zależne od czasu, za pośrednictwem Expire.
  • Usunięcie: jawne, za pośrednictwem EvictByTagAsync, gdy zmienią się dane.

Należy używać obu mechanizmów: krótkiego czasu wygaśnięcia jako zabezpieczenia oraz usuwania wpisów dla zachowania poprawności.

// belt-and-suspenders: Expire(5min) + EvictByTag on write

Blokowanie i ochrona przed lawinowym napływem żądań

Buforowanie odpowiedzi domyślnie scala równoczesne żądania, dla których brakuje wpisu w cache: gdy wiele żądań jednocześnie trafia do niebuforowanego endpointu, tylko jedno wykonuje handler, a pozostałe czekają. Można wyłączyć ten mechanizm za pomocą SetLocking(false).

policy.SetLocking(false); // allow concurrent regeneration

Rozproszony cache odpowiedzi

Domyślnie magazyn działa w pamięci i jest lokalny dla każdej instancji. W przypadku wielu serwerów należy użyć rozproszonego magazynu, takiego jak Redis, aby wszystkie instancje współdzieliły ten sam cache i wspólnie go unieważniały.

// Register a distributed IOutputCacheStore implementation
// (e.g. a Redis-backed package) so EvictByTag works cluster-wide

Szybki test

Proszę sprawdzić zrozumienie unieważniania.

Podsumowanie

Poznali Państwo polityki cache i unieważnianie:

  • Należy definiować wielokrotnego użytku polityki nazwane i stosować je po nazwie.
  • Tagi grupują wpisy; IOutputCacheStore.EvictByTagAsync usuwa je podczas operacji zapisu.
  • Należy łączyć wygaśnięcie (automatyczne) z usuwaniem (jawnym).
  • Wdrożenia wieloserwerowe powinny korzystać z rozproszonego magazynu.

To kończy kurs dotyczący ograniczania liczby żądań i buforowania.

Często zadawane pytania

Czy lekcja „Zasady buforowania i unieważnianie” jest bezpłatna?

Tak — pełny tekst „Zasady buforowania i unieważnianie” 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 „Zasady buforowania i unieważnianie”?

Kontroluj czas życia bufora i jego tagi. Ć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 „Zasady buforowania i unieważnianie”?

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

  1. Algorytmy ograniczania przepustowości
  2. Konfigurowanie oprogramowania pośredniczącego ograniczania przepustowości
  3. Podstawy buforowania odpowiedzi
  4. Zasady buforowania i unieważnianie
← Powrót do C# Academy