Getting started

Le test du Hello World! (event sourcé, évidemment …)

Tout d’abord, il faut savoir qu’il y a des exemples disponibles sur notre repository GitHub, ici-même vous permettant d’approfondir selon les technologies que vous utilisez quotidiennement. Autre chose à savoir également, CQELight est distribué en packages NuGet modulaires, en .NET Standard 2.0 (compatible .NET Core 2.0+ et .NET Framework 4.6.1+).

Pour l’installer dans cet exemple, il faut commencer par créer un nouveau projet console (idéalement .NET Core) sous Visual Studio (ou l’éditeur de votre choix), et ensuite faire une recherche de package sur CQELight. Plusieurs résultats devraient apparaitre. Installer le package de base, CQELight.

Note

La dernière version stable peut avoir changé depuis la rédaction de cette documentation. Il est conseillé de prendre toujours la dernière version stable pour avoir les dernières fonctionnalités et corrections de bugs.

Félicitations ! Vous venez d’installer CQELight sur un projet, nous pouvons dorénavant commencer à l’utiliser.

Créons maintenant deux nouveaux dossiers : Events et Handlers, ainsi que deux nouvelles classes : GreetingsEvent (dans le dossier Events) et GreetingsEventHandler (dans le dossier Handlers). Nous sommes prêt à commencer le code.

Il faut maintenant que dès lors que le système reçoit un event de type GreetingsEvent, le message ‘Hello World!’ s’affiche sur la console. Faisons devenir notre GreetingsEvent un VRAI event, en héritant de la classe BaseDomainEvent dans le namespace CQELight.Abstractions.Events :

using CQELight.Abstractions.Events;
class GreetingsEvent : *BaseDomainEvent
{
}

Ensuite, faisons devenir GreetingsEventHandler un VRAI EventHandler, en le faisant implémenter l’interface IDomainEventHandler du namespace CQELight.Abstractions.Events.Interfaces, et implémentons le comportement désiré

using ConsoleApp1.Events;
using CQELight.Abstractions.Events.Interfaces;
using System;
using System.Threading.Tasks;
class GreetingsEventHandler : IDomainEventHandler<GreetingsEvent>
{
    public Task HandleAsync(
                    GreetingsEvent domainEvent,
                    IEventContext context = null)
    {
        Console.WriteLine("Hello world!");
        return Task.CompletedTask;
    }
}

Finalement, il est nécessaire de déclencher le mécanisme depuis le thread principal du programme. Pour ce faire, il faut publier l’événement dans le système. Etant donné que l’on fonctionne 100% In-Memory, il faut ajouter le package CQELight.Buses.InMemory.

Une fois fait, il faut configurer le système et envoyer l’événement :

using CQELight;
using CQELight.Dispatcher;
using HelloWorld.Events;
using System;
using System.Threading.Tasks;

namespace HelloWorld
{
    class Program
    {
        static async Task Main(string[] args)
        {
            new Bootstrapper()
                .UseInMemoryEventBus()
                .Bootstrapp();

            await CoreDispatcher.PublishEventAsync(new GreetingsEvent());

            Console.Read(); // Used to avoid console to exit automatically
        }
    }
}

Note

Dans cet exemple, nous utilisons une version de Visual Studio permettant l’usage de C# 7.3, qui permet d’avoir une méthode Main d’une application console qui soit asynchrone. Si ce n’était pas votre cas, faites un appel avec CoreDispatcher.PublishEventAsync().GetAwaiter().GetResult() pour un résultat similaire.

Lancez le programme et voilà, vous avez publié votre premier event ! Il reste encore beaucoup de choses à découvrir avec CQELight, ceci n’est qu’un petit avant goût des possibilités offertes. Explorez les parties qui vous intéressent par le menu, ou jetez un coup d’oeil à notre repository pour savoir ce qui arrive.

Le code source de cet exemple est disponible à cette adresse.