AsyncHandler.EventSourcing 1.0.5

asynchandler

A lightweight event sourcing framework for .Net with event-store of choice.

Overview

asynchandler is a high-performance event sourcing framework built for .Net that allows selecting event storage of choice. Combining consistency with schema flexibility, asynchandler aims to make event sourcing simplified for everyone. Currently supports Azure Sql, Postgres and Sql Server.

Prerequisites

asynchandler runs on the stable release of .Net 8 and requires the SDK installed.

https://dotnet.microsoft.com/en-us/download/dotnet/8.0

Use docker to run sqlserver or postgres databases, execute docker-compose.

docker compose --project-name asynchandler up -d

Usage

Simply install AsyncHandler.EventSourcing package.

dotnet add package AsyncHandler.EventSourcing

Use AddAsyncHandler service collection extension.

var connectionString = builder.Configuration["postgresqlsecret"]??
    throw new Exception("No connection defined");

builder.Services.AddAsyncHandler(asynchandler =>
{
    asynchandler.Schema = "ah";
    asynchandler.AddEventSourcing(source =>
    {
        source.SelectEventSource(EventSources.PostgresSql, connectionString);
    });
});

Select your event source of choice from SelectEventSource. Make sure you have defined your connection string.

Define your aggregate

Add your aggregate with AggregateRoot

public class OrderBookingAggregate : AggregateRoot<long> // or Guid
{
    public OrderStatus OrderStatus { get; private set; }
    protected override void Apply(SourcedEvent e)
    {
        this.InvokeApply(e);
    }
    public void Apply(OrderPlaced e)
    {
        OrderStatus = OrderStatus.Placed;
    }
    public void PlaceOrder(PlaceOrder command)
    {
        if(OrderStatus == OrderStatus.Placed)
            return;
        RaiseEvent(new OrderPlaced(command));
    }
}

AggregateRoot allows selecting long or Guid for sourceId, selecting long offers lightnening-fast queries.

To continue please visit our GitHub handle.

Give us a star ⭐

If you are an event sourcer and love OSS, give asynchandler a star. 💜

License

This project is licensed under the terms of the MIT license.