.NET Client for Apache ActiveMQ Artemis

Unofficial Apache ActiveMQ Artemis .NET Client for .NET Core and .NET Framework.

Apache ActiveMQ Artemis is an open-source project to build a multi-protocol, embeddable, very high performance, clustered, asynchronous messaging system.

This lightweight .NET client library built on top of AmqpNetLite tries to fully leverage Apache ActiveMQ Artemis capabilities.

NuGet	Status
ArtemisNetClient
ArtemisNetClient.Extensions.DependencyInjection
ArtemisNetClient.Extensions.Hosting
ArtemisNetClient.Extensions.App.Metrics
ArtemisNetClient.Extensions.CloudEvents
ArtemisNetClient.Extensions.LeaderElection
ArtemisNetClient.Testing

Commercial support

For commercial support, contact

Compatibility

The library is tested against ActiveMQ Artemis 2.30.0 (Jul 26th, 2023). Most of the features should work with older versions of the broker, but Topology Management uses API surface that was introduced in ActiveMQ Artemis 2.14.0.

Quickstart

Add ArtemisNetClient NuGet package to your project using dotnet CLI:

dotnet add package ArtemisNetClient

The API interfaces and classes are defined in the ActiveMQ.Artemis.Client namespace:

using ActiveMQ.Artemis.Client;

Before any message can be sent or received, a connection to the broker endpoint has to be opened. Create a connection using ConnectionFactory object.

var connectionFactory = new ConnectionFactory();
var endpoint = Endpoint.Create("localhost", 5672, "guest", "guest");
var connection = await connectionFactory.CreateAsync(endpoint);

In order to send a message you will need a message producer:

var producer = await connection.CreateProducerAsync("a1", RoutingType.Anycast);
await producer.SendAsync(new Message("foo"));

To receive a message you have to create a message consumer:

var consumer = await connection.CreateConsumerAsync("a1", RoutingType.Anycast);
var message = await consumer.ReceiveAsync();

Documentation

Detailed documentation is available on the project website.

Online resources

• Messaging with ActiveMQ Artemis and ASP.NET Core (January 31, 2021)
• Run ActiveMQ Artemis in Docker for local development (December 15, 2021)
• ActiveMQ Artemis address model explained with examples in .NET (April 19, 2022)

Running the tests

The tests are grouped in two categories:

• Unit Tests that don't require any infrastructure to run
• Integration Tests that require Apache ActiveMQ Artemis

You can run the unit tests suite with the following command:

dotnet test --filter "FullyQualifiedName!~IntegrationTests"

Integration tests can be run with Apache ActiveMQ Artemis server hosted on a Docker container.

Spinning up the necessary infrastructure

This assumes docker and docker-compose are properly setup.

1. Go to /test/artemis directory
2. Run the following command: docker-compose up -V -d

Having the broker up and running you can execute the integration test suite:

dotnet test --filter "FullyQualifiedName~IntegrationTests"

Features

The following table shows what features are currently supported.

Extensions

There are several extensions available that make integration of .NET Client for ActiveMQ Artemis with ASP.NET Core based projects seamless.

License

This project uses MIT licence. Long story short - you are more than welcome to use it anywhere you like, completely free of charge and without oppressive obligations.