readme.md

NServiceBus.MessagePack

Add support for NServiceBus message serialization via MessagePack

Already a Patron? skip past this section

Community backed

It is expected that all developers either become a Patron to use NServiceBusExtensions. Go to licensing FAQ

Sponsors

Support this project by becoming a Sponsor. The company avatar will show up here with a website link. The avatar will also be added to all GitHub repositories under the NServiceBusExtensions organization.

Patrons

Thanks to all the backing developers. Support this project by becoming a patron.

Usage

configuration.UseSerialization<MessagePackSerializer>();

^{snippet source | anchor}

This serializer does not support messages defined as interfaces. If an explicit interface is sent, an exception will be thrown with the following message:

Interface based message are not supported.
Create a class that implements the desired interface

Instead, use a public class with the same contract as the interface. The class can optionally implement any required interfaces.

Resolver

Customizes the instance of IFormatterResolver used for serialization.

var serialization = configuration.UseSerialization<MessagePackSerializer>();
var options = MessagePackSerializerOptions
    .Standard
    .WithResolver(ContractlessStandardResolver.Instance);
serialization.Options(options);

^{snippet source | anchor}

Custom content key

When using additional deserializers or transitioning between different versions of the same serializer it can be helpful to take explicit control over the content type a serializer passes to NServiceBus (to be used for the ContentType header).

var serialization = configuration.UseSerialization<MessagePackSerializer>();
serialization.ContentTypeKey("custom-key");

^{snippet source | anchor}

Icon

Backpack designed by Nathan Driskell from The Noun Project.