UA.Tenet.Web 4.9.3

UA.Tenet.Web

UA.Tenet.Web extends the Tenet Framework for ASP.NET Core applications, providing a unified convention-based configuration that combines the structured approach of Controller-based APIs with the simplicity and performance of Minimal APIs.

Features

🚀 Minimal API Extensions

• TenetMinimalAttribute: Convention-based minimal API endpoint registration
• Automatic Route Discovery: Scan and register minimal endpoints automatically
• Endpoint Route Builder Extensions: Simplified endpoint configuration

🎛️ Controllers & Views

• ViewController: Base class for view-focused controllers
• ViewComponentBase: Enhanced view component functionality
• ActionExecutingContext Extensions: Request pipeline utilities

🏷️ Tag Helpers

• TenetImageTagHelper: Enhanced image tag with lazy loading, responsive images, and optimization
• Custom tag helpers for common web scenarios

🔧 Configuration & Middleware

• TenetWebOptions: Centralized web application configuration
• ApplicationBuilder Extensions: Fluent middleware configuration
• ServiceCollection Extensions: Dependency injection setup for web components

📝 Razor Extensions

• RazorPageBase Extensions: Enhanced Razor page functionality
• Helpers for common web development tasks

🌐 HTTP Request Extensions

• Request parsing and validation utilities
• Header and query string manipulation
• Context-aware helpers

Installation

Install via NuGet Package Manager:

dotnet add package UA.Tenet.Web

Or via Package Manager Console:

Install-Package UA.Tenet.Web

Quick Start

Setting Up Tenet Web

using UA.Tenet.Web.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Add Tenet MVC services
builder.Services.AddTenetMvc();

var app = builder.Build();

// Configure Tenet middleware
app.UseTenet(options =>
{
    options.UseHttpsRedirection = true;
    options.UseStaticFiles = true;
    options.UseRouting = true;
});

app.Run();

Using Tag Helpers

@addTagHelper *, UA.Tenet.Web


<img src="~/images/product.jpg" 
     alt="Product Image" 
     class="product-image" />

Creating View Controllers

using UA.Tenet.Web.Abstractions;

public class HomeController : ViewController
{
    public IActionResult Index()
    {
        return View();
    }
    
    public IActionResult About()
    {
        return View();
    }
}

Configuring Web Options

app.UseTenet(options =>
{
    options.UseHttpsRedirection = true;
    options.UseStaticFiles = true;
    options.UseRouting = true;
    options.UseAuthentication = true;
    options.UseAuthorization = true;
    options.StaticFileOptions = builder =>
    {
        builder.RequestPath = "/static";
        builder.OnPrepareResponse = ctx =>
        {
            ctx.Context.Response.Headers.Append("Cache-Control", "public,max-age=31536000");
        };
    };
});

Architecture

UA.Tenet.Web follows the Tenet Framework principles:

• Convention over Configuration: Automatic endpoint discovery and registration
• Performance: Leverages Minimal API performance benefits
• Structure: Maintains organized Controller-like structure
• Flexibility: Mix and match traditional controllers with minimal APIs
• Testability: Clean separation of concerns for easy testing

Integration with Swagger

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

app.UseSwagger();
app.UseSwaggerUI();

app.UseTenet();

Documentation

For comprehensive documentation, tutorials, and API reference, visit:

• 📖 Official Documentation
• 🔍 API Reference

Made with ❤️ by UA Devs @ Chiclana de la Frontera (Spain)