Umbrella.DDD 8.0.0.3085

Repository Content

Library to implement a light-weight Framework for Domain Driven Design

To install it, use proper command:

dotnet add package Umbrella.DDD
dotnet add package Umbrella.DDD.GCP

Umbrella.DDD:

Umbrella.DDD.GCP:

For more details about download, see NuGet Web Site

Configuration

to configure properly the application, it's necessary to add the section to ppSettings.json file as the example below:

{
 "UmbrellaMessageBus": {
    "PublisherName": "InMemory"
  },
}

where we have:

• PublisherName: name of the provider for the publisher component. Valid names: [InMemory,PubSub]

Usage

for the usage of the library, please refer to extension methods.

<b>Standard usage</b>

services.AddInMemoryEventPublisher();
services.AddEventHanders(new MyMessageBusDependencyResolver());
services.AddMessageBus();

Based on the snippet, some important notice:

• AddInMemoryEventPublisher: it should be avoided for PROD environments
• AddEventHanders: it scans the assembly to inject dynamically IMessageHandler and ISaga components
• instruction AddMessageBus should be states after all DI injections

<b>Publishing message on Google Pub Sub</b>

services.AddPubSubEventPublisher("umbrella-proj-id");
services.AddEventHanders(new MyMessageBusDependencyResolver());
services.AddMessageBus();

Using PubSub publisher, you are decoupling the publish action to handler action. the message will be handled asyncronously.

Application Modules

to simplify the aggregation of assemblies into MOdules (or generically speaking Domains), IApplicationModuleProvider is provided. implementig such interface per Domain, you can easily setup your dependencies across domain assemly, infrastructure, ecc. Here you find a simple snippet:

services.AddApplicationModules(new MyApplicationModuleProvider())

How to add an Event Handler

To implement a new event handler, you have to follow the snippet below:

   /// <summary>
    /// Handlers to manage episode creations
    /// </summary>
    internal class TestEventHandler : MessageHandler<TestEventOccurred>
    {
        /// <summary>
        /// Default COnstr
        /// </summary>
        /// <param name="logger"></param>
        /// <param name="repo"></param>
        public TestEventHandler(ILogger logger) : base(logger)
        {
        }
        /// <summary>
        /// handels the msg
        /// </summary>
        /// <param name="message"></param>
        public override void HandleThisMessage(TestEventOccurred message)
        {
            this._Logger.LogInformation("Handling message {message}", message);

            . . . .

            this._Logger.LogInformation("Message succesfully handled");
        }
    }

then register the handler using a custom extension linke the one below:

        /// <summary>
        /// Adds domains ervices
        /// </summary>
        /// <param name="services"></param>
        public static void AddMyDomainEventHandlers(this IServiceCollection services)
        {
            services.AddScoped<IMessageHandler TestEventHandler>();
            // add here other domain event handlers
            // . . .
        }

Please notice that you handlers must to be registered aas IMessageHandler.