Утримка стосунків між запитами в ASP.NET Core: ПрактичнійM SK2 Ні ‑Нерозумний Рухівник МSK4MVCMSC5 Розмаїття сторінок МSK6 Minimal APIsMスク7 (Українська (Ukrainian))

Утримка стосунків між запитами в ASP.NET Core: ПрактичнійM SK2 Ні ‑Нерозумний Рухівник МSK4MVCMSC5 Розмаїття сторінок МSK6 Minimal APIsMスク7

Sunday, 09 November 2025

//

52 minute read

UPDATE (2025-11-10): Добавлено більше практичних прикладів з мого реального кодової бази, які показують реальніM SK1 світові шаблони МSK2 торгівля - відхилення M SK4 купівлю , і еволюцію від простого до складного підходу до управління державою MSC6 Включає деталізовані IMemoryCache шаблони

Введение

HTTP є відомою безStatusless. Ваша програмаM SK1 не є . Пользовачі підписуються в, додають додатки до корзини МSK4 перестрибають між сторінками МСК5 повертаються завтра М СК6 і очікують, що ви запам 'ятаєте M СК7 В АSP М סК8 NET Core MСК9 MVC М SК10 Разор Pages M S К11 Minimal APIs М ็ С К12 є багато способів зберегти та передати стан між запитими M ็ S К13 Деякі - один за один, М С К14 лише за запитом, М ্ С К15 деякі - останні для сеансу, М S К16 Деяки - живі у клієнті, М М ् С К17 деякі розповсюджуються і виживають від резайнта сервера М М С K 18 Кожен вибір має свій торговий курс М Ш К 19 знизує рівень безпеки М В С С С К 20 ефективність, М Ш С К 21 масштабність, М В В С К 22 енергоніка програміста, М А С К 23

Цей пост каталогізує варіанти, показує бетон, копіюM SK2 вставляні приклади у всіх трьох стопкахMSC3 і дає вам настанови для прийняття рішень, щоб ви могли обрати правильне інструментарій для роботи .

NOTE: Це частина моїх експериментів з штучним інтелектом

Погляньмо на ландшафт

flowchart LR
  subgraph Client
    Q[Query String]
    R[Route Values]
    H[Headers]
    F[Form/Hidden Fields]
    CK[Cookies]
    LS[Local/Session Storage]
  end
  subgraph Server
    I[HttpContext.Items<br/>\nper request only]
    TD[TempData<br/>\none redirect]
    SS[Session]
    MC[IMemoryCache]
    DC[IDistributedCache]
    AU[Auth Cookie / Claims]
    JT[JWT / Bearer]
    DB[Database / Durable Store]
    BUS[Outbox / Queue]
  end
  Q --> Model[Model Binding]
  R --> Model
  F --> Model
  H --> Model
  CK --> App[Your Code]
  Model --> App
  App -->|Set| CK
  App -->|Set| TD
  App -->|Set| SS
  App -->|Set| MC
  App -->|Set| DC
  App -->|Issue| AU
  App -->|Issue| JT
  App -->|Persist| DB
  • Клієнт-надісланоM SK1запитка, маршрутМSK3 заголовкиMST4 бланкиM ST5 кукиМ ST6 JWTM st7 Скала горизонтально, але видлива для клієнта МST8мусить бути підтвердженаМС ST9 надсиланаMС ST10 шифрована, як це потрібноМS ST11
  • Сервер-carried: TempDataM SK2 Сессія , кэши МSK4 DBMSC5 Потрібна стратегія зближення або дистрибуціїМSK6
  • Per-request: HttpContext .Items M SK3 корисне для передачі даних всередині під час одного запитуMSC4

Золоті правила ( перед тим, як зануритися в APIsM SK1

  1. Безопасність першою за все: Потіки з боку держави є реальною загрозоюM SK1 Сервер - сторонній стан МSK1 Сессія , в МSK3 пам 'яткові кэши ) можуть потікати між користувачами через помилки кодування \ , умови гонки \ МSK6 \ або неправильне управління життєвим циклом \
  2. Prefer "stateless server" patterns when you need to scale horizontally
  3. Ніколи не довіряйте клієнту-kontroled state. ValidateM SK2 sign , andMST4or encryptMSC5
  4. Витримуйте велику кількість даних від plików cookie та заголовків
  5. Використовуйте TempData тільки для постів-Redirect-Get M SK2PRG ) oneMska4shots like flash messagesMka5
  6. Використовуйте Сессію тільки тоді, коли ви повинні підтримувати стан серверу-за межами розмови і виM SK1планували дистрибуцію
  7. Вимагання щодо ідентичності та грубості
  8. Мережа не є джерелом правди. Поверніть її з міцним запасом, якщо дані важливіM SK1

Per-Status запиту: HttpContextM SK2Items

  • Сфера застосування: тільки на даний момент запиту M SK1 відлік наприкінці трубопроводу)
  • Використовувати: для передачі обчислювальних цінностей між середніми інструментами та кінцевими точкамиM SK1контролери
  • Скала: без впливу
  • Безпека: сервер- тільки
sequenceDiagram
  participant M as Middleware
  participant E as Endpoint/Controller
  M->>M: Compute TenantId
  M->>E: HttpContext.Items["TenantId"] = 42
  E->>E: Read Items["TenantId"]

До прикладу Middleware (все стеки):

app.Use(async (context, next) =>
{
    var tenantId = context.Request.Headers["X-TenantId"].FirstOrDefault() ?? "public";
    context.Items["TenantId"] = tenantId;
    await next(context);
});
  • Minimalний кінцевий пункт API:
app.MapGet("/whoami", (HttpContext ctx) => new { Tenant = ctx.Items["TenantId"] });
  • Контроллер MVC:
public IActionResult WhoAmI() => Json(new { Tenant = HttpContext.Items["TenantId"] });
  • Рухівник сторінки Razor:
public IActionResult OnGet() => new JsonResult(new { Tenant = HttpContext.Items["TenantId"] });

Перехідний Client-Carried State: Значення маршруту та строки запитів

  • Сфера застосування: те саме, що й теперішній запит; клієнт несе його явноM SK2
  • Використовувати: контекст навігаціїM SK1 фільтрування, відображання сторінок , ідентифікацію ресурсів
  • Безпека: має підтвердитиM SK1 дозволити; не вміщувати секретів

Приклади

  • Minimalні API:
app.MapGet("/orders/{id:int}", (int id, int? page) => Results.Ok(new { id, page }));
// GET /orders/5?page=2
  • МVC:
[HttpGet("/orders/{id:int}")]
public IActionResult Details(int id, int? page)
  => View(new { id, page });
  • Різовижні сторінки (ЗаказиM SK1Details.cshtml .csMSC4
public IActionResult OnGet(int id, int? page)
  => Page();

генерування зв 'язків, що зберігають стан:

// Razor Pages
<a asp-page="/Orders/Details" asp-route-id="@Model.Id" asp-route-page="@Model.Page">Next</a>

// MVC
@Html.ActionLink("Next", "Details", "Orders", new { id = Model.Id, page = Model.Page }, null)

Заголовки: Коди корреляціїM SK1 Ключи іdemпотентності, Флаги характеристики

  • Сфера дій: поточний запитM SK1 опціонально відекується в реакціях
  • Використовуйте флаги:: відображання;
  • Безпека: сприймає ненадійний вхід, підтверджуєM SK2 білий список
app.Use(async (ctx, next) =>
{
    var correlationId = ctx.Request.Headers["X-Correlation-Id"].FirstOrDefault()
                      ?? Guid.NewGuid().ToString("n");
    ctx.Response.Headers["X-Correlation-Id"] = correlationId;
    await next(ctx);
});

Idempotency (patternM SK1

flowchart TD
  C[Client POST /pay\nIdempotency-Key:k] --> S{Seen k?}
  S -- No --> E[Execute charge]
  E --> P[Persist result by k]
  P --> R[Return 200 + result]
  S -- Yes --> L[Load result by k]
  L --> R

Форми та приховані поля (PRGM SK1

  • Область: наступний запит лише M SK1заказчик відсилає значення)
  • Використовуйте: інструктивні крокиM SK1 анти- фальшиві टोकониMSC3 зберігаючи маленькі шматочки статусу по всій PRG
  • Безпека: завжди підтверджуєM SK1 поєднується з антифалсификаторами

Модель PRG в MVC/Страї РезоруM SK1

sequenceDiagram
  participant U as User
  participant P as POST Action
  participant R as Redirect
  participant G as GET Action
  U->>P: POST form
  P-->>R: 302 Redirect
  U->>G: GET redirected
  G-->>U: Final page (no resubmits)
  • МVC:
[HttpPost]
[ValidateAntiForgeryToken]
public IActionResult Save(SettingsModel model)
{
    // validate & persist
    return RedirectToAction(nameof(Summary), new { tab = model.SelectedTab });
}
  • Різові сторінки:
public IActionResult OnPost(SettingsModel model)
{
    return RedirectToPage("/Settings/Summary", new { tab = model.SelectedTab });
}

Куки: МаліM SK1 Подписані , Інколи зашифровані

  • Об 'єм: кожен запит від браузера до його закінчення
  • Використовувати: preferencesM SK1 non -sensitive flagsМSK3 consent; auth cookies Mska5separate sectionM Ska6
  • ТоргівляМСК0оффсМSK1 обмеження розміру МСК2КБ за куки MСК3 вплив на ефективність МСК4 має бути підпорядкована закону про згоду

Minimalний приклад API:

app.MapPost("/prefs/theme/{value}", (HttpContext ctx, string value) =>
{
    ctx.Response.Cookies.Append("theme", value, new CookieOptions
    {
        HttpOnly = false,
        Secure = true,
        SameSite = SameSiteMode.Lax,
        Expires = DateTimeOffset.UtcNow.AddYears(1)
    });
    return Results.Ok();
});

app.MapGet("/prefs/theme", (HttpContext ctx)
  => Results.Text(ctx.Request.Cookies["theme"] ?? "system"));

MVC/Razor Використовування сторінок ідентично через HttpContext.

Для прозорості/впевненостіM SK1 використовуйте ASP.NET Core Data Protection system, щоб захистити зайвих даних, які ви самі вклали в куки .


TempData: ОдинM SK1 Перенаправляющий автобус повідомлень

  • Спектр: пережив один перенаправлення
  • Бакунок:Cookie (defaultM SK2 або Сессія
  • Використовуйте підсумки перевірки: спалахових повідомленьM SK1 після PRG

Установка (Program.csM SK2

builder.Services.AddControllersWithViews().AddSessionStateTempDataProvider(); // optional
builder.Services.AddSession();
var app = builder.Build();
app.UseSession();

У контроллері MVC:

TempData["StatusMessage"] = "Saved!";
return RedirectToAction("Index");

У програмуванні сторінки Razor:

TempData["StatusMessage"] = "Saved!";
return RedirectToPage("/Index");

На екрані/странаМSK1

@if (TempData["StatusMessage"] is string msg) {
  <div class="alert alert-success">@msg</div>
}
flowchart LR
  A[POST /save] -->|TempData set| B[302 Redirect]
  B --> C[GET /index]
  C -->|TempData read consumed| D[Render message]

Сервер

  • Об 'єм: сеанс браузера M SK1 ключ для cookie + серверний магазин МSK3
  • Використовуйте для: мультиM SK1штовхівних wizards , даних маленького корзини МSK3 рахунків швидкості
  • Торгівля- offs : вимагає липких сеансів або розподіленого магазину підтримкиM SK2 може обмежувати масштаб

Konfigurуйте:

builder.Services.AddDistributedMemoryCache(); // or AddStackExchangeRedisCache
builder.Services.AddSession(options =>
{
    options.IdleTimeout = TimeSpan.FromMinutes(20);
    options.Cookie.HttpOnly = true;
    options.Cookie.IsEssential = true;
});
var app = builder.Build();
app.UseSession();

Використовуючи сеанс (any stack):

app.MapPost("/cart/add/{id:int}", (HttpContext ctx, int id) =>
{
    var key = "cart";
    var bytes = ctx.Session.Get(key);
    var list = bytes is null ? new List<int>() : System.Text.Json.JsonSerializer.Deserialize<List<int>>(bytes)!;
    list.Add(id);
    ctx.Session.Set(key, System.Text.Json.JsonSerializer.SerializeToUtf8Bytes(list));
    return Results.Ok(list);
});

Помощники сеансу:

public static class SessionExtensions
{
    public static void Set<T>(this ISession session, string key, T value)
      => session.SetString(key, System.Text.Json.JsonSerializer.Serialize(value));

    public static T? Get<T>(this ISession session, string key)
      => session.TryGetValue(key, out var data)
         ? System.Text.Json.JsonSerializer.Deserialize<T>(data)
         : default;
}

Застереження: Коли стан сеансу перетворюється на вузол

Одного разу я працював над грандіозним урядовим IT-проектом у Великобританії, де сеансний уряд зловживав цим. все в сеансі: поведінкові preferencesM SK1 мультиплексні - дані про форми кроків, результати пошукуMST4 тимчасові обчисленняMSC5 навіть заキャッシュом пошуки, які повинні були бути у відповідному кэші чи базі данихMSК6

Проблема: Статуй сеансу зберігався в-процесі M SK1ASP.Status сеансів NET в вебі .конфигурація, це було перед-Здорові дні МSK6 Кожна просьба повинна була десеріалізувати масивні об 'єкти сеансов M SK7 Коли навантаження збільшилося MSC8 Статуя сеанса збільшилась до десятків мегабайт на одного користувача . З тисячами одночасних користувачів MST10 серверам закінчилася пам' ять МST11

Відчайдушне рішення: Ми полетіли до zakładу HP в Штутгарті, щоб провести тести навантаження на їхніх супердомах Найпотужніша машина для Windows в Європі - '. Це було божевіллям МSK1 десятки процесорів ітаніуму МSK2 сотні гігабайт оперативної пам 'яті . Ідея була довести, що з достатньою технікою \ , \ система зможе meeting requirements

Результат: Навіть на Superdome, ми не змогли ' досягти необхідних одночасних мішень для користувачів МSK2 архітектура стадія сеансу була фундаментально зламана . Вертикове масштабування не змогло M SK4 не врятувало поганого дизайну MSC5 Серіалізація сеансів MST6 деseriалізація над głową M ST7 разом із тиском пам 'яті від масивних об' єктів сеанса M st 8 означало, що система просто не могла Mst 9 не могла масштабувати M St 10 не за будь-яку розумну ціну М st 11

Безпеціальний кошмар: Найгірше, ніж проблеми з продуктивністю, ми виявили błąd кодування, який спричинив стан сеансу потік між користувачами. Пользователь АM SK1 дані сеансу деколи з 'являлися в пользователе Б' сеансі МSK3 Це було не просто незграбно, МSK5 це було катастрофічно Працівники NHS доступ до записів пацієнтів та клінічних систем. Ми випадково створили механізм порушення прав на захист даних, який міг виявляти конфіденційну медичну інформацію у різних медпрацівників

Що б сталося?

  1. По замовчуванню безStatusless: Більшість даних сеансу ніколи не мали існувати
  2. База даних для довготривалого стану: МультифріальнийM SK1поступний прогрес форми повинен був бути в базі даних з ID робочого потоку
  3. Кэш для пошуків: Поширені пошуки належали IMemoryCache або розподіленій кэші
  4. Client-сторонь для переваг: Навігації користувача могли бути в файлах cookie або локальному накопичуванню
  5. Розповсюджена сеанс, якщо необхідно: Якщо сеанс дійсно був необхідний, RedisM SK2захищена сесія ділилась навантаженням

Урок Статуація сеансу не масштабується вертикально і ледь горизонтально. ( навіть з наклеєними сеансами чи розповсюдованими магазинами МSK2 ви МSK3 все ще серіалізуєте / деserialisуєте на кожному запиті \ ). Експеримент Супердома довів, що кидати апарати на архітектуру дорого та часто марно

Але що важливіше, Ошибки в стані сеансу стають загрозами безпеки. Мережа МSK1 Проблеми з безпекою МSK2 умови гонки , неправильне обробка идентификаторів сеансу \ — ці проблеми не викликають просто проблем з продуктивністю \ МSK6 вони можуть видавати конфіденційні дані між користувачами . У контексті охорони здоров 'я \

Сучасні поради:

  • Якщо вам потрібно більше, ніж кілька кб даних сеансу, виM SK1 скоріш за все маєте проблему з дизайном
  • Якщо ви ' зберігаєте конфіденційні дані в сеансі ,, ви (МSK2) створюєте поверхню для атаки
  • Архітектура без штату не тільки покращує масштабування, але й є більш безпечною через те, що там немає сервера,
  • Передумайте про свою стратегію управління державою перед тим, як летіти до Штутгарту. ( або поясніть інформаційному офіцерові порушення даних

Caching: IMemoryCache and IDistributedCache

  • Об 'єм: серверний процес M SK1IMemoryCache) або розподілений (IDistributedCache≥)
  • Використовувати для: відокремленихM SK1 обчислювальних даних , пошуків, короткихMSC4 живого стану
  • Торгівля

IMemoryCache:

builder.Services.AddMemoryCache();

app.MapGet("/rates", (IMemoryCache cache) =>
{
    var key = "fx:usd:eur";
    if (!cache.TryGetValue(key, out decimal rate))
    {
        rate = 0.92m; // pretend fetch
        cache.Set(key, rate, TimeSpan.FromMinutes(5));
    }
    return Results.Ok(rate);
});

IDistributedCache (e.gM SK2 Redis):

builder.Services.AddStackExchangeRedisCache(o => o.Configuration = "localhost:6379");

app.MapGet("/feature/{name}", async (IDistributedCache cache, string name) =>
{
    var val = await cache.GetStringAsync($"feat:{name}");
    return Results.Text(val ?? "off");
});

Cache-asM SK1state anti -pattern warningMSC3 if it must be durable or authoritative, store it in a database and optionally cache it

Вибір між IMemoryCache та IDistributedCache

  • IMemoryCache:
    • Найшвидше випромінювати, в-процесіM SK2 об 'єкти залишаються як об' єкти (без серіалізації МSK4
    • Уникнення шляхом тиску на пам 'ять, обмеження розміру МSK1 абсолютні / занепокоєння знижування зниження знижки знижка знижку знилення знищення
    • Не розподіляється між узлами; очищена при переробці додаткуM SK1розгортається.
    • Чудово для кожного-горячих наборів узловM SK1 обчислюваних пошуків, коротких ТТЛMSC3
  • IDistributedCache (Redis /SQLM SK2etc.):
    • Об 'єднані на фермі; виживає від перезапуска aplikacjiM SK1 потребує серійизації (стрічкиMSC3байтиMST4
    • Трохи більша затримка; пропускна спроможність залежить від мережі та зворотнього ґатункуM SK1
    • Obsługа абсолютного/зазнання терміну знижування MSC1продавецьM SK2независимий; Redis додає оновлення TTL щодо доступу для знижкиMスク4
    • Ідеальний для перетинання

Поширені стратегіїキャッシュу

  • Cache-aside (most commonM SK2

    1. Випробуйте касу; M SK1 якщо не враховуєш , завантаження з джерела; \3) написати в касу
    • Прос: простийМSK1 джерело правди залишається базою данихM SK2
    • Помічає: перша заявка після закінчення терміну - повільна ; можливі стемпедіїM SK2
  • Прочитати-крізь M SK1за допомогою бібліотеки /пропонувача МSK3 вказівникиキャッシュу завантаження на пропущені помилки .

  • Письмо-крізьM SK1 записи рухаються в кэш і резервні хранилища синхронно

  • Написати-задуM SK1 написати в кэшіМSK2 поштовхнути, щоб зберігати асинхронно МSK3 ризик: втратаMSC5неконсистентність ).

  • Обновляйте-передіM SK1 обновлюйте гарячі клавіатури перед тим, як вони закінчуються, щоб уникнути холодних пропущень

Вичерпування, виведенняM SK1 та розміри

  • Абсолютне закінчення: завжди закінчується після фіксованої тривалості M SK1потрібно для свіжості зовнішніх даних).
  • Слідове закінчування: розширює TTL при доступі (потрібно для сесій МSK2користувачеві МСК3конкретні дані М СК4
  • Розмір-побудоване виселення M SK1IMemoryCache): встановлений запис .Rozмір та конфігурація розміруLimit до прив 'язаної пам' яті МSK4
  • Priority (IMemoryCacheMSC1 CacheItemPriority.HighM SK3NormalMST4LowM ST5NeverRemove affects eviction under pressureMSS6
  • Jitter: додайте маленькі випадкові відхилення до ТТЛ для того, щоб уникнути синхронизованого закінчування M SK1stampedes).

Preventing cache stampedes (thundering herdM SK1

  • Використовуйте GetOrCreate/GetOrCreatAsync (IMemoryCacheM SK2 для того, щоб гарантувати одинакову populationу струн на нодіMSC3
  • Розповсюджений: використання коротенькогоM SK1живого замкнутих ключів (SET NX EXMSC3 або підтримка бібліотеки
  • Серверувати застарілий-whileM SK1реvalidate: зберігати вторинний ключ з застарілим значением і коротким розширенням, поки обчислюється нова величинаMSC3

Дизайн ключів і namespacing

  • Prefer lowercase , colon-delimited keys: appM SK3entityMska4 or tenantMske5usM Ska6userMSKA7
  • Включити сегмент версії, щоб зробити цілими класами ключів непотрібними, не видаючи їх.
  • Наймач-відомийM SK1 префіксні ключі з ідеєю наймача чи організації, щоб уникнути зіштовхування і легко очистити.
  • Залишити ключі малими, але дескриптивними; уникати користувача

Вичерпуються набіри ключів (тегиM SK1групи)

Коли вам потрібно занеważити багато поєднаних записів:

  • Версії префиксів (soft invalidation): bump глобальну версію в маленькому ключі і співробіть з ним ключі

    // version key: "v:products"; keys like $"{version}:product:{id}"
    var version = await cache.GetStringAsync("v:products") ?? "1";
    var key = $"{version}:product:{id}";
    

    Для того, щоб зробити всі продукти недействительними: інкремент vM SK1продукти (клиенти природньо пропуститимуть старі префіксовані ключі).

  • Набір ярликів в кожній групі (Redis): зберігати набір ключів у вигляді ярлику в кожного ярлика ; при невизначенні M SK3 відвезти членів та видалити

    // using StackExchange.Redis directly for sets + efficient deletes
    var mux = await ConnectionMultiplexer.ConnectAsync("localhost:6379");
    var db = mux.GetDatabase();
    var tag = "tag:category:42";
    var key = $"prod:{prodId}";
    await db.StringSetAsync(key, serialized, expiry: TimeSpan.FromMinutes(30));
    await db.SetAddAsync(tag, key); // remember membership
    
    // later, invalidate the whole tag
    var members = await db.SetMembersAsync(tag);
    if (members.Length > 0)
    {
        var keys = Array.ConvertAll(members, m => (RedisKey)m);
        await db.KeyDeleteAsync(keys);
    }
    await db.KeyDeleteAsync(tag);
    
  • Pub/Sub неważністьM SK1 публікує "неważне :півмик МSK4 повідомленняMSC5 кожен вузол видаляє ключ з його локального IMemoryCacheМSK6

  • Сканувати з патернами: СкануванняM SK1 KEYS слід уникати в прод хаотних маршрутах; добре для набору інструментів адміністрації на маленьких куточках

Практичні помічники

  • IMemoryCache get-or-set with optionsM SK2
    T GetOrAdd<T>(IMemoryCache cache, string key, Func<ICacheEntry, T> factory)
      => cache.GetOrCreate(key, e =>
      {
          e.AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(10);
          e.SlidingExpiration = TimeSpan.FromMinutes(2);
          e.Priority = CacheItemPriority.Normal;
          e.Size = 1;
          return factory(e);
      });
    
  • IDistributedCache with JSON and expiration:
    static async Task<T?> GetOrSetJsonAsync<T>(IDistributedCache cache, string key, Func<Task<T>> factory, TimeSpan ttl)
    {
        var json = await cache.GetStringAsync(key);
        if (json is not null)
            return System.Text.Json.JsonSerializer.Deserialize<T>(json);
    
        var value = await factory();
        var opts = new DistributedCacheEntryOptions { AbsoluteExpirationRelativeToNow = ttl };
        await cache.SetStringAsync(key,
            System.Text.Json.JsonSerializer.Serialize(value),
            opts);
        return value;
    }
    

Мониторинг і видимість

  • Шляховий удар МСК0 частота і середня тривалість завантаження помилок МSK1 показники випробовування ( Прометеусові рахунки) на одну ключову групуМSK4
  • Додайте журналування навколо популяції та зворотнього зв 'язку з виведенням для IMemoryCache.
  • Для Redis, відхилення від часового коду, hits keyspace /misses МSK2 затримка, , і фрагментація пам 'яті

real-World IMemoryCache Patterns з виробництва

Ось як я насправді користуюся IMemoryCache в своїй блоговій платформі. МСК1 еволюціонував шляхом спроб і помилок. МSK2 Я покажу вам три справжні моделі, від простих до складних.

Модель 1: Проста кэша МSK1 замість рідкого МSK2вимінювання даних (КатегорииM SK4

Це була моя перша implementaціяキャッシュування. Категорії блогів не змінюються ' не змінюють часто МSK2 таким чином, вони зберігаються вキャッシュі протягом МSK3 хвилин M SK4

// From BaseController.cs
private const string CacheKey = "Categories";

private async Task<List<string>> GetCategories()
{
    baseControllerService.MemoryCache.TryGetValue(CacheKey, out var value);

    if (value is List<string> categories) return categories;

    logger.LogInformation("Fetching categories from BlogService");
    categories = (await BlogViewService.GetCategories(true)).OrderBy(x => x).ToList();
    baseControllerService.MemoryCache.Set(CacheKey, categories, TimeSpan.FromMinutes(30));
    return categories;
}

Чому це працює:

  • Категорії читаються на кожній сторінці (показано в навігаціїM SK1
  • Вони рідко змінюються ( тільки тоді, коли я додаю нові блогові статті з новими категоріямиM SK1
  • 30-minute TTL fine; if new categories appearM SK2 users see them within 30 minutes
  • Абсолютне закінчування лише (без слизівM SK1 тому що нам не байдуже, як часто він accessed

Я вас бачив: Спочатку я використовував струнний ключ "КатегорииM SK1 Все працює добре, доки у вас не буде кількох контроллерів і один випадково не використовує той самий ключ

Уявлення: 2: Завжди МSK1установлення користувача з обмеженнями розміру та скороченням терміну витрачування МSK2Задачі перекладу )

Це зберігає статус перекладу для кожного користувача. ЦеM SK1 складніше, тому що він потребує обмежень і повинен залишатися живим, поки пользователь активний:

// From TranslateCacheService.cs - tracks translation tasks per user
public void AddTask(string userId, TranslateTask task)
{
    CachedTasks CachedTasks() => new()
    {
        Tasks = new List<TranslateTask> { task },
        AbsoluteExpiration = DateTime.Now.AddHours(6)
    };

    if (memoryCache.TryGetValue(userId, out CachedTasks? tasks))
    {
        tasks ??= CachedTasks();
        var currentTasks = tasks.Tasks;

        // Keep only the 5 most recent tasks
        currentTasks = currentTasks.OrderByDescending(x => x.StartTime).ToList();
        if (currentTasks.Count >= 5)
        {
            var lastTask = currentTasks.Last();
            currentTasks.Remove(lastTask);
        }

        currentTasks.Add(task);
        currentTasks = currentTasks.OrderByDescending(x => x.StartTime).ToList();
        tasks.Tasks = currentTasks;

        memoryCache.Set(userId, tasks, new MemoryCacheEntryOptions
        {
            AbsoluteExpiration = tasks.AbsoluteExpiration,
            SlidingExpiration = TimeSpan.FromHours(1) // Extends on access
        });
    }
    else
    {
        var absoluteExpiration = DateTime.Now.AddHours(6);
        var cachedTasks = CachedTasks();
        memoryCache.Set(userId, cachedTasks, new MemoryCacheEntryOptions
        {
            AbsoluteExpiration = absoluteExpiration,
            SlidingExpiration = TimeSpan.FromHours(1)
        });
    }
}

Чому це відрізняється:

  • Вичерпнення Sliding: Якщо пользователь постійно перевіряє статус перекладу , зберігає пам 'ять в пам' яті до МSK2 годин максимум
  • Ограничення розміру: Залишити тільки 5 найновіші завдання на одного користувача, щоб запобігти bloat пам 'яті
  • Ручне управління: Я явно обмежую розмір, тому що Меморіа-Каш не вводить запису

помилка, яку я зробила Спочатку я не обмежував число завдань.

Торгівля Це стане проблемою, якщо я перейду до IDistributedCache (Redis ) або залишаю в базі даних з індикатором на ім 'я користувача.

Модель 3: Cache with observability (Metrics cachingM SK2

Це аналітика, що відстежує ефективністьキャッシュу за допомогою відстеження Serilog:

// From UmamiDataSortService.cs - caches Umami analytics metrics
public async Task<List<MetricsResponseModels>?> GetMetrics(DateTime startAt, DateTime endAt, string prefix = "")
{
    using var activity = Log.Logger.StartActivity("GetMetricsWithPrefix");
    try
    {
        var cacheKey = $"Metrics_{startAt:yyyyMMdd}_{endAt:yyyyMMdd}_{prefix}";

        if (cache.TryGetValue(cacheKey, out List<MetricsResponseModels>? metrics))
        {
            activity?.AddProperty("CacheHit", true);
            return metrics;
        }

        activity?.AddProperty("CacheHit", false);
        var metricsRequest = new MetricsRequest
        {
            StartAtDate = startAt,
            EndAtDate = endAt,
            Type = MetricType.url,
            Limit = 500
        };

        var metricRequest = await dataService.GetMetrics(metricsRequest);
        if (metricRequest.Status != HttpStatusCode.OK) return null;

        var filteredMetrics = metricRequest.Data
            .Where(x => x.x.StartsWith(prefix))
            .ToList();

        cache.Set(cacheKey, filteredMetrics, TimeSpan.FromHours(1));

        activity?.AddProperty("MetricsCount", filteredMetrics?.Count() ?? 0);
        activity?.Complete();
        return filteredMetrics;
    }
    catch (Exception e)
    {
        activity?.Complete(LogEventLevel.Error, e);
        return null;
    }
}

Що робить це виробництво

  • Обсервабельність: Serilog Тренування активності відслідковує заход в кэші / частота помилок та кількість записів
  • Комп 'ютерний ключ: Включає діапазон дати та префикс, щоб уникнути зіткнення ключів
  • Форматування: Використовується yyyyMMdd формат у ключі так, що різні часи того ж дня діляться в кэші
  • Керування нульовою: Возв 'язує нуль, якщо в' язичний сервіс зазнає невдачі
  • Перехрещена кэшування: Захищає відфільтрований результатM SK1 не сирий відгук

Еволюція: Спочатку я встановив Cache на 10 хвилини . Але метрики Умамі складні для завантаження і не змінюють багато МSK2 M SK3 отже, МSK4 час непоганий . Я виявив це, дивлячись на дані SerilogTracing та побачивши надмірні пропущення Cache

Наслідування в дії: В Seq ( мій агрегатор журналівM SK1 я можу задати питання:

ActivityName = "GetMetricsWithPrefix" and CacheHit = false

Це вказує на мою частоту пропущених помилок в кэші. Якщо ця частота є високоюM SK1 , Я підлаштовую TTL або ключову стратегію.

Порівняння трьох підходів

Pattern Usage Case МSK2 Expiration МSK3 Size Control
Kategoriї Глобальна МSK1 рідко МSK2 змінюва M30 мінімальна абсолютна МСК5 Непотрібна
Перетворення Для МSK1 для користувача МSK2 обмежені M6 абсолютні एमСК5 \ МСК6 слизування \ MСК7 Ручна МСК8 توکي макс.
Метріка дорогі зовнішні дзвінки МSK1 1h абсолютні МSK3 природний мSK4 час M- вітровий МСК6 МСК7 повне відстеження МПС8

Головні уроки:

  1. Почнемо з простого ( шаблону 1), додайте складність тільки тоді, коли це потрібно
  2. Потрібно завжди думати про використання пам 'яті в кэші - додавати обмеження розміру для кожного -user caches
  3. Для дорогих операцій, додайте видимість з першого дня
  4. just TTL на основі реальної частоти змін даних, не вигадує

Коли я не користуюсь системою IMemoryCache,

  • Для状态 аутентифікації користувача (замість цього заявки у cookie authM SK1
  • Для корзини ( використовували б DB
  • Для контенту блогу: (на даний момент в DBM SK1 завантажений один раз на żądaння)
  • Кросс-залежність сервера M SK1 потребуватиме IDistributedCache

Аuthentication Cookies and Claims

  • Сфера дій: по всіх запитах до истечения терміну /записM SK2вийшло
  • Використовувати для: ідентичностіM SK1 грубих ролей / можливостей МSK3 невелику кількість даних про профиль
  • ТоргівляМСК0оффиМSK1 розмір печеньМСК2 неМ СК3не надлишокМсК4 roszczenia мають бути стабільнимиМSК5

Установити cookie auth:

builder.Services.AddAuthentication("Cookies")
    .AddCookie("Cookies", o =>
    {
        o.LoginPath = "/login";
        o.Cookie.SecurePolicy = CookieSecurePolicy.Always;
        o.SlidingExpiration = true;
    });
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();

Підпис:-встановлюйте ствердження: M SK1MVC /minimal МSK3

app.MapPost("/login", async (HttpContext ctx) =>
{
    var claims = new[]
    {
        new Claim(ClaimTypes.NameIdentifier, "123"),
        new Claim(ClaimTypes.Name, "Alice"),
        new Claim(ClaimTypes.Role, "Admin")
    };
    var identity = new ClaimsIdentity(claims, "Cookies");
    await ctx.SignInAsync("Cookies", new ClaimsPrincipal(identity));
    return Results.Redirect("/");
});

Прочитайте вимоги ( будь-який стег ):

[Authorize]
app.MapGet("/me", (ClaimsPrincipal user)
  => Results.Ok(new { user.Identity!.Name, Roles = user.Claims.Where(c => c.Type == ClaimTypes.Role).Select(c => c.Value) }));

JWT / Знаcznikи Bearer

  • Об 'єм: клієнт переносить токен; безстатовий сервер
  • Використовувати для: SPAsM SK1mobile/APIs , crossMSC4domainMST5 мікросервисів
  • Торгівля-оффиM SK1 розмір символаМSK2 обертання МSK3 переробка ; збереження мінімальних прав на товар , використання інтроспекції, якщо необхідно
builder.Services.AddAuthentication("Bearer")
   .AddJwtBearer("Bearer", o =>
   {
       o.Authority = "https://demo.identityserver.io"; // example
       o.Audience = "api";
       o.RequireHttpsMetadata = true;
   });

Використовуйте:

[Authorize(AuthenticationSchemes = "Bearer")]
app.MapGet("/secure", () => "ok");

Обзор Сирена:

sequenceDiagram
  participant C as Client
  participant STS as Token Service
  participant API as API
  C->>STS: Authenticate (username/password)
  STS-->>C: JWT (signed)
  C->>API: GET /secure (Authorization: Bearer <jwt>)
  API->>API: Validate signature, expiry, audience
  API-->>C: 200

Стабільний стан: База даних та друзі

  • Об 'єму: назавжди M SK1доки ви його не видалите
  • Використовуйте для: будь-що, що не повинно бути втраченоM SK1 корзини , замовлення
  • Patterns: стандартний CRUD з EF Core ; CQRS; event sourcingM SK3 outbox pattern for reliability

Конструкція Коріння EF:

builder.Services.AddDbContext<AppDb>(o => o.UseSqlServer(cs));

app.MapPost("/cart/items", async (AppDb db, AddItem cmd) =>
{
    var cart = await db.Carts.FindAsync(cmd.CartId) ?? new Cart(cmd.CartId);
    cart.Add(cmd.ProductId, cmd.Qty);
    await db.SaveChangesAsync();
    return Results.Created($"/cart/{cart.Id}", cart);
});

Caching відповідей , ETags, та умови

  • Не обов 'язково “state carrying,”, але зменшує повторюваність роботи, дозволивши клієнту /proxies повторно використовувати попередні відповіді M SK3 Часто в парі з питанням MSC4route state .
builder.Services.AddResponseCaching();
var app = builder.Build();
app.UseResponseCaching();

app.MapGet("/products", (HttpContext ctx) =>
{
    ctx.Response.GetTypedHeaders().CacheControl = new CacheControlHeaderValue { Public = true, MaxAge = TimeSpan.FromSeconds(30) };
    return Results.Ok(new[] { new { Id = 1, Name = "Widget" } });
}).CacheOutput();

Ось приклад ETag:

app.MapGet("/resource", (HttpContext ctx) =>
{
    var version = "W/\"abc123\""; // compute based on data hash
    ctx.Response.Headers.ETag = version;
    if (ctx.Request.Headers.IfNoneMatch == version)
        return Results.StatusCode(StatusCodes.Status304NotModified);
    return Results.Text("payload");
});

РеакціюCache vs OutputCache: РеальнийM SK1 Світове використання в produkcji

Я використовую як ResponseCache, так і OutputCache разом у своєму блогі для різних цілей.

Заплутаність: Два атрибути шифруванняM SK1

ASP.NET Кора має дві подібні-виглядливі системи шифруванняM SK1

  1. ResponseCache (HTTP Caching): Встановлює заголовки HTTP (Cache-Control, Vary) говорить браузерам та CDN про те, як зберігати дані в кэші
  2. OutputCache (server-sideM SK2: Захищає відтворений результат на сервері, щоб повністю відмовитися від виконання дії

Вони доповнюють одне одного. ResponseCache керує klientом/CDN Caching; OutputCach керує сервером -side caching МSK3

Моя робота на blogu (застосовані обох кэшівM SK1

// From BlogController.cs
[Route("{slug}")]
[HttpGet]
[ResponseCache(Duration = 300, VaryByHeader = "hx-request",
    VaryByQueryKeys = new[] { nameof(slug), nameof(language) },
    Location = ResponseCacheLocation.Any)]
[OutputCache(Duration = 3600, VaryByHeaderNames = new[] { "hx-request" },
    VaryByQueryKeys = new[] { nameof(slug), nameof(language) })]
public async Task<IActionResult> Show(string slug, string language = "en")
{
    var post = await blogViewService.GetPost(slug, language);
    if (post == null) return NotFound();

    // ... populate user info, comments, etc ...

    if (Request.IsHtmx()) return PartialView("_PostPartial", post);
    return View("Post", post);
}

Що відбувається, коли хтось просить /blog/my-post:

  1. Спочатку перевіряє OutputCache: Чи є у мене Cache response для my-post + en мова?

    • Штурм: Знову заキャッシュованим HTML МSK1 метод дії ніколи не працює.
    • Місс: Втілити діюM SK1ទិដ្ឋភាព рендерування, результатキャッシュу для МSK3 секунд МSK4 годині )
  2. ResponseCache визначає заголовки: Після того, як OutputCache генерує реакцію , ResponseCache додає

    Cache-Control: public, max-age=300
    Vary: hx-request
    
  3. Обстежнення браузера: Веб-браузер зберігає реакцію на МSK1 секунду МSK2 хвилини ). Наступні запити одного і того ж користувача не дають ані ', ані серверу

  4. Кэшування CDN ( якщо ви використовуєте Cloudflare /Свидко МSK2 Cache CDN на МSK3 хвилини M SK4 По всьому світу користувались CDN

Чому різні тривалості? M SK1 проти 3600)

[ResponseCache(Duration = 300)]    // 5 minutes client/CDN cache
[OutputCache(Duration = 3600)]     // 1 hour server cache

Припущення:

  • Cache сервера довше (1 час): Я керую своїм серверомM SK1 Я можу очистити кэш, якщо я доставляю повідомлення
  • Клітенський кэш коротший (5 хвилиниM SK1: Я можу ' не очистити браузери або CDNs легко МSK2 МSK3 хвилина - це раціональне вікно безладності
  • Торгівля: Якщо я редагую пост, з 'являється новий змістM SK2
    • Сервер-ззовніM SK1 миттєво МSK2 Я можу зробити кэш недействований)
    • CDN/браузериM SK1 Впродовж 5 хвилин МSK3 або я ручно очищую CDN

Еволюція: Спочатку у мене були обидві на 5 хвилині. Але це означало, що мій сервер переM SK2 віддавав кожну 5 хвилину, хоча зміст рідко змінювався.

  • Сервер щасливо виконує вキャッシュі HTML на час 1
  • Клиенти отримують свіжий-досталь контенту кожного M SK1 хвилин

VaryByHeader для HTMX

VaryByHeader = "hx-request"  // ResponseCache
VaryByHeaderNames = new[] { "hx-request" }  // OutputCache

Чому це важливо: Запити HTMX включають hx-request: true заголовок. Я повертаю різні відповіді

  • Повний запит: Полне HTML-сторінку з розкладом
  • HTMX запит: Частковий вид без макету

Без VaryBy, кэш поверне неправильний формат VaryBy, Я встановлюю дві версії кожного сторінки

Наприклад:

User requests /blog/my-post → Cache key: "blog/my-post:en:hx=false" → Full HTML cached
HTMX requests /blog/my-post → Cache key: "blog/my-post:en:hx=true" → Partial HTML cached

ВарyByQueryKeys для мови та веб-сторінації

[ResponseCache(VaryByQueryKeys = new[] { nameof(slug), nameof(language) })]
[OutputCache(VaryByQueryKeys = new[] { nameof(slug), nameof(language) })]

Проблема без цього: /blog/my-post?language=fr була б доступна англійською версією Cache.

За допомогою ключів VaryByQuery: Відокремлені записи в кэші:

  • /blog/my-post?language=en → Кліпка кэшу включає в себе "enM SK2
  • /blog/my-post?language=fr → Ключ кэшу включає в себе "frM SK2

Справжнє використання з мого списку блогів:

[Route("blog")]
[ResponseCache(Duration = 300, VaryByHeader = "hx-request",
    VaryByQueryKeys = new[] { "page", "pageSize", "startDate", "endDate", "language", "orderBy", "orderDir" })]
[OutputCache(Duration = 3600, VaryByHeaderNames = new[] { "hx-request" },
    VaryByQueryKeys = new[] { "page", "pageSize", "startDate", "endDate", "language", "orderBy", "orderDir" })]
public async Task<IActionResult> Index(int page = 1, int pageSize = 20, /* ... */)

Застереження від вибуху карточки: Кожна унікальна комбінація параметрів = окремий запис в кэшіM SK1

  • page=1&pageSize=20&language=en → Один запис
  • page=2&pageSize=20&language=en → Інший запис
  • page=1&pageSize=10&language=en → Інший запис

Полегшення:

  • Reasonable max cache size (OutputCache autoMSL1evicts leastM SL2recentlyMsl3usedMLS4
  • Найпоширеніші параметри заキャッシュом (страна МSK1 початкова сторінкаSizeM SK2
  • Незвичайні комбінації можуть пропустити Cache (acceptableM SK1

Потрібне встановлення

ResponseCache працює з коробки,, але для OutputCache вам потрібно налагодити:

// Program.cs
builder.Services.AddOutputCache(options =>
{
    options.MaximumBodySize = 64 * 1024 * 1024; // 64 MB max response size
    options.SizeLimit = 100 * 1024 * 1024; // 100 MB total cache size
});

var app = builder.Build();
app.UseOutputCache(); // Must be in middleware pipeline

Коли OutputCache не допомагає

OutputCache пропущено для:

  • Authenticated requests (різноманітні користувачі бачать різні даніM SK1
  • POST/PUTM SK1DELETE (only GET/HEAD cachedMSC4
  • Відповіді з Set-Cookie заголовок
  • Відповіді, які явно Cache-Control: no-store

Наприклад, коли я не користуюся ним.

// Comment submission - authenticated, POST, and per-user
[HttpPost]
[Authorize]
public async Task<IActionResult> AddComment(CommentModel model)
{
    // No caching attributes - this is user-specific and changes state
}

вимірювання ефективності

Я використовую метрики Prometheus (, представлені через мою програмуM SK1 для відстеження

// Pseudo-code for metrics
cache_hits_total{cache="output"} 45230
cache_misses_total{cache="output"} 892

Моє число ударів в кэші: M SK1 для блогових постів ( найбільший трафик повторює ті самі популярні пости

Враження:

  • Безキャッシュу: M SK1м середній час реагування (DB query МSK3 Markdown rendering)
  • З OutputCache: M SK1ms дляキャッシュованих відповідей
  • 25x прискорення

Коли я тимчасово вимикаю кэшування

Іноді я'встановлюю неполадки і потребуєм нових відповідей кожного разуM SK1

// During development, comment out caching
// [ResponseCache(Duration = 300, ...)]
// [OutputCache(Duration = 3600, ...)]
public async Task<IActionResult> Show(string slug, string language = "en")

Або використати навколишнє середовище

#if DEBUG
    // No caching in development
#else
    [ResponseCache(Duration = 300, ...)]
    [OutputCache(Duration = 3600, ...)]
#endif

Кращий підхід Використовуйте конфігурацію:

[ResponseCache(Duration = responseCacheDuration, ...)]

де responseCacheDuration є 0 в розробці МSK1 МSK2 у produkcji .

Привілеї та мінуси цієї двойної стратегії

Прос:

  • Ефективність сервера: OutputCache зменшує obciążenie procesorа / DB МSK2
  • Кращі переваги Client/CDN: ResponseCache зменшує мою пропускну спроможність і покращує глобальну затримку
  • Гнучкість: Різні TTL для сервера проти клієнта
  • Заощадження: Менше запитів на базу данихM SK1 менше пропускної спроможності

Згоди:

  • Нестабільність: Обновлення контенту займають до МSK1 хвилин для передачі до клієнтів
  • Складність неvaliда Cache: Обновляючи пост, потрібно зробити непотрібними як сервер, так і кэши CDN
  • Використовування пам 'яті: OutputCache зберігає відтворений HTML в пам 'яті сервера
  • Виліковування заплутань: Іноді cache забувається і цікаво, чому зміни не з 'являються

Коли I'd перекидає кэшування

  • Цифри реального дня-time data
  • Індивидуалізований контент (пользователь-конкретні рекомендаціїM SK2
  • Низкий -трафікові сторінки (caching надрахунків МSK2 перевага МSK3
  • Страницы, які змінюються дуже часто

Мій вирок: Для блогу з більшістю-статичним змістом і високою читабельністюM SK1соотношенням запису, подвійне шифрування - величезна перемога . Я б не використовував це на панелях адміністрації чи панелях dashboards з швидко змінюваними даними МSK5


ViewBag, ViewDataM SK1 і TempData : Controller-toMSC4View State Mska5and why I mostly avoid two of themM Ska6

Ці три поняття часто заплутані.

Троє друзів порівнювали

// ViewData: string-keyed dictionary
ViewData["Title"] = "Blog";
ViewData["Categories"] = new List<string> { "ASP.NET", "C#" };

// ViewBag: dynamic wrapper around ViewData
ViewBag.Title = "Blog";
ViewBag.Categories = new List<string> { "ASP.NET", "C#" };

// TempData: survives one redirect (backed by session or cookie)
TempData["Message"] = "Post saved!";
return RedirectToAction("Index");
Функція МSK1 Базини даних МSK2 База зору TempData
Тип ViewDataDictionary динамічний МSK1 ITempDataDictionary
Життя Текучий запит МSK1 Тековий запит ♫ ♫ Один перенаправлення ♫ МSK3 ♫
Ключовий доступ Стриньові ключі
Безпека типу Ніхто МSK1 непотрібні сигнали МSK2 МСК3 Непотрібний СМСК4 динамічний ММСК5
Compile-time checking МSK0 Ні Ні
Перенаправлятися, щоб вижити МSK0 Ні Ні

Що я насправді використовую: ViewBag для глобальних данихレイアウトу

У своєму блогі, Я використовую ViewBag виключно для передачі даних від контроллерів до спільного макету. M SK1аналитикаМSK2 категорії, і т.д.

// From BaseController.cs - runs before every action
public override async Task OnActionExecutionAsync(ActionExecutingContext filterContext,
    ActionExecutionDelegate next)
{
    logger.LogInformation("OnActionExecutionAsync");

    if (!Request.IsHtmx())
    {
        // Analytics settings for layout
        ViewBag.UmamiPath = AnalyticsSettings.UmamiPath;
        ViewBag.UmamiWebsiteId = AnalyticsSettings.WebsiteId;
        ViewBag.UmamiScript = AnalyticsSettings.UmamiScript;
    }

    logger.LogInformation("Adding categories to viewbag");
    ViewBag.Categories = await GetCategories(); // Cached list

    await base.OnActionExecutionAsync(filterContext, next);
}

Тоді в моєму макеті (_Layout.cshtml):

@if (ViewBag.Categories is List<string> categories)
{
    <nav>
        @foreach (var cat in categories)
        {
            <a asp-controller="Blog" asp-action="Category" asp-route-category="@cat">@cat</a>
        }
    </nav>
}

@if (!string.IsNullOrEmpty(ViewBag.UmamiPath))
{
    <script async src="@ViewBag.UmamiScript"
            data-website-id="@ViewBag.UmamiWebsiteId"></script>
}

Чому ця модель працює:

  • Глобальна: Кожна сторінка потребує категорій навів та аналізу
  • Один раз: Базована контроллера запускається перед кожним кроком
  • Оптимізація HTMX: Перейдете до сценаріїв аналізу на частинних запитах
  • Захований: Категорії зберігаються вキャッシュі ( погляньте на мій IMemoryCache-pattern нагорі

Я зробив помилку на ранній стадії. Я збирався ViewBag.Categories в кожному методі поведінки. Зрушення DRY і легко забутиM SK1 Перенести його до OnActionExecutionAsync в базовому контроллері розв 'язали це.

Базина для сторінки-конкретні дані M SK1прийнятний візерунокМSK2

// From BlogController.cs
[Route("category/{category}")]
public async Task<IActionResult> Category(string category, int page = 1, int pageSize = 10)
{
    ViewBag.Category = category; // Used in view for heading
    ViewBag.Title = category + " - Blog"; // Used in layout <title>

    var posts = await blogViewService.GetPostsByCategory(category, page, pageSize);
    // ... populate posts model ...

    if (Request.IsHtmx()) return PartialView("_BlogSummaryList", posts);
    return View("Index", posts);
}

Перед вами:

@{
    ViewData["Title"] = ViewBag.Title; // Standard MVC convention for <title>
}

<h1>Category: @ViewBag.Category</h1>

Це нормально, тому що

  • Прості скалярні значення (string, intM SK2
  • Використовується лише в зображенні, не передається
  • Альтернатива - додавати Title і Category властивостей для кожної моделі зору

Що я уникав: Комплексних об 'єктів в ViewBag

Анти-- pattern:

// DON'T DO THIS
ViewBag.User = new UserViewModel { Name = "Scott", IsAdmin = true };
ViewBag.Posts = new List<Post> { ... };
ViewBag.Metadata = new { Tags = new[] { "a", "b" }, Date = DateTime.Now };

Проблеми:

  • Немає комп 'ютера-безпека часу M SK1типо ViewBag.Usr не працює в часі запуску)
  • Нелегко відстежувати, які дані доступні для перегляду
  • Складніше тестувати. (мусить перевіряти словник ViewBag
  • Немає інтелектуального розуму

Краще: СильнішеM SK1друковані моделі зору:

// DO THIS instead
public class BlogIndexViewModel : BaseViewModel
{
    public string Category { get; set; }
    public List<PostSummary> Posts { get; set; }
    public PaginationInfo Pagination { get; set; }
}

public IActionResult Category(string category, int page = 1)
{
    var model = new BlogIndexViewModel
    {
        Category = category,
        Posts = await GetPosts(category, page),
        // Inherited from BaseViewModel:
        Authenticated = user.LoggedIn,
        Name = user.Name,
        AvatarUrl = user.AvatarUrl
    };
    return View("Index", model);
}

TempData: Я не користуюсь M SK1 я не користуюся ним ( а тут МSK3 чому?

Стандартний випадок використання TempData:

[HttpPost]
public IActionResult SavePost(PostModel model)
{
    // Save post...
    TempData["SuccessMessage"] = "Post saved successfully!";
    return RedirectToAction("Index");
}

public IActionResult Index()
{
    // TempData["SuccessMessage"] available here (consumed on read)
    return View();
}

Чому я не користуюся TempData в своєму блогі?

  1. Я використовую HTMX замість перенаправок: Мої бланки надсилаються через HTMX і повертають частинні зображення з успіхом в лініїM SK1повідомлення про помилки
[HttpPost]
public async Task<IActionResult> Submit(ContactViewModel model)
{
    if (!ModelState.IsValid)
        return PartialView("_ContactForm", model); // Show errors inline

    await sender.SendEmailAsync(contactModel);

    // Return success view directly (no redirect)
    return PartialView("_Response", new ContactViewModel
    {
        Email = model.Email,
        Name = model.Name,
        Comment = "Message sent!"
    });
}
  1. Для традиційного PRG (ПоштаM SK1Рерект+-Гет=), Я б використовував TempData. Але мені краще уникати перенаправок, коли це можливо для кращого UXM SK2

Коли TempData має сенс:

  • Традиційні додатки MVC з повним перенаправленням сторінки після POST
  • Multi-step wizards, де ви перенаправляєте між кроками
  • Flash-повідомлення після перенаправки аутентифікації

TempData підтримала вас: (по замовчуванню підкріплений кукиками ASPM SK1NET Core 2.0). Якщо ви поміщаєте великі об 'єкти в TempData, виMSC4 відбиваєте куки, що надсилаються з кожним запитом МSK5 Для великих об' єктів МSK6 використовуйте сеанс із запасом підтримки або DB

Дерево швидкого прийняття рішень

flowchart TD
    A[Need to pass data to view?] --> B{What kind?}
    B -->|Global layout data| C[ViewBag in BaseController]
    B -->|Simple page-specific| D[ViewBag in action]
    B -->|Complex model| E[Strongly-typed ViewModel]
    B -->|Survive redirect| F{Using HTMX?}
    F -->|Yes| G[Return partial with message]
    F -->|No| H[TempData for flash message]

Мої правила:

  1. Бажа для глобального макету (аналитикаМSK1навігаціяM SK2 хлібні кромики)
  2. Видова сумка для простих заголовків сторінок/головки (опціональноM SK1 може використовувати ViewModel)
  3. Ніколи ViewBag для складних об 'єктів (используйте візуальні моделіM SK1
  4. Ніколи не переглядайте дані (ViewBag має кращий синтаксисM SK1
  5. TempData тільки якщо ви дійсно потребуєте PRG ( Я не знаюM SK1t, завдяки HTMXMSC3

Модель: Вказівники і багатовиходніM SK1Поступні потоки

Який штат має використовувати?

flowchart TD
  A[Start Wizard] --> B{Short-lived?\nSingle browser?}
  B -- Yes --> S[Session/TempData]
  B -- No/Complex --> D[DB + key in route]
  S --> PRG[Use PRG between steps]
  D --> PRG
  • Невеликий , один МSK1session МSK2 Сессія або TempData між кроками .
  • Крестовий-пристрійM SK1довгий-запускMSC3 продовжують працювати в DBМSK4 несуть ключ у URL МSK5

До прикладу (DB + маршрутний ключM SK2

app.MapPost("/wizard/{id}", async (AppDb db, Guid id, StepInput input) =>
{
    var flow = await db.Flows.FindAsync(id) ?? new Flow(id);
    flow.Apply(input);
    await db.SaveChangesAsync();
    return Results.Redirect($"/wizard/{id}/next");
});

Pattern: Flash Messages with TempData

  • Встановити POST; читати раз після перенаправки.
TempData["Flash"] = "Profile saved";
return RedirectToAction("Index");

Різовий вид:

@if (TempData["Flash"] is string flash) {
  <div class="alert alert-info">@flash</div>
}

Модель: Корзина

  • Маленькі корзини: Сессія M SK1 якщо ваша шкала скромна і ви маєте залипані
  • Більші коробки/multiM SK1пристрої: DB + коробкаMSC4ID у cookie або URLMska5 Cache для швидкостіMска6
flowchart LR
  U[User] -- cart-id cookie --> S[Server]
  S --> DB[(Cart Table)]
  S <--> Cache[Distributed Cache]

Безпека, PrywatністьM SK1 та контроль за дотриманням

  • Вивірити всі клієнти-належне місцезнаходженняМSK1запиткаM SK2головки,форми ,cookieMSC5сумки JWTMST6
  • Захищати чутливого клієнта-зберігаючий станM SK1 користуючись захистом даних для видаватих вами файлів cookie; ніколи не зберігаючи секретів у строках запитуМSK3
  • Установити флаги cookie: Secure, HttpOnly, SameSite, IsEssential ( якщо вимагається згодою /функціональна потреба МSK2
  • Знову генерувати аутентифіковані куки при змінах привілеїв; зберігати мінімальні вимогиM SK1
  • Зашифровуйте на відстані для сервера-поручні хранилища, як це потрібноM SK1 забезпечувати ротацію ключів (Кліни захисту даних, Кліни підпису JWTMSC4
  • GDPR /CCPA: забезпечити виведення даних користувача M SK2 шляхи відмивання МSK3 знизити затримку .

Матрица прийняття рішень (Шет для шахрайстваM SK1

classDiagram
  class Items {
    +Per-request only
    +Great for middleware->endpoint handoff
  }
  class QueryRoute {
    +Explicit, linkable
    -User-controlled
  }
  class Headers {
    +Tracing, idempotency
    -Noisy, untrusted
  }
  class Cookies {
    +Persist small prefs
    -Size, perf, consent
  }
  class TempData {
    +One-redirect messages
    -Ephemeral
  }
  class Session {
    +Conversational state
    -Scaling complexity
  }
  class MemoryCache {
    +Fast, in-proc
    -Not shared across instances
  }
  class DistributedCache {
    +Shared across servers
    -Serialization, ops
  }
  class AuthCookieClaims {
    +Identity, roles
    -Don’t overstuff
  }
  class JWT {
    +Stateless, cross-domain
    -Revocation/rotation
  }
  class DB {
    +Durable, authoritative
    -Latency, complexity
  }

Швидкі підрізи:

  • Потрібно один-редіректований спалахM SK1TempData.
  • Потрібно вказівника для багатьох запитів в одній сеансі? Сессія M SK1 або DB + ключ, якщо довгий-запущенняМSK4множина МSK5пристроюMSC6
  • Потрібно масштабування і безстатові API? JWT для індивідуальностіM SK1 DB/DistributedCache для статіMSC3
  • Потрібно передати дані лише всередині трубопроводу? HttpContextM SK1Items.
  • Нам потрібнаキャッシュ для комп 'ютерних пошуків? IMemoryCache локальноM SK1 IDistributedCache across a farm.

MVC vs Razor Pages vs Minimal APIs: Те ж саме, що і , Різні форми

Усі три стеки знаходяться на одних і тих самих примітивах (HttpContext, модельна прив 'язкаM SK2 auth , захист данихМSK4 Приклади powyżej показують, що API відрізняються в основному з точки зору эргономікиMSC5

  • Minimalні API: прив 'язування параметрів від маршруту /queryMSC2bodyM SK3claims; return Results.*.
  • МVCМSK0 атрибути, фільтри МSK2 прив 'язування моделі до дійових параметрів
  • Руйнівні сторінки: обладначі сторінок з прив 'язаними властивостями та вказівниками на тег для генерації зв' язківM SK1форми.

Вони всі мають спільні державні механізми, які обговорювали тут.


Випади та анти-Патерни

  • Хранение великих або чутливих даних у печіках чи TempData.
  • Залежно від в- пам 'яті кэша для правильності M SK1 it ’s a cache
  • Дозволення будувати на основі клієнта-sent route/query flags without server checksM SK2
  • Більше- підживлення аут-куки чи JWT з нестабільними твердженнямиM SK1
  • Сессія без стратегії дистрибуції ( працює локально , розриви в масштабі

Реальний- Світове управління державоюМSK1 Те, що я насправді користуюся M SK2 і не користуюсь

Після того, як я показував вам всі ці варіанти, тут ' це моя чесна оцінка того, що працює в процесі виробництва для моєї блогової платформиM SK2

Мій стег управління штатом (в порядку частотиM SK1

Механізм МSK1 Частота МSK2 Застосувальні випадки Задоволення
Імеморія МSK0 Дуже високий КатегоріїM SK2 метрики, перекладові завдання МSK4 ⭐⭐⭐⭐⭐ Невід 'ємний мSK6
OutputCache Вищий МSK1 Статьи блогу, які надсилають МSK2 списку ⭐⭐⭐⭐⭐ Величезна перемога у перфе
ResponseCache високий МSK1 заголовки HTTP для шифрування МSK2 M⭐⭐⭐⭐ працює з OutputCache МСК4
Бажа для перегляду Середній МSK1 Налаштування параметрів аналітикиM SK2 назви сторінок МSK3 ⭐⭐⭐ Гаразд для простих речей M
Вимагання від auth Середній МSK1 Identія користувачаM SK2 Флаг администратора МSK3 ⭐⭐⭐⭐⭐ Правильний інструмент для аутентифікації МSK5
Маршрут/Попит Середній МSK1 ПекуляціяM SK2 фильтрація МSK3 злитки
База даних Середній МSK1 Статьи в блогіМСК2 коментаріМ СК3 стан МСК4 MSК5 Источник істини МСК6
Куки Трохи нижчий МSK1 Персонажи користувача МSK2 майбутній ) Хіба не потрібний
Заседання Ніколи МSK1 МSK2 ♫ ♫ ♫
TempData МSK0 Ніколи МSK2 \ \ \ МSK4 HTMX позбавляє потреби
HttpContext.Items Ніколи МSK1 МSK2 \❌ Я не мав cases
IDistributedCache МSK0 Ніколи ♫ ♫ МSK2 ♫

Szczegółowі характеристики профів/cons з досвіду виробництва

IMemoryCache ⭐⭐⭐⭐⭐

Що я користуюся ним для:

  • Список категорій (globalM SK1 30 min TTL)
  • Per-наслідування обов 'язків перекладу користувача M SK1h абсолютні + МSK3h слизування МSK4
  • Внешні інтерфейси API (Умами метрикиM SK1 МSK2h TTL)

Найкращі практики:

  • Найшвидший процес (в-процесM SK2
  • Жодних витрат на серіалізацію
  • Reduced DB/API load by ~95%
  • Легко втілити та зрозуміти
  • Обсервабельність за допомогою SerilogTracing

Погані результати: I've hitM SK1

  • Пам 'ять витікає, якщо ви не обмежуєте
  • Виключено при перезапускі aplikacji (прийнятно для мого польотуM SK1
  • Не поділено між серверами (досконалість для одного экземпляруM SK1
  • Невправність таємниці є ручною. (потрібна для видаленняM SK1 явно)

Скалування Якщо я дістануся до декількох серверів, ЯM SK1 мені потрібна IDistributedCache (Redis) для спільного стануMSC4 На даний моментMST5 один сервер MSP6 пам 'ять Cache ідеальнаMSL7

Виходова схема + Реакційна схемa МSK1

Що я користуюся ним для:

  • Здалення блогу: (1 годинний сервер , МSK2 мінімальний клієнтM SK3CDN)
  • Список блогів/страни категорії
  • Дані календаря

Найкращі практики:

  • 25x прискорення МSK0м → МSK2м
  • Шкала до високого дорожнього руху, не втрачаючи сови
  • Відокремлені TTL для сервера проти клієнта
  • Працює безшовно з HTMX (VaryByHeader)
  • вимірюваність впливу за допомогою метрики Прометеуса

Погані результати: I've hitM SK1

  • Заплутаність в розладі (forget cache is on)
  • Експлузија в буфері з багатьма комбінаціями параметрів запиту
  • Окно стійкості (5 min для klientówM SK1
  • Потрібно вручну anulувати поновлення контенту

Найкраще для: Прочитайте-важкі додатки з переважно статичним змістомM SK1 Не підходить для персоналізованого або реального-податкові даніМSK3

Бажа для перегляду ⭐⭐⭐

Що я користуюся ним для:

  • Глобальні дані про макет (аналітикаМSK1 категоріїM SK2
  • Тилі сторінки

Найкращі практики:

  • Прості та швидкі дані для макету-
  • Установити один раз в програмі BaseController, доступно всюди
  • Добре працює з Cached списку категорій

Погані результати: I've hitM SK1

  • Ніяких типів безпеки (похибка автомата в часі запуску )
  • Налякування до надмірного використання складних даних
  • Нелегко перевірити

Правило я дотримуюсь ViewBag для простих скалярів тільки. Комплексні об 'єкти йдуть в ViewModels.

Вимагання від auth ⭐⭐⭐⭐⭐

Що я користуюся ним для:

  • Код користувача, ім 'яM SK1 e-mail , аватар URL
  • Команда адміністратора ( перевіряє sub вимагати від config)

Найкращі практики:

  • Безопасне (у署ненене cookieM SK1Захорона даних)
  • Автоматичний з допомогою ASP.NET Core Identity/OAuth
  • Доступно через User.Claims всюди
  • Слідове закінчування keeps users logged in

Погані результати: I've hitM SK1

  • Ограничення розміру печень (donM SK1не залишків
  • Вимагання статистичні допоки не зареєструвались
  • Якщо я додам твердження (подобне "IsEditorM SK2 мені потрібно переробити МSK3опублікуватиAuth cookie

Найкращі практики: Залишити вимоги мінімальними та стійкими. Не ставляйтеM SK1 не часто - змінювати дані в запитих.

Речі, які я не користуюся

Сессія (ніколи не використовуваласьM SK1

  • Потрібний розподілений магазин (RedisM SK1
  • Додає складності для мінімальної користі
  • : краще задовольняє мої cases
    • Вимагання від auth (ідентичністьM SK1
    • IMemoryCache (короткий -живий станM SK2
    • База даних (тривалий станM SK1

TempData (ніколи не використовувалиM SK1

  • HTMX виключив пост-Redirect-Гет шаблон
  • Форми повертають частину представлень з вхідних повідомлень
  • Немає потреби вижити від перенаправления

HttpContext.Items M SK1николи не використовували ):

  • Haven't мав застосований випадок для кожногоM SK1запити
  • Мій інструмент не обчислює значений для контроллерів
  • Якби мені знадобилося розпізнавати najemця, я б використовувала його

IDistributedCache (ніколи не було використаноM SK1

  • Розгортання одного сервера
  • IMemoryCache відповідає усім потребам
  • Було б використовувати Redis, якщо я масштабуватиму до кількох серверів

Еволюція мого підходу

Фаза 1 МSK1initialM SK2 Жодного кэшування. Кожна просьба зайшла в базу даних і відтворила значок Марка-даун .

Фаза 2 МSK1перша оптимізаціяM SK2 Добавлено IMemoryCache для категорій. Зрозумів негайное зниження obciążenia DBM SK1 Залишав це простим : 30 min TTLMSC4 без фантастичної логіки МSK5

Фаза 3 МSK1 розсіяння нагоруM SK2 Добавлено OutputCache для блогових постів, коли стрімкий потік трафику. Масове покращення продуктивностіM SK1 Початкова помилка : Cached лише на 5 хвилини МSK4 Піднято до МSK5 годину після перегляду показали, що зміст рідко змінюєтьсяMSC6

Фаза 4 МSK1наслідковістьM SK2 Добавлено SerilogTracing до метатримуалів. Помітні пропущені помилки в базі даних були високими через форматування дат у ключахM SK1 Знову форматування ключів yyyyMMdd замість цілої позначки часу. Hit rate went from M SK1 to 95%.

Фаза 5 МSK1 інтеграція HMXM SK2 Добавлено VaryByHeader для hx-request. Спочатку забув про це і подав повні сторінки для HTTPMX запитів

Текущий стан: Щиро дякую за стегні. IMemoryCache M SK1 OutputCach ♫ + ♫ ResponseCache handle ♫98% ♫ моїх потреб у сфері управління штатом ♫ МSK4 ♫ база даних для довготривалого стану ♫МSK5 ♫ Auth claims for identity ♫

Консультація для вашої додатки

Почати тут:

  1. Рута/запроси парам для навігаціїМSK1фільтрування M SK2першу завжди безладна)
  2. Вимагання від Auth про індивідуальність
  3. База даних для чогось, що повинно існувати
  4. IMemoryCache для читання-важких обчислювальних даних
  5. OutputCache для дорогих сторінок

Dodaj, якщо необхідно: 6. Сессія МSK1 тільки якщо ви маєте серверM SK2 сторонній конфронтаційний стан 7. IDistributedCache only when you scale to multiple servers 8. Куки МSK1 для клієнта МSK2 сторонні переваги , згоду

Уникніть:

  • Комплексні об 'єкти в ViewBag/TempData
  • Сессія без розподіленого запасу підтримки
  • Керування користувача-конкретні або частіМSK1вимінювання даних
  • Непередбачувана оптимізація (першу вимірятиM SK1

Головні уроки:

  • Почнемо з простого, додайте складність тільки тоді, коли вимірювання показують, що вам вона потрібна
  • Наслідковість дуже важлива (знайте, які частоти ударів в буфері Cache
  • Подумайте про обмеження масштабу на ранній стадії. (per-комп 'ютерні кэши потребують обмежень
  • Потрібно ретельно перевірити неważністьキャッシュу. ( нестабільність є реальною проблемою
  • Задокументуйте ваші вибори на ТБЗ. ( в майбутньому ви запитаєте: МSK1 чому? МSK2 хвилини ?")

Вгору

Статус у веб-приложениях - це не "'", а one size fits all . МSK1 . Вибирайте найлегшу опцію, яка відповідає вашим потребам. МSK2 , використовуючи безстатові моделі, коли можете. , , висловлюючи свою думку про безпеку і життєвий цикл.

Якщо ви хочете поглянути глибше на те, як ці частинки протікають через канал, то погляньте на мою серію, яка починається з Частина 1: Обзор та основа і, в першу чергу, посередників та маршрутизуючих деталей.

Щасливе будівництво.


Довідник: Ще одна копіяМSK1Празки, які можна записати M SK2Рефиніації)

Ці приклади заглиблюють попередні розділи з деталями виробництва‑ які ви можете вставляти в мережуM SK1 мінімальні шаблони , MVC, або Разор PagesMSC4

Cookies: Protect values with Data Protection

using Microsoft.AspNetCore.DataProtection;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDataProtection();
var app = builder.Build();

app.MapPost("/prefs/secure/{value}", (HttpContext ctx, string value, IDataProtectionProvider dp) =>
{
    var protector = dp.CreateProtector("prefs.theme");
    var protectedValue = protector.Protect(value);
    ctx.Response.Cookies.Append("pref.theme.p", protectedValue, new CookieOptions
    {
        HttpOnly = true,
        Secure = true,
        SameSite = SameSiteMode.Lax,
        Expires = DateTimeOffset.UtcNow.AddYears(1)
    });
    return Results.Ok();
});

app.MapGet("/prefs/secure", (HttpContext ctx, IDataProtectionProvider dp) =>
{
    if (ctx.Request.Cookies.TryGetValue("pref.theme.p", out var v))
    {
        var protector = dp.CreateProtector("prefs.theme");
        return Results.Text(protector.Unprotect(v));
    }
    return Results.NotFound();
});

Напоказ: У мультип 'ютернихM SK1 депозиціях нодів , залишаються ключі захисту даних (eMska4gM Ska5 в об' єднаній файловій системі МSK6 RedisMská7 або Azure Key Vault Мська8 таким чином, щоб куки могли читатися в різних instancjach МСКА9

Антифалсифікація в веб-сторінках MVC, Razor Pages, та Minimal APIs

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
builder.Services.AddRazorPages();
builder.Services.AddAntiforgery(o => o.HeaderName = "X-CSRF-TOKEN");
var app = builder.Build();

app.MapGet("/antiforgery/token", (IAntiforgery af, HttpContext ctx) =>
{
    var tokens = af.GetAndStoreTokens(ctx);
    return Results.Json(new { token = tokens.RequestToken });
});

app.MapPost("/submit", (HttpContext ctx) => Results.Ok("posted"))
   .AddEndpointFilter(async (efiContext, next) =>
   {
       var af = efiContext.HttpContext.RequestServices.GetRequiredService<IAntiforgery>();
       await af.ValidateRequestAsync(efiContext.HttpContext);
       return await next(efiContext);
   });

app.MapControllers();
app.MapRazorPages();
  • MVC: прикрашують дії [ValidateAntiForgeryToken] і використовувати @Html.AntiForgeryToken() у формах.
  • Розмаїття сторінок: по замовчуванню включено на бланкових листахM SK1 використання asp-antiforgery="true" якщо необхідно.
  • Minimal: підтверджує за допомогою IAntiforgery як показано.

Сессія з Redis і sliding проти абсолютного вичерпання

builder.Services.AddStackExchangeRedisCache(o => o.Configuration = "localhost:6379");
builder.Services.AddSession(o =>
{
    o.IdleTimeout = TimeSpan.FromMinutes(20); // sliding
    o.IOTimeout = TimeSpan.FromSeconds(2);
    o.Cookie.HttpOnly = true;
    o.Cookie.IsEssential = true;
});
var app = builder.Build();
app.UseSession();

Store small, compressible data only . Persist real cartsM SK2 orders to a DB.

IMemoryCache з вхідними опціями та зворотним дзвінком для виведення

builder.Services.AddMemoryCache();

app.MapGet("/fx/{pair}", (IMemoryCache cache, string pair) =>
{
    var key = $"fx:{pair.ToLowerInvariant()}";
    return Results.Ok(cache.GetOrCreate(key, entry =>
    {
        entry.AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(10);
        entry.SlidingExpiration = TimeSpan.FromMinutes(2);
        entry.Size = 1; // enable size-based eviction if configured
        entry.RegisterPostEvictionCallback((k, v, reason, state) =>
        {
            Console.WriteLine($"Evicted {k} because {reason}");
        });
        return 0.92m; // fetch from external service in real life
    }));
});

IDistributedCache get‑or‑set with jitter to avoid stampedes

builder.Services.AddStackExchangeRedisCache(o => o.Configuration = "localhost:6379");

app.MapGet("/feature/{name}", async (IDistributedCache cache, string name) =>
{
    var key = $"feat:{name}";
    var cached = await cache.GetStringAsync(key);
    if (cached is not null) return Results.Text(cached);

    // Lock key to prevent thundering herd (very simple approach)
    var lockKey = key + ":lock";
    var gotLock = await cache.SetStringAsync(lockKey, "1", new DistributedCacheEntryOptions
    {
        AbsoluteExpirationRelativeToNow = TimeSpan.FromSeconds(5)
    });

    try
    {
        cached = await cache.GetStringAsync(key);
        if (cached is null)
        {
            var computed = "on"; // expensive work
            var rnd = Random.Shared.Next(0, 15); // jitter
            await cache.SetStringAsync(key, computed, new DistributedCacheEntryOptions
            {
                AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(5).Add(TimeSpan.FromSeconds(rnd))
            });
            cached = computed;
        }
    }
    finally
    {
        await cache.RemoveAsync(lockKey);
    }

    return Results.Text(cached);
});

Для міцного блокування, краще використовувати примітивів Redis (SET NX EXM SK2 через StackExchange .RedisMSC4

Опублікувати та підтвердити JWT локально (demoM SK1

using System.IdentityModel.Tokens.Jwt;
using Microsoft.IdentityModel.Tokens;
using System.Security.Claims;

var key = new SymmetricSecurityKey(System.Text.Encoding.UTF8.GetBytes("super-secret-key-please-rotate"));
var creds = new SigningCredentials(key, SecurityAlgorithms.HmacSha256);

builder.Services.AddAuthentication("Bearer")
    .AddJwtBearer("Bearer", o =>
    {
        o.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = false,
            ValidateAudience = false,
            IssuerSigningKey = key,
            ValidateIssuerSigningKey = true,
            ValidateLifetime = true
        };
    });
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();

app.MapPost("/token", () =>
{
    var claims = new[] { new Claim(ClaimTypes.Name, "alice") };
    var jwt = new JwtSecurityToken(claims: claims, expires: DateTime.UtcNow.AddMinutes(30), signingCredentials: creds);
    var token = new JwtSecurityTokenHandler().WriteToken(jwt);
    return Results.Json(new { access_token = token });
});

app.MapGet("/who", [Microsoft.AspNetCore.Authorization.Authorize] () => "ok");

(IfM SK1Match)

record Todo(int Id, string Title, string Version);
var store = new Dictionary<int, Todo> { [1] = new(1, "Ship", "v1") };

app.MapGet("/todo/{id:int}", (int id, HttpContext ctx) =>
{
    if (!store.TryGetValue(id, out var t)) return Results.NotFound();
    ctx.Response.Headers.ETag = t.Version;
    return Results.Json(t);
});

app.MapPut("/todo/{id:int}", (int id, HttpContext ctx, Todo input) =>
{
    if (!store.TryGetValue(id, out var current)) return Results.NotFound();
    var ifMatch = ctx.Request.Headers["If-Match"].ToString();
    if (string.IsNullOrEmpty(ifMatch) || ifMatch != current.Version)
        return Results.StatusCode(StatusCodes.Status412PreconditionFailed);

    var next = current with { Title = input.Title, Version = $"v{DateTime.UtcNow.Ticks}" };
    store[id] = next;
    ctx.Response.Headers.ETag = next.Version;
    return Results.Ok(next);
});

TempData: складні об 'єкти через JSON

public static class TempDataJsonExtensions
{
    public static void Put<T>(this ITempDataDictionary tempData, string key, T value)
        => tempData[key] = System.Text.Json.JsonSerializer.Serialize(value);

    public static T? Get<T>(this ITempDataDictionary tempData, string key)
        => tempData.TryGetValue(key, out var o) && o is string s
           ? System.Text.Json.JsonSerializer.Deserialize<T>(s)
           : default;
}

// Usage in MVC action
TempData.Put("WizardState", new { Step = 2, Name = "Alice" });
var state = TempData.Get<dynamic>("WizardState");

Знак співпадіння EF Core

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    [Timestamp] public byte[] RowVersion { get; set; } = default!;
}

// On update
try
{
    await db.SaveChangesAsync();
}
catch (DbUpdateConcurrencyException)
{
    return Results.StatusCode(StatusCodes.Status412PreconditionFailed);
}
app.MapPost("/promote", async (HttpContext ctx) =>
{
    var u = ctx.User;
    var claims = u.Claims.ToList();
    claims.Add(new Claim(ClaimTypes.Role, "Editor"));
    var id = new ClaimsIdentity(claims, "Cookies");
    await ctx.SignInAsync("Cookies", new ClaimsPrincipal(id));
    return Results.Ok();
});

Це має покрити прогалини: сильніший дефіцит безпекиM SK1 мультипліденційна ‑ готовность узлов МSK3 та реальні patternи M SK4 світ для кэшів М SK5 टोकони , і умовизовані вимоги MSC7


Deep Dive: HttpContext.Items (Practical Patterns and HelpersM SK3

HttpContext.Items - це пакет для запитів на один ґрант, що живе лише протягом всього життя одного запиту.

  • Життя циклу: створене при запускі на замовленняM SK1 відкинуто, коли реакція закінчується
  • Сфера дій: лише на даний момент запиту M SK1 ніколи не перетинає перенаправки чи фонову роботу.
  • Мощність: OM SK1 пошуки ; ідеальний для кожного-キャッシュування запитів
  • Безпека: серверM SK1 тільки на стороні; невидимий для клієнта .

Чому пункти замість…

  • Сессія/TempData
  • DI Схоплені послуги: Використовуйте їх для поведінки та спільного віддаленостіM SK1 Помічники краще підходить для реклами- hoc , обчислювані цінності МSK4 держатель МSK5 локальний простір користувачаMSC6 флаги властивостей MSL7 і на один учасник мSK8 кэши запитів M.
  • HttpContext.ФатеріалиM SK1 Для системи/транспортуMSC3функціональності рівня MST4IEndpointФатеріїМSK5 IHttpUpgradeФатериали МSK6 Помешки для додатку -податки рівняMスク8

Уникніть зіткнення ключів

Тому що Items використовує об 'єктні ключі, краще приватні статичні ключі об' єкта або виділений тип ключів, щоб уникнути зіткнення наzw.

public static class ItemKeys
{
    public static readonly object TenantId = new();
    public static readonly object UserLocale = new();
    public static readonly object PerRequestCache = new();
}

Або створити зашифровану обкладинку з розширеннями:

public static class HttpContextItemsExtensions
{
    public static void Set<T>(this HttpContext ctx, object key, T value)
        => ctx.Items[key] = value!;

    public static T? Get<T>(this HttpContext ctx, object key)
        => ctx.Items.TryGetValue(key, out var v) ? (T?)v : default;

    public static T GetOrCreate<T>(this HttpContext ctx, object key, Func<T> factory)
    {
        if (ctx.Items.TryGetValue(key, out var existing) && existing is T typed)
            return typed;
        var created = factory();
        ctx.Items[key] = created!;
        return created;
    }
}

Модель: обчислення в середній програміМSK1 споживання в кінцевих точкахM SK2контролери/сторінки

// Program.cs
app.Use(async (ctx, next) =>
{
    var tenant = ctx.Request.Headers["X-TenantId"].FirstOrDefault() ?? "public";
    ctx.Set(ItemKeys.TenantId, tenant); // using extension above

    // Per-request cache holder (optional)
    ctx.Set(ItemKeys.PerRequestCache, new Dictionary<string, object?>());

    await next(ctx);
});

// Minimal API
app.MapGet("/whoami", (HttpContext ctx) => new
{
    Tenant = ctx.Get<string>(ItemKeys.TenantId),
});

// MVC Controller
public IActionResult WhoAmI()
    => Json(new { Tenant = HttpContext.Get<string>(ItemKeys.TenantId) });

// Razor Page handler
public IActionResult OnGet()
    => new JsonResult(new { Tenant = HttpContext.Get<string>(ItemKeys.TenantId) });

Pattern: Per-запроси кэша, щоб уникнути повторюваної роботи

Використовуйте пункти як крихітний кэш, так що повторюваний odczyt відбувається в рамках одного запиту

public static class PerRequestCacheExtensions
{
    public static async Task<T> GetOrAddAsync<T>(this HttpContext ctx, string key, Func<Task<T>> factory)
    {
        var bag = ctx.Get<Dictionary<string, object?>>(ItemKeys.PerRequestCache)
                  ?? ctx.GetOrCreate(ItemKeys.PerRequestCache, () => new Dictionary<string, object?>());

        if (bag.TryGetValue(key, out var val) && val is T hit)
            return hit;

        var created = await factory();
        bag[key] = created!;
        return created;
    }
}

// Usage in endpoint
app.MapGet("/profile", async (HttpContext ctx, IUserRepo repo) =>
{
    var userId = ctx.User.Identity?.Name ?? "anon";
    var profile = await ctx.GetOrAddAsync($"profile:{userId}", () => repo.LoadAsync(userId));
    return Results.Json(profile);
});

Примітки:

  • Розтягування: pojedynczy запит зазвичай виконується на одній логічній ланцюзі ; Помічники не є ’ не потоки M SK3 безпечні для паралельних записів МSK4 Якщо ви починаєте паралельні завдання, які розділяють Поміcznikи, додайте власну синхронізацію MSC6
  • Розмір: Залишити цінності невеликими і дешевими для обчислення /серіалізуватиM SK2 Це’s вMSC4memory per requestMスク5

Формат: Фильтры, які наповнюють Подібні пункти M SK1MVC/Страї РаzorуMSC3

public class TenantFilter : IAsyncResourceFilter
{
    public async Task OnResourceExecutionAsync(ResourceExecutingContext context, ResourceExecutionDelegate next)
    {
        var tenant = context.HttpContext.Request.Headers["X-TenantId"].FirstOrDefault() ?? "public";
        context.HttpContext.Set(ItemKeys.TenantId, tenant);
        await next();
    }
}

// Register filter globally
services.AddControllersWithViews(o => o.Filters.Add<TenantFilter>());

Pattern: Заповнювати журнали без розподілу

Вирахуйте один раз, і читайте в журнальних шкалах або середній програмі.

app.Use(async (ctx, next) =>
{
    var correlationId = ctx.Request.Headers["X-Correlation-Id"].FirstOrDefault() ?? Guid.NewGuid().ToString("n");
    ctx.Items["CorrelationId"] = correlationId; // string key acceptable for app-local use

    using (logger.BeginScope(new { CorrelationId = correlationId }))
    {
        await next(ctx);
    }
});

Коли не використовувати пункти

  • Дані, потрібні після перенаправки або перерозподілу (используйте TempData/SessionM SK2DB замість
  • APP-ширний синтон або перетинM SK1запроси кэшів (используйте IMemoryCache/IDistributedCache
  • Цінності, що належать до ідентичності/аuthorization M SK1use claims /policies).

Швидке правило: Якщо це ’ обчислюється під час цього запиту і читається під цим запитом за допомогою власного коду

Finding related posts...
logo

© 2026 Scott Galloway — Unlicense — All content and source code on this site is free to use, copy, modify, and sell.