Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/XerProjects/Xer.Cqrs

A lightweight and easy-to-use CQRS + DDD library
https://github.com/XerProjects/Xer.Cqrs

command command-handler cqrs dotnet-standard event event-handlers query query-handler

Last synced: 18 days ago
JSON representation

A lightweight and easy-to-use CQRS + DDD library

Host: GitHub
URL: https://github.com/XerProjects/Xer.Cqrs
Owner: XerProjects
License: mit
Created: 2017-09-05T17:35:32.000Z (over 6 years ago)
Default Branch: dev
Last Pushed: 2018-05-29T05:18:06.000Z (almost 6 years ago)
Last Synced: 2024-05-01T07:23:08.520Z (22 days ago)
Topics: command, command-handler, cqrs, dotnet-standard, event, event-handlers, query, query-handler
Language: C#
Homepage:
Size: 1000 KB
Stars: 101
Watchers: 12
Forks: 8
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-dotnet - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)
awsome-dotnet - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)
awesome-csharp - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)
awesome-dotnet - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)
awesome-dot-dev - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)
awesome-dotnet - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)
awesome-dotnet - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)
system-architecture-awesome - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)
awesome-dotnet-cn - Xer.Cqrs - 基于CQRS模式创建应用并支持属性路由和托管处理程序的简单库，由C#开发针对.NET Standard 1.0。 (时间聚合器和发送器)
awesome-dotnet - Xer.Cqrs - A simple library for creating applications based on the CQRS pattern with support for attribute routing and hosted handlers. Developed in C# targeting .NET Standard 1.0. (Event aggregator and messenger)

README

        # What is Xer.Cqrs?

Xer.Cqrs is a convenience package that contains all packages needed to build a CQRS write side with DDD concepts. It groups together other lightweight XerProjects libraries:

* [Domain Driven](https://github.com/XerProjects/Xer.DomainDriven) - contains Domain Driven Design (DDD) components/concepts.

* [Command Stack](https://github.com/XerProjects/Xer.Cqrs.CommandStack) - contains components for handling commands.

* [Event Stack](https://github.com/XerProjects/Xer.Cqrs.EventStack) - contains components for handling events.

# Build

| Branch | Status |

|--------|--------|

| Master | [![Build status](https://ci.appveyor.com/api/projects/status/jr4h0o8h064m6je2/branch/master?svg=true)](https://ci.appveyor.com/project/XerProjects25246/xer-cqrs-5e3ne/branch/master) |

| Dev | [![Build status](https://ci.appveyor.com/api/projects/status/jr4h0o8h064m6je2/branch/dev?svg=true)](https://ci.appveyor.com/project/XerProjects25246/xer-cqrs-5e3ne/branch/dev) |

# Table of contents

* [Overview](#overview)

* [Features](#features)

* [Installation](#installation)

* [Getting Started](#getting-started)

   * [Command Handling](#command-handling)

   * [Event Handling](#event-handling)

# Overview

Simple CQRS library

This project composes of components for implementing the CQRS pattern (Command Handling, Event Handling) with DDD concepts (Aggregate Roots, Entities, Value Objects, Domain Events). This library was built with simplicity, modularity and pluggability in mind.

## Features

* Send commands to registered command handlers.

* Send events to registered event handlers.

* Provides simple abstraction for hosted command/event handlers which can be registered just like a regular command/event handler.

* Multiple ways of registering command/event handlers:

    * Simple handler registration (no IoC container).

    * IoC container registration

      * achieved by creating implementations of IContainerAdapter or using pre-made extensions pakcages for supported containers.

        * Microsoft.DependencyInjection

          

          [![NuGet](https://img.shields.io/nuget/v/Xer.Cqrs.Extensions.Microsoft.DependencyInjection.svg)](https://www.nuget.org/packages/Xer.Cqrs.Extensions.Microsoft.DependencyInjection/)

          

          See https://github.com/XerProjects/Xer.Cqrs.Extensions.Microsoft.DependencyInjection for source.

          

        * SimpleInjector

          

          [![NuGet](https://img.shields.io/nuget/v/Xer.Cqrs.Extensions.SimpleInjector.svg)](https://www.nuget.org/packages/Xer.Cqrs.Extensions.SimpleInjector/)

          

          See https://github.com/XerProjects/Xer.Cqrs.Extensions.SimpleInjector for source.

                    

        * Autofac

          

          [![NuGet](https://img.shields.io/nuget/v/Xer.Cqrs.Extensions.Autofac.svg)](https://www.nuget.org/packages/Xer.Cqrs.Extensions.Autofac/)

          

          See https://github.com/XerProjects/Xer.Cqrs.Extensions.Autofac for source.

                    

    * Attribute registration

      * achieved by marking methods with [CommandHandler] or [EventHandler] attributes from the Xer.Cqrs.CommandStack.Extensions.Attributes and Xer.Cqrs.EventStack.Extensions.Attributes packages.

      

        * Xer.Cqrs.CommandStack.Extensions.Attributes

          

          [![NuGet](https://img.shields.io/nuget/v/Xer.Cqrs.CommandStack.Extensions.Attributes.svg)](https://www.nuget.org/packages/Xer.Cqrs.CommandStack.Extensions.Attributes/)

          

          See https://github.com/XerProjects/Xer.Cqrs.CommandStack.Extensions.Attributes/ for source.

        

        * Xer.Cqrs.EventStack.Extensions.Attributes

          

          [![NuGet](https://img.shields.io/nuget/v/Xer.Cqrs.EventStack.Extensions.Attributes.svg)](https://www.nuget.org/packages/Xer.Cqrs.EventStack.Extensions.Attributes/)

         

          See https://github.com/XerProjects/Xer.Cqrs.EventStack.Extensions.Attributes/ for source.

## Installation

You can simply clone this repository, build the source, reference the dll from the project, and code away!

Xer.Cqrs is available as a Nuget package:

* [![NuGet](https://img.shields.io/nuget/v/Xer.Cqrs.svg)](https://www.nuget.org/packages/Xer.Cqrs/)

To install Nuget package:

1. Open command prompt

2. Go to project directory

3. Add the packages to the project:

    ```csharp

    dotnet add package Xer.Cqrs

    ```

4. Restore the packages:

    ```csharp

    dotnet restore

    ```

## Getting Started

(Samples are in ASP.NET Core)

### Command Handling

See https://github.com/XerProjects/Xer.Cqrs.CommandStack/blob/dev/README.md for documentation.

### Event Handling

See https://github.com/XerProjects/Xer.Cqrs.EventStack/blob/dev/README.md for documentation.