Euhen.AppBuilder.Web 2.1.0

Euhen.AppBuilder.Web

ASP.NET Core extension package for building modular web applications. Extends Euhen.AppBuilder with support for middleware pipeline configuration via pipeline modules.

Installation

dotnet add package Euhen.AppBuilder.Web

How it works

EuhenWebAppBuilder extends EuhenAppBuilder with pipeline module support. It wraps WebApplicationBuilder and coordinates both service registration and middleware pipeline configuration. Service modules are applied immediately upon registration. Pipeline modules are queued and applied in registration order when Build() is called, after the WebApplication has been constructed.

Getting started

Step 1 — Create a module

The recommended approach is to implement IModule, which combines both IServiceModule and IPipelineModule. This allows you to group all configuration logic for a feature — services and pipeline — in a single class.

using Euhen.AppBuilder.Web.Modules;

public class AuthModule : IModule
{
    public void Configure(IHostApplicationBuilder builder)
    {
        builder.Services.AddAuthentication();
        builder.Services.AddAuthorization();
    }

    public void Configure(WebApplication app)
    {
        app.UseAuthentication();
        app.UseAuthorization();
    }
}

When a feature only involves service registration and no pipeline configuration, implement IServiceModule from Euhen.AppBuilder and use AddServiceModule instead.

When a feature only involves pipeline configuration, implement IPipelineModule and use AddPipelineModule.

Step 2 — Register the module in Program.cs

Use EuhenWebAppBuilder and register your modules with AddModule. Call Build() to finalise the application.

You can construct EuhenWebAppBuilder in two ways:

• Pass args directly — args is the variable automatically available in Program.cs that contains the command-line arguments passed to the application. EuhenWebAppBuilder will create the WebApplicationBuilder internally.
• Pass an existing WebApplicationBuilder or IHostApplicationBuilder.

var app = new EuhenWebAppBuilder(args)
    .AddModule(new AuthModule())
    .Build();

app.Run();

When custom configuration is needed outside of a module, use ConfigureServices and ConfigurePipelines to apply inline configuration directly:

var app = new EuhenWebAppBuilder(args)
    .AddModule(new AuthModule())
    .ConfigureServices(b => b.Services.AddControllers())
    .ConfigurePipelines(a => a.MapControllers())
    .Build();

app.Run();

Terminology

License

This project is licensed under the MIT License.