Command Architecture

Mon, 01 Jan 0001 00:00:00 +0000

Commands represent write intents — creating, updating, or deleting state. The command side of ArturRios.Mediator enforces a strict one-command-one-handler rule and isolates each execution in its own DI scope.

Core Types

Type	Purpose
`BaseCommand`	Abstract base class for all command data carriers
`CommandOutput`	Abstract base class for the result payload
`ICommandHandler<TCommand, TOutput>`	Synchronous handler contract
`ICommandHandlerAsync<TCommand, TOutput>`	Asynchronous handler contract
`CommandMediator`	Resolves and invokes the registered handler

BaseCommand

public abstract class BaseCommand;

Derive from BaseCommand to create a command. Expose the data the handler needs as plain properties. Commands are simple data carriers — no business logic belongs here.

Query Architecture

Mon, 01 Jan 0001 00:00:00 +0000

Queries represent read-only requests for data. The query side of ArturRios.Mediator supports two result shapes: a single DataOutput<T> for item lookups and a PaginatedOutput<T> for collection queries that need page metadata.

Core Types

Type	Purpose
`BaseQuery`	Abstract base class for all query data carriers
`QueryOutput`	Abstract base class for the result payload
`IQueryHandler<TQuery, TOutput>`	Synchronous single-result handler contract
`IQueryHandlerAsync<TQuery, TOutput>`	Asynchronous single-result handler contract
`IPaginatedQueryHandler<TQuery, TOutput>`	Synchronous paginated handler contract
`IPaginatedQueryHandlerAsync<TQuery, TOutput>`	Asynchronous paginated handler contract
`QueryMediator`	Resolves and invokes the registered handler

BaseQuery

public abstract class BaseQuery
{
 public int PageNumber { get; set; } = 1; // 1-based
 public int PageSize { get; set; } = 100;
}

Derive from BaseQuery to create a query. Expose filter criteria as plain properties. The PageNumber and PageSize properties are consumed by paginated handlers and ignored by single-result ones.

Documentation on Dotnet Mediator

Command Architecture

Core Types

BaseCommand

Query Architecture

Core Types

BaseQuery