TaskHub.Shared

Command Pipeline

The Command Pipeline is a robust implementation of the Mediator pattern, providing a centralized way to handle business logic while supporting complex cross-cutting concerns through a flexible middleware system.

📖 Table of Contents

• Architecture & Internals: Deep dive into the CommandsBus and how it builds the execution onion.
• Pipeline Lifecycle: Detailed explanation of Pre-Behaviors, Post-Transformers, and Post-Behaviors.
• Attributes & Configuration: How to use [Order], [SharedBehavior], and [Span] to control the pipeline.
• Usage & Examples: Practical code snippets, from basic handlers to complex multi-stage pipelines.

🚀 Key Features

• High Performance: Compiled delegate caching for zero-overhead execution.
• Observability by Default: Automatic OpenTelemetry tracing and metrics for every command.
• Extreme Extensibility: Three distinct lifecycle stages for any middleware requirement.
• Type Safety: Strongly-typed commands, results, and behaviors.

---

Basic Usage Overview

// 1. Define Command
public record CreateTask(string Title) : ICommand;

// 2. Define Handler
public class Handler : ICommandHandler<CreateTask, Result>
{
    public async Task<Result> HandleAsync(CreateTask cmd, CancellationToken ct) 
        => ResultFactory.Success();
}

// 3. Send via Bus
var result = await bus.SendAsync<CreateTask, Result>(new CreateTask("Fix bug"));

This site is open source. Improve this page.