NServiceBus.Hyperion

Add support for NServiceBus message serialization via Hyperion binary serializer.

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<HyperionSerializer>();

^{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.

Custom Settings

Customizes the instance of SerializerOptions used for serialization.

var options = SerializerOptions.Default.WithPreserveObjectReferences(true);
var serialization = configuration.UseSerialization<HyperionSerializer>();
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<HyperionSerializer>();
serialization.ContentTypeKey("custom-key");

^{snippet source | anchor}

Icon

Beetle designed by B Farias from The Noun Project.