Using NServiceBus in a ASP.NET Web Application

Download the zipped solution

Nugets

Run the solution, a new browser window/tab opens, as well as a console application.

Enter the number "1" into the text box in the browser, and click "Go". You should see the result "None" appear, as shown:

AsyncPages sample running

Changing the number in the text box from even to odd numbers changes the result.

The web page renders synchronously; from the user's perspective, the interaction is synchronous and blocking, even though behind the scenes NServiceBus is doing asynchronous messaging.

This sample has three projects: Shared, Server, and WebApplication. WebApplication is a web application that sends messages (found in the Shared project) to the Server project, which is hosted as a console application.

Initializing the bus

In WebApplication, open Global.asax.cs and look at the code in the ApplicationStart method:

BusConfiguration busConfig = new BusConfiguration();
busConfig.EndpointName("Samples.AsyncPages.WebApplication");
busConfig.UseSerialization<JsonSerializer>();
busConfig.EnableInstallers();
busConfig.UsePersistence<InMemoryPersistence>();

Bus = NServiceBus.Bus.Create(busConfig).Start();
Configure.Serialization.Json();
Configure configure = Configure.With();
configure.Log4Net();
configure.DefineEndpointName("Samples.AsyncPages.WebApplication");
configure.DefaultBuilder();
configure.UseTransport<Msmq>();
IStartableBus startableBus = configure.UnicastBus().CreateBus();
Bus = startableBus.Start(() => Configure.Instance.ForInstallationOn<NServiceBus.Installation.Environments.Windows>().Install());
Configure configure = Configure.With();
configure.Log4Net();
configure.DefineEndpointName("Samples.AsyncPages.WebApplication");
configure.DefaultBuilder();
configure.JsonSerializer();
configure.MsmqTransport();
IStartableBus startableBus = configure.UnicastBus().CreateBus();
Bus = startableBus.Start(() => Configure.Instance.ForInstallationOn<NServiceBus.Installation.Environments.Windows>().Install());

The rest of the code is typical for hosting NServiceBus in your own process. Read more about the other lines.

The code holds a reference to the bus, which is used later for sending messages. This isn't the only option available; if the classes for sending messages are managed by Dependency Injection, then they can get a reference to the bus by declaring a dependency on IBus. See an example.

Sending a message

Open Default.aspx.cs in WebApplication to see the Button1Click method:

int number;
if (!int.TryParse(TextBox1.Text, out number))
{
    return;
}
Command command = new Command
              {
                  Id = number
              };

Global.Bus.Send("Samples.AsyncPages.Server", command)
    .Register<ErrorCodes>(code => Label1.Text = Enum.GetName(typeof (ErrorCodes), code));
int number;
if (!int.TryParse(TextBox1.Text, out number))
{
    return;
}
Command command = new Command
              {
                  Id = number
              };

Global.Bus.Send("Samples.AsyncPages.Server", command)
    .Register<ErrorCodes>(code => Label1.Text = Enum.GetName(typeof (ErrorCodes), code));
int number;
if (!int.TryParse(TextBox1.Text, out number))
{
    return;
}
Command command = new Command
              {
                  Id = number
              };

Global.Bus.Send("Samples.AsyncPages.Server", command)
    .Register<ErrorCodes>(code => Label1.Text = Enum.GetName(typeof (ErrorCodes), code));

The first line of code simply parses the text passed in by the user. The second line creates a new NServiceBus message of the type Command, and initializes its Id property with the value from the text box.

Open the class definition for the Command type in the Shared project:

public class Command : IMessage
{
    public int Id { get; set; }
}
public class Command : IMessage
{
    public int Id { get; set; }
}
public class Command : IMessage
{
    public int Id { get; set; }
}

This class is very simple. The only special thing is the IMessage interface that it implements. This interface comes from NServiceBus and indicates that instances of this class can be sent and received by the bus. The IMessage interface itself is an empty marker interface. Read more about defining messages.

Return to Default.aspx.cs and look at the code Global.Bus.Send(command). Global.Bus references the Bus property of the Global class, which you saw in Global.asax.cs. Then the code calls the Send method, passing in the newly created command object.

The "bus" isn't anything special in code; it is just an object for calling methods.

Skip the rest of the code and see what happens to the message you just sent.

Handling the message

In the Server project, find this code in the CommandMessageHandler class:

public class CommandMessageHandler : IHandleMessages<Command>
{
    IBus bus;

    public CommandMessageHandler(IBus bus)
    {
        this.bus = bus;
    }

    public void Handle(Command message)
    {
        Console.WriteLine("Hello from CommandMessageHandler");

        if (message.Id%2 == 0)
        {
            bus.Return(ErrorCodes.Fail);
        }
        else
        {
            bus.Return(ErrorCodes.None);
        }
    }
}
public class CommandMessageHandler : IHandleMessages<Command>
{
    IBus bus;

    public CommandMessageHandler(IBus bus)
    {
        this.bus = bus;
    }

    public void Handle(Command message)
    {
        Console.WriteLine("Hello from CommandMessageHandler");

        if (message.Id%2 == 0)
        {
            bus.Return(ErrorCodes.Fail);
        }
        else
        {
            bus.Return(ErrorCodes.None);
        }
    }
}
public class CommandMessageHandler : IHandleMessages<Command>
{
    IBus bus;

    public CommandMessageHandler(IBus bus)
    {
        this.bus = bus;
    }

    public void Handle(Command message)
    {
        Console.WriteLine("Hello from CommandMessageHandler");

        if (message.Id%2 == 0)
        {
            bus.Return(ErrorCodes.Fail);
        }
        else
        {
            bus.Return(ErrorCodes.None);
        }
    }
}

This class implements the NServiceBus interface IHandleMessages<T> where T is the specific message type being handled; in this case, the Command message. NServiceBus manages classes that implement this interface. When a message arrives in the input queue, it is deserialized and then, based on its type, NServiceBus instantiates the relevant classes and calls their Handle method, passing in the message object.

The IBus property of the class is how it gets a reference to the bus. In the method body you can see it calling the Return method on the bus, which results in a message being returned to WebApplication, specifically putting a message in its input queue MyWebClient.

Handling the response

When the response arrives back at WebApplication, the bus invokes the callback that was registered when the request was sent by this code:

int number;
if (!int.TryParse(TextBox1.Text, out number))
{
    return;
}
Command command = new Command
              {
                  Id = number
              };

Global.Bus.Send("Samples.AsyncPages.Server", command)
    .Register<ErrorCodes>(code => Label1.Text = Enum.GetName(typeof (ErrorCodes), code));
int number;
if (!int.TryParse(TextBox1.Text, out number))
{
    return;
}
Command command = new Command
              {
                  Id = number
              };

Global.Bus.Send("Samples.AsyncPages.Server", command)
    .Register<ErrorCodes>(code => Label1.Text = Enum.GetName(typeof (ErrorCodes), code));
int number;
if (!int.TryParse(TextBox1.Text, out number))
{
    return;
}
Command command = new Command
              {
                  Id = number
              };

Global.Bus.Send("Samples.AsyncPages.Server", command)
    .Register<ErrorCodes>(code => Label1.Text = Enum.GetName(typeof (ErrorCodes), code));

The Register method takes the callback code and tells the bus to invoke it when the response is received. There are several overloads to this method; the code above accepts a generic Enum parameter, effectively casting the return code from the server to the given enum.

Finally, the code updates the Text property of a label on the web page, setting it to the string that represents the enum value: sometimes None, sometimes Fail.



Last modified 2015-03-05 10:08:24Z