MessageHandler MH Sign Up

Delegation Quickstart


This quickstart gives you an example implementation of a delegation.


Clone the source code from Github before you get started.


The scenario for this quickstart is a command to notify an e-commerce buyer through email, but it is delegated from an API to a Worker and in turn again to a specialized email service.

What you need to get started

Running the sample

Prior to being able to run the sample, you need to configure the user secrets file.

In the secrets file you must specify the following configuration values.

  "servicebusnamespace": "your azure service bus connection string goes here",

Also ensure a queue named emails is created up front in the service bus namespace.

Once configured you can start the API and Worker projects or run the unittests.

Designed with testing in mind

MessageHandler is intented to be test friendly.

This sample contains plenty of ideas on how to test a delegation without requiring a dependency on an actual broker instance, and thus keep the tests fast.

  • Component tests: To test the delegation logic and it's interaction with the email service.
  • Contract tests: To verify that the test doubles used in the component tests are behaving the same as an actual dependency would. Note: contract verification files are often shared between producers and consumers of the contract.

How to implement it yourself

Check out this how to guide to learn how to configure a delegation yourself.

Sign up to our newsletter to get notified about new content and releases

You can unsubscribe at any time by clicking the link in the footer of your emails. I use Mailchimp as my marketing platform. By clicking subscribe, you acknowledge that your information will be transferred to Mailchimp for processing. Learn more about Mailchimp's privacy practices here.