Gyári alapú köztes szoftver aktiválása a ASP.NET Core-ban

IMiddlewareFactory / IMiddleware egy bővíthetőségi pont a köztes szoftver aktiválásához, amely a következő előnyöket kínálja:

• Aktiválás ügyfélkérésenként (hatókörön belüli szolgáltatások injektálása)
• Köztes szoftver erős gépelése

UseMiddleware bővítménymetelyek ellenőrzik, hogy egy köztes szoftver regisztrált típusa implementál-e IMiddleware. Ha ez megtörténik, a IMiddlewareFactory tárolóban regisztrált példányt használják a IMiddleware megvalósítás megoldására ahelyett, hogy a konvencióalapú köztes szoftver aktiválási logikáját alkalmaznák. A köztes szoftver hatókörrel rendelkező vagy átmeneti szolgáltatásként van regisztrálva az alkalmazás szolgáltatástárolójában.

IMiddleware ügyfélkérésenként (kapcsolatonként) aktiválódik, így a hatókörön belüli szolgáltatások injektálhatók a köztes szoftver konstruktorába.

IMiddleware

IMiddleware az alkalmazás kérési folyamatának köztes szoftverét határozza meg. Az InvokeAsync (HttpContext, RequestDelegate) metódus kezeli a kérelmeket, és visszaad egy olyan értéket Task , amely a köztes szoftver végrehajtását jelöli.

Konvenció szerint aktivált köztes szoftver:

public class ConventionalMiddleware
{
    private readonly RequestDelegate _next;

    public ConventionalMiddleware(RequestDelegate next)
        => _next = next;

    public async Task InvokeAsync(HttpContext context, SampleDbContext dbContext)
    {
        var keyValue = context.Request.Query["key"];

        if (!string.IsNullOrWhiteSpace(keyValue))
        {
            dbContext.Requests.Add(new Request("Conventional", keyValue));

            await dbContext.SaveChangesAsync();
        }

        await _next(context);
    }
}

Köztes szoftver aktiválása:MiddlewareFactory

public class FactoryActivatedMiddleware : IMiddleware
{
    private readonly SampleDbContext _dbContext;

    public FactoryActivatedMiddleware(SampleDbContext dbContext)
        => _dbContext = dbContext;

    public async Task InvokeAsync(HttpContext context, RequestDelegate next)
    {
        var keyValue = context.Request.Query["key"];

        if (!string.IsNullOrWhiteSpace(keyValue))
        {
            _dbContext.Requests.Add(new Request("Factory", keyValue));

            await _dbContext.SaveChangesAsync();
        }

        await next(context);
    }
}

Bővítmények jönnek létre a köztes szoftverhez:

public static class MiddlewareExtensions
{
    public static IApplicationBuilder UseConventionalMiddleware(
        this IApplicationBuilder app)
        => app.UseMiddleware<ConventionalMiddleware>();

    public static IApplicationBuilder UseFactoryActivatedMiddleware(
        this IApplicationBuilder app)
        => app.UseMiddleware<FactoryActivatedMiddleware>();
}

Nem lehet objektumokat átadni a gyári aktiválású köztes szoftvernek a következővel UseMiddleware:

public static IApplicationBuilder UseFactoryActivatedMiddleware(
    this IApplicationBuilder app, bool option)
{
    // Passing 'option' as an argument throws a NotSupportedException at runtime.
    return app.UseMiddleware<FactoryActivatedMiddleware>(option);
}

A gyári aktiválású köztes szoftver hozzá lesz adva a beépített tárolóhoz a következő helyen Program.cs:

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<SampleDbContext>
    (options => options.UseInMemoryDatabase("SampleDb"));

builder.Services.AddTransient<FactoryActivatedMiddleware>();

Mindkét köztes szoftver regisztrálva van a kérelemfeldolgozási folyamatban, a következőben Program.csis:

var app = builder.Build();

app.UseConventionalMiddleware();
app.UseFactoryActivatedMiddleware();

IMiddlewareFactory

IMiddlewareFactory metódusokat biztosít a köztes szoftver létrehozásához. A köztes szoftvergyár implementációja hatóköralapú szolgáltatásként van regisztrálva a tárolóban.

Az alapértelmezett IMiddlewareFactory implementáció MiddlewareFactorya Microsoft.AspNetCore.Http csomagban található.

További erőforrások

• Mintakód megtekintése vagy letöltése (hogyan töltsd le)
• ASP.NET Core köztes szoftver
• Köztes szoftver aktiválása harmadik féltől származó tárolóval az ASP.NET Core