https://github.com/jgauffin/dotnetcqs

Command/Query separation for .NET
https://github.com/jgauffin/dotnetcqs

command-query cqrs csharp dotnet messaging netstandard20 queues

Last synced: 23 days ago
JSON representation

Command/Query separation for .NET

• Host: GitHub
• URL: https://github.com/jgauffin/dotnetcqs
• Owner: jgauffin
• License: apache-2.0
• Created: 2014-05-26T17:59:39.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-10-04T19:44:34.000Z (over 1 year ago)
• Last Synced: 2024-12-11T13:11:54.490Z (about 2 months ago)
• Topics: command-query, cqrs, csharp, dotnet, messaging, netstandard20, queues
• Language: C#
• Size: 1.79 MB
• Stars: 14
• Watchers: 4
• Forks: 6
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Asynchronous Command/Query library

===================================

This library contains interfaces used to be able to use messaging (commands, queries and events) in applications without tightly coupling it to a specific implementation.

## Example

Define a message:

```csharp

public class ActivateAccount

{

	public int AccountId {get; set; }

	public string ActivationKey { get; set; }

}

```

Invoke it:

```csharp

var msg = new ActivateAccount { AccountId = 35, ActivationKey = "dfkldsie93kcn22" };

await _messageBus.SendAsync(msg);

```

Handle it:

```csharp

public class ActivateAccountHandler : IMessageHandler

{

    private readonly IAccountRepository _repository;

	

	public ActivateAccountHandler(IAccountRepository repository)

	{

		if (repository == null) throw new ArgumentNullException(repository);

		

		_repository = repository;

	}

	

	public async Task HandleAsync(IMessageContext context, ActivateAccount message)

	{

		var user = await _repository.Get(message.AccountId);

		user.Activate(message.ActivationKey);

		await _repository.UpdateAsync(user);

		

		await context.SendAsync(new AccountActivated(message.AccountId));

	}

}

```

Message handlers are fully isolated from the rest of the specification and therefore easy to test and maintain.

# Implementations

The following implementations exist.

## Bus 

The `MessageBus` and `QueryBus` currently have the following implementations:

* DependenyInjection: Use your favorite container to execute and queue messages.

 * Microsoft.Extensions.DependencyInjection: Currently under implementation

 * Griffin.Container: Currently under implementation

## Queues

* ADO.NET: Uses a table in your database to enqueue and dequeue messages (to get persistance).

* Azure ServiceBus: Under development