Усвідомлення ASP.NET Корінної мережі запити та реагування M SK1 Część 1: Обзор і основа
Введение
ASP.NET - це ядро кожного веб-приложения, що побудовано на цій схемі.
Неважливо, будуєте ви API, веб-приложения, , чи мікросервіси. МSK3, канал завжди є там, МSK4, працює за кулисами, МСК5. Розумівши це глибоко, ми зможемо оптимізувати продуктивність, М СК8, реалізувати перетинні системи, M СК9, елегантно вирішувати проблеми, М S К 10 і ефективніше розв 'язати проблеми, M S К 11
NOTE: Це частина моїх експериментів з штучним інтелектом M SK1 спосіб витрачати МSK2 Calude Code Web credits. ЯMSC4 fed this a BUNCH of papers , my understandingMST6 questions I had to generate this articleM ST7 ItM st8 fun and fills a gap I haven’ t seen filled anywhere elseMst10
Що таке Pipeline Request?
У своєму ядрі – МСК0 – ASP, МСК1 – NET. Порожній канал запити – це низка компонентів, які обробляють HTTP-запити та генерують HTTP-реакції. МSK2 – Погляньте на нього як на транспортер у фабриці. : – Запити входять з одного кінця, МSK4 – проходять через різні станції.
Ця архітектура базується на модель інструментів, де кожна компонента
- Обробка прийдешнього запиту перед тим, як передати його наступному компоненту
- Короткий-оберт трубопроводу шляхом генерації негайної відповіді
- Проаналізувати вихідний відгук після виконання наступного компоненту
Архітектура високого рівня
Дозвольте ' візуалізувати повну архітектуру трубопроводу в ASP.NET Core 8:
flowchart TB
OS[Operating System and Network TCP IP Socket Layer]
Kestrel[Kestrel Web Server HTTP11 HTTP2 HTTP3 QUIC TLS SSL Termination Connection Management]
Host[Host Layer Application Lifetime Dependency Injection Configuration Logging]
subgraph Middleware_Pipeline [Middleware Pipeline]
EH[Exception Handler Middleware catches exceptions]
HTTPS[HTTPS Redirection Middleware redirects HTTP to HTTPS]
Static[Static Files Middleware serves static content]
Routing[Routing Middleware matches request to endpoint]
AuthN[Authentication Middleware validates identity]
AuthZ[Authorization Middleware validates permissions]
Custom[Custom Middleware app specific logic]
EndpointMW[Endpoint Middleware executes matched endpoint]
end
EndpointExec[Endpoint Execution MVC Controllers and Actions Razor Pages Minimal APIs gRPC SignalR]
Response[Response Generation flows back through middleware]
BackKestrel[Back to Kestrel]
Client[Back to Client]
OS --> Kestrel --> Host --> EH --> HTTPS --> Static --> Routing --> AuthN --> AuthZ --> Custom --> EndpointMW --> EndpointExec --> Response --> BackKestrel --> Client
Запроси потоку: Подорож через трубопровод
Дозвольте's слідувати за типовим HTTP запитом, коли він рухається через канал
1. Мережний шар
Коли клієнт звертається до вашої додатки, це приходить на ваш сервер як сирові пакети TCP, /, IP. МSK2 Операційна система, МSK3, встановлює ці пакети у повний HTTP-запрос.
2. Веб-сервер Kestrel
Kestrel, ASPM SK1 NET Core 's cross-platform web server МSK4 отримує запрошення
- Розшифровує HTTP протокол (HTTP/1.1, HTTPM SK2 або HTTP /3)
- Рухає з дешифруванням TLS/SSL, якщо використано HTTPS
- Створює
HttpContextоб 'єкт, який представляє як запит, так і відповідь - Переходи до управління в application'
3. Лаyer میزبانа
Гость надає середовище для виконання. It:
- Управляє тривалістю життя aplikacji
- Допоставляє контейнер ін 'єкції залежності
- Конфигурація постачання та логізована інфраструктура
- Викликає лінію посередників
4. Трубопровод Middleware
Ось звідки починається логіка вашої додатки. Кожна компонента інтерфейсу
- Приймає
HttpContext - Виконує свою специфічну функцію
- Визначає, чи викликати наступне інструментарій, чи коротку-схему
- Можути змінити запит перед тим, як передати його вперед
- Можна змінити відповідь, коли вона повертається
5. Виконка кінцевого пункту
Якщо прохання проходить через весь middleware, то воно досягає кінцевого пункту.
- Реакція контроллера в MVC
- Рухівник сторінок в Розібраних сторінках
- Рухівник в Minimal APIs
- Метод послуг gRPC
- Спосіб узла SignalR
Цей кінцевий пункт виконує вашу ділову логіку і генерує відповідь.
6. Реакційний потік
Реакція повертається назад через лінію посередників у зворотньому напрямку:
- Кожен посередник може перевірити чи змінити реакцію
- Заголовки завершуються
- Орган реагування написаний
- Kestrel відсилає HTTP відповідь назад до клієнта
Request/Diagram послідовності відповідей
sequenceDiagram
autonumber
participant Client
participant OS as OS/Network
participant Kestrel
participant Host
participant MW as Middleware Pipeline
participant Endpoint as Endpoint Execution
Client->>OS: HTTP request
OS->>Kestrel: Forward request
Kestrel->>Host: Create HttpContext
Host->>MW: Invoke pipeline
MW->>Endpoint: Route matched, execute
Endpoint-->>MW: Response
MW-->>Kestrel: Response after post-processing
Kestrel-->>OS: Send HTTP response
OS-->>Client: Response delivered
Головні концепції
Контекст Http
І HttpContext є центральним об 'єктом в трубопроводі
public abstract class HttpContext
{
// The incoming request
public abstract HttpRequest Request { get; }
// The outgoing response
public abstract HttpResponse Response { get; }
// User identity and authentication
public abstract ClaimsPrincipal User { get; set; }
// Request-scoped services
public abstract IServiceProvider RequestServices { get; set; }
// Connection information
public abstract ConnectionInfo Connection { get; }
// WebSocket support
public abstract WebSocketManager WebSockets { get; }
// Request cancellation
public abstract CancellationToken RequestAborted { get; set; }
// Session state
public abstract ISession Session { get; }
// Generic feature collection
public abstract IFeatureCollection Features { get; }
// And more...
}
Все, що вам потрібно знати про поточний запит і все, що потрібно для створення відповіді, доступно через HttpContext.
Мідлервер
Мережне програмування - це будівельний блок трубопроводу.
// Basic middleware signature
public delegate Task RequestDelegate(HttpContext context);
// Middleware can be implemented as a method
app.Use(async (context, next) =>
{
// Do something before the next middleware
Console.WriteLine($"Request: {context.Request.Path}");
// Call the next middleware
await next(context);
// Do something after the next middleware
Console.WriteLine($"Response: {context.Response.StatusCode}");
});
Запрос delegatів
Керівник запиту - це функція, яка може обробляти HTTP-запрос.
public delegate Task RequestDelegate(HttpContext context);
Кожен посередник обгортає наступного delegate,, створюючи вбудований ланцюг дзвінків.
Простий приклад
Давайте подивимось на мінімальну програму ASP.NET Core 8, яка демонструє трубопровод
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
// Middleware 1: Logging
app.Use(async (context, next) =>
{
Console.WriteLine($"[{DateTime.UtcNow:yyyy-MM-dd HH:mm:ss}] Request started: {context.Request.Method} {context.Request.Path}");
await next(context);
Console.WriteLine($"[{DateTime.UtcNow:yyyy-MM-dd HH:mm:ss}] Request finished: {context.Response.StatusCode}");
});
// Middleware 2: Custom header
app.Use(async (context, next) =>
{
context.Response.Headers["X-Custom-Header"] = "Hello from middleware!";
await next(context);
});
// Middleware 3: Short-circuit for specific path
app.Use(async (context, next) =>
{
if (context.Request.Path == "/health")
{
context.Response.StatusCode = 200;
await context.Response.WriteAsync("Healthy");
return; // Short-circuit - don't call next()
}
await next(context);
});
// Endpoint
app.MapGet("/", () => "Hello World!");
app.Run();
Коли ви відвідуєте http://localhost:5000/МSK0 ви ' побачите :
Console output:
[2024-01-15 10:30:45] Request started: GET /
[2024-01-15 10:30:45] Request finished: 200
Browser output:
Hello World!
Response headers:
X-Custom-Header: Hello from middleware!
Коли ви відвідуєте http://localhost:5000/health:
Console output:
[2024-01-15 10:30:50] Request started: GET /health
[2024-01-15 10:30:50] Request finished: 200
Browser output:
Healthy
Response headers:
X-Custom-Header: Hello from middleware!
Зверніть увагу на те, як третій інструмент для посередників - МСК0 - об 'єднав трубу для /health шлях, але всі інструменти, до яких він ще не був запущен
Чому розуміння трубопроводу має значення
Порозуміння трубопроводу є вирішальним, тому що
Оптимізація ефективності: Знання порядку виконання допомагає вам правильно виконувати дорогих операцій і уникнути непотрібної роботиM SK1
Занепокоєння щодо розрізу: Middleware є ідеальним для втілення логінгу
Розладнання: Коли щось пішло не так , Розуміння трубопроводу допомагає вам визначити, де виникла проблема
За замовчанням: Ви можете створити потужне на замовлення посереднє програмне забезпечення для розширення можливостей системи
Безпека: Усвідомлення того, як аутентифікація та авторизація підходять до мережі, є вирішальним для захисту вашої додаткиM SK1
Що' СледующаяM SK1
У цій першій частині ми сформували основу, зрозумівши, що таке трубопровод, як він структурований, як проходять через нього заявки. Ми побачили високу архітектуру і дослідили ключові концепції.
У наступних частинах цієї серії ми зануримося у кожен шар
Частина 2: Сервер і Hosting Layer - МиM SK1 дослідимо конфігурацію Kestrel , запуск хоста МSK3 і те, як налаштувати середовище хостингу
Частина 3: Трубопровод Middleware - Ми ' перевіримо збудовані МSK2 в середній програмі МSK3 навчимося створювати на замовлення середну програму \ , і зрозуміємо, як замовляти середну програму \ МSK5
Частина 4: Маршрутування і кінцеві точки - Ми зробимо висновок, як запити співставляються з кінцевими точками і як працює система маршрутізації кінцевих точок.
Частина 5: MVC, Розібрані сторінкиM SK2 і Minimal APIs - МиM SK1 дослідимо, як різні прикладні моделі виконуються всередині трубопроводу.
Частина 6: Заawansовані трубні зарубки - МиM SK1 дізнаємось про такі заawansовані точки розширення, як
IStartupFilter,IHostedService, та налаштування вихідних джерел даних
Key Takeaways
- ASP.NET Core - це мережа компонентів, що обробляють запити і генерують відповіді
- Middleware може обробляти запити, короткі -об 'єднати трубуM SK2 і змінити відповіді
HttpContextє центральним об 'єктом, який містить всю інформацію про запит та відповідь- Усвідомлення трубопроводу важливе для створення ефективних, безпечних, надійних та підтримливих програм
- Трюбопровод рухається від серверного шару через середній інструмент до кінцевих точок і назад
Трубопровод є елегантним у своїй простоті, але потужним у своїх можливостях.