Reference 7: Technologies Used in the Reference Implementation

patterns & practices Developer Center

On this page: Download:
Microsoft Azure Service Bus | Unity Application Block

Download code samples

Download PDF

Order Paperback

Microsoft Azure Service Bus

This section is not intended to provide an in-depth description of the Azure Service Bus, rather it is intended to highlight those features that may prove useful in implementing the CQRS pattern and event sourcing. The section "Further Information" below, includes links to additional resources for you to learn more.

The Azure Service Bus provides a cloud-hosted, reliable messaging service. It operates in one of two modes:

  • Relayed. Relayed messaging provides a direct connection between clients who need to perform request/response messaging, one-way messaging, or peer-to-peer messaging.
  • Brokered. Brokered messaging provides durable, asynchronous messaging between clients that are not necessarily connected at the same time. Brokered messaging supports both queue and publish/subscribe topologies.

In the context of CQRS and event sourcing, brokered messaging can provide the necessary messaging infrastructure for delivering commands and events reliably between elements of an application. The Azure Service Bus also offers scalability in scenarios that must support high volumes of messages.

Queues

Azure Service Bus queues provide a durable mechanism for senders to send one-way messages for delivery to a single consumer.

Figure 1 shows how a queue delivers messages.

Follow link to expand image

Figure 1

Azure Service Bus Queue

The following list describes some of the key characteristics of queues.

  • Queues deliver messages on a First In, First Out (FIFO) basis.
  • Multiple senders can send messages on the same queue.
  • A queue can have multiple consumers, but an individual message is only consumed by one consumer. Multiple consumers compete for messages on the queue.
  • Queues offer "temporal decoupling." Senders and consumer do not need to be connected at the same time.

Topics and Subscriptions

Azure Service Bus topics provide a durable mechanism for senders to send one-way messages for delivery to a multiple consumers.

Figure 2 shows how a topic distributes messages.

Follow link to expand image

Figure 2

Azure Service Bus Topic

The following list describes some of the key characteristics of topics.

  • Topics deliver a copy of each message to each subscription.
  • Multiple senders can publish messages to the same topic.
  • Each subscription can have multiple consumers, but an individual message in a subscription is only consumed by one consumer. Multiple consumers compete for messages on the subscription.
  • Topics offer "temporal decoupling." Senders and consumer do not need to be connected at the same time.
  • Individual subscriptions support filters that limit the messages available through that subscription.

Useful API features

The following sections highlight some of the Azure Service Bus API features that are used in the project.

Reading messages

A consumer can use one of two modes to retrieve messages from queues or subscriptions: ReceiveAndDelete mode and PeekLock mode.

In the ReceiveAndDelete mode, a consumer retrieves a message in a single operation: the Service Bus delivers the message to the consumer and marks the message as deleted. This is the simplest mode to use, but there is a risk that a message could be lost if the consumer fails between retrieving the message and processing it.

In the PeekLock mode, a consumer retrieves a message in two steps: first, the consumer requests the message, the Service Bus delivers the message to the consumer and marks the message on the queue or subscription as locked. Then, when the consumer has finished processing the message, it informs the Service Bus so that it can mark the message as deleted. In this scenario, if the consumer fails between retrieving the message and completing its processing, the message is re-delivered when the consumer restarts. A timeout ensures that locked messages become available again if the consumer does not complete the second step.

In the PeekLock mode, it is possible that a message could be delivered twice in the event of a failure. This is known as at least once delivery. You must ensure that either the messages are idempotent, or add logic to the consumer to detect duplicate messages and ensure exactly once processing. Every message has a unique, unchanging Id which facilitates checking for duplicates.

You can use the PeekLock mode to make your application more robust when it receives messages. You can maintain consistency between the messages you receive and a database without using a distributed transaction.

Sending messages

When you create a client to send messages, you can set the RequiresDuplicateDetection and DuplicateDetectionHistoryTimeWindow properties in the QueueDescription or TopicDescription class. You can use duplicate detection feature to ensure that a message is sent only once. This is useful if you retry sending a message after a failure and you don't know whether it was previously sent.

You can use the duplicate detection feature to make your application more robust when it receives messages without using a distributed transaction. You can maintain consistency between the messages you send and a database without using a distributed transaction.

Expiring messages

When you create a BrokeredMessage object, you can specify an expiry time using the ExpiresAtUtc property or a time to live using the TimeToLive property. When a message expires you can specify either to send the message to a dead letter queue or discard it.

Delayed message processing

In some scenarios, you may want to send the message now, but to delay delivery until some future time. You can do this by using the ScheduleEnqueueTimeUtc property of the BrokeredMessage instance.

Serializing messages

You must serialize your Command and Event objects if you are sending them over the Azure Service Bus.

The Contoso Conference Management System uses Json.NET serializer to serialize command and event messages. The team chose to use this serializer because of its flexibility and resilience to version changes.

The following code sample shows the adapter class in the Common project that wraps the Json.NET serializer.

public class JsonSerializerAdapter : ISerializer
{
    private JsonSerializer serializer;

    public JsonSerializerAdapter(JsonSerializer serializer)
    {
        this.serializer = serializer;
    }

    public void Serialize(Stream stream, object graph)
    {
        var writer = new JsonTextWriter(new StreamWriter(stream));

        this.serializer.Serialize(writer, graph);

        // We don't close the stream as it's owned by the message.
        writer.Flush();
    }

    public object Deserialize(Stream stream)
    {
        var reader = new JsonTextReader(new StreamReader(stream));

        return this.serializer.Deserialize(reader);
    }
}

Further information

For general information about the Azure Service Bus, see Service Bus on MSDN.

For more information about Service Bus topologies and patterns, see Overview of Service Bus Messaging Patterns on MSDN.

For information about scaling the Azure Service Bus infrastructure, see Best Practices for Performance Improvements Using Service Bus Brokered Messaging on MSDN.

For information about Json.NET, see Json.NET.

Unity Application Block

The MVC web application in the Contoso Conference Management System uses the Unity Application Block (Unity) dependency injection container. The Global.asax.cs file contains the type registrations for the command and event buses, and the repositories. This file also hooks up the MVC infrastructure to the Unity service locator as shown in the following code sample:

protected void Application_Start()
{
    this.container = CreateContainer();
    RegisterHandlers(this.container);

    DependencyResolver.SetResolver(new UnityServiceLocator(this.container));

    ...
}

The MVC controller classes no longer have parameter-less constructors. The following code sample shows the constructor from the RegistrationController class:

private ICommandBus commandBus;
private Func<IViewRepository> repositoryFactory;

public RegistrationController(ICommandBus commandBus, 
  [Dependency("registration")]Func<IViewRepository> repositoryFactory)
{
    this.commandBus = commandBus;
    this.repositoryFactory = repositoryFactory;
} 

Further information

For more information about the Unity Application Block, see Unity Application Block on MSDN.

Next Topic | Previous Topic | Home | Community