query-handler

What problem does it solve?

This Skill standardizes the implementation of MediatR query handlers so that list and single-entity queries are paginated, filtered, and mapped to DTO outputs consistently across a .NET microservice codebase, reducing duplicated query logic and incorrect data returns.

Core Features & Use Cases

• Uses an IUnitOfWork with named repositories so handlers delegate filtering, pagination, and sorting to repository methods.
• Defines list query records with pagination and filter parameters, and output classes with PageSize, CurrentPage, Total, and typed collections for predictable paging responses.
• Covers single-entity queries that use FindAsync then map to DTOs and throw domain-specific not-found exceptions; supports injecting additional services for enrichment when needed.

Quick Start

Create a GetOrdersHandler that uses IUnitOfWork.Orders to return a paginated GetOrdersOutput mapped to OrderOutput.