MediatR - 1.0

Extension ID

com.castsoftware.dotnet.mediatr

What’s new?

See MediatR for .NET - 1.0 - Release Notes for more information.

Description

This extension provides support for MediatR for .NET APIs which are responsible for publishing and receiving messages across messaging queues.

In what situation should you install this extension?

If your C# application utilizes MediatR for messaging and you want to view a model that shows the message publisher and receiver objects with their corresponding links, then you should install this extension.

Technology support

The following libraries are supported by this extension:

Compatibility 

This extension is compatible with:

Dependencies

The MediatR extension is dependent on following extensions:

• CAST AIP Internal extension (com.castsoftware.internal.platform)

Download and installation instructions

The extension will not be automatically downloaded and installed in CAST Console. If you need to use it, you should manually install the extension using the Application - Extensions interface:

What results can you expect?

Once the analysis/snapshot generation has completed, you can view the below objects and links created.

Objects

Icon	Description	Comment
	MediatR DotNet Publisher	an object is created for each message published and message type is resolved
	MediatR DotNet Receiver	an object is created for each resolved Message Handler
	MediatR Unknown DotNet Publisher	an object is created for each message published and message type is not resolved in a method call
	MediatR Unknown DotNet Receiver	an object is created for each unresolved message handler

Link Types

Code Examples

Publisher

Publish

class Program
    {
        static async Task Main(string[] args)
        {
            // Create a MediatR instance
            var mediator = new Mediator();

            // Add the handlers directly to the Mediator
            mediator.AddMediator(new MySecondMessageHandler());

            // Publish a message
            await mediator.Publish(new MyMessage { Message = "Hello, World!" });

        }
    }

Send

class Program
    {
        static async Task Main(string[] args)
        {
            // Create a MediatR instance
            var mediator = new Mediator();

            // Add the handlers directly to the Mediator
            mediator.AddMediator(new MyMessageHandler());

            // Send a message
            await mediator.Send(new MyMessage { Message = "Hello, World!" });

        }
    }

Unknown

public Task Should_raise_execption_on_null_request() => Should.ThrowAsync<ArgumentNullException>(async () => await _mediator.Send(default!));

Receiver

IRequestHandler.Handle

// Define a handler class
public class MyMessageHandler : IRequestHandler<MyMessage>
{
    public Task Handle(MyMessage request)
    {
        Console.WriteLine($"Received message: {request.Message}");
        return Task.CompletedTask;
    }
}