Getting Started

Consumer-driven Contracts sample

Component: NServiceBus
NuGet Package: NServiceBus (9.x)

Introduction to consumer-driven contracts

This sample shows a consumer-driven contract(CDC) approach to messaging. The essence of consumer-driven contracts is that the ownership of the contract is inverted. Instead of the producer providing the definition, consumers define the contract they expect, and it's up to the producer to fulfill it.

In NServiceBus terminology, "producers" are called "publishers" and "consumers" are called "subscribers". Contracts translate to message contracts and are defined using plain C# types. To honor a consumer contract, the producer would make the relevant message contract inherit from the consumer contract type.

Contracts as interfaces

CDC is the main reason that interface messages are supported in addition to classes. More than one consumer can provide a contract that would be satisfied by the same publisher message. This would not be possible if only classes were used because multiple inheritance isn't supported by C#. The solution is to use interfaces instead, which lets the publisher implement all relevant contract types on the same message type.

Assuming that the producers MyEvent would satisfy both Consumer1Contract and Consumer2Contract, it would look like this:

class MyEvent :
    public string Consumer1Property { get; set; }
    public string Consumer2Property { get; set; }

Running the sample

Run the sample and notice how each consumer receives its contract when the producer publishes MyEvent.