Click here to Skip to main content
15,860,859 members
Articles / Programming Languages / C#

.NET Interprocess Communication Revisited

Rate me:
Please Sign up or sign in to vote.
4.96/5 (30 votes)
4 Jan 2010CPOL4 min read 120.8K   2.3K   111   65
The XDMessaging 2.0 library provides an easy-to-use, zero configuration alternative to existing IPC implementations.

Introduction

The XDMessaging library provides an easy-to-use, zero configuration solution to same-box communications. It provides a simple API for broadcasting and receiving messages across application and process boundaries.

Version 1.0 was originally developed to use low-level Windows Messaging and to offer a performant solution for Windows Forms based applications. However, the restriction in using Windows Messages is that it does not provide a way to communicate with non-Forms based applications such as Windows Services which don't have their own message pump.

Version 2.0 now extends the library further, and provides a second file IO based transport mode for messaging. The new IOStream mode can be used to communicate with Windows services, console apps, and continues to work with Forms based applications.

The library allows the use of user-defined pseudo channels through which messages may be sent and received. Any application can send a message to any channel, but it must register as a listener with the channel in order to receive. In this way, developers can quickly and programmatically devise how their applications will communicate with each other best, to work in harmony.

Advantages

The XDMessaging library offers some advantages over other IPC technologies like WCF, .NET Remoting, Sockets, NamedPipes, and MailSlots. To begin with, the library does not require a server-client relationship as there is no physical connection between processes.

With XDMessaging, messages can be broadcast by multiple applications, and instantly received by multiple listeners in a disconnected fashion. MailSlots offer the closest match to this functionality; however, I found this had a few limitations. Although messages are also disconnected, there is no way to peek at a message, and as soon as the message is read, it is removed from the MailSlot. It's great for broadcasting messages, but limited to a single client for receiving the message. The other limitation is that messages are not instant, and requires polling of the MailSlot.

It's also worth noting that most of the existing IPC implementations require the opening of specific ports and a somewhat painful configuration of settings to make them work. With XDMessaging, there is no configuration; the API determines where messages are sent, and which messages are received using pseudo channels. The disadvantage is that communication is limited to a single machine, so for network communication, other IPC technologies such as WCF are much more suited.

Using the Library

To use the library, create an instance of a IXDBroadcast and use this to send a message to a named channel. You can then create an instance of IXDListener to receive messages on a particular channel. The channels are arbitrary strings chosen to represent a channel, and are not case sensitive.

Before creating the broadcast and listener instances, you must first decide which transport mode you want to use for the library. There are two modes as follows, and each has advantages over the other.

Transport Modes

  • IOStream: This uses file based IO to broadcast messages via a shared directory. A FileSystemWatcher is used within listener classes to monitor changes and trigger the MessageReceived event containing the broadcast message. This mode can be used in Windows Services, console applications, and Windows Forms based applications. Channels are created as separate directories on the file system for each channel. The temporary directories should be accessible by all processes, and there should be no need for manual configuration.
  • WindowsMessaging: This uses the WM_COPYDATA Windows message to copy data between applications. The broadcast implementation sends the Windows messages directly to a hidden window on the listener instance, which dispatches the MessageReceived event with the copied data. Channels are created by adding/removing Windows properties. This offers the most performant solution for Windows Forms based applications, but does not work for Windows Services, console apps, or other applications without a message pump.

Note: Messages broadcast using a particular mode can only be read by applications using a listener in the same mode. For example, IOStream listeners cannot read messages broadcast in the WindowsMessaging mode.

See the included sample applications for more information on using the library in Windows Forms applications or within a Windows Service.

Examples

Example: Sending a message in a particular mode:

C#
// Create an instance of IXDBroadcast using IOStream mode
IXDBroadcast broadcast = XDBroadcast.CreateBroadcast(XDTransportMode.IOStream);

// or create an instance of IXDBroadcast using WindowsMessaging mode
IXDBroadcast broadcast = XDBroadcast.CreateBroadcast(XDTransportMode.WindowsMessaging);

// Send shutdown message to a channel named commands
broadcast.SendToChannel("commands", "shutdown");

Example: Listening for messages on a particular channel:

C#
// Create our listener instance using IOStream mode
IXDListener listener = XDListener.CreateListener(XDTransportMode.IOStream);

// or create our listener using WindowsMessaging mode
IXDListener listener = XDListener.CreateListener(XDTransportMode.WindowsMessaging);

// Register channels to listen on
listener.RegisterChannel("events");
listener.RegisterChannel("status");
listener.RegisterChannel("commands");

// Stop listening on a specific channel
listener.UnRegisterChannel("status");

Example: Handling the messages:

C#
// Attach an event handler to a listener instance
listener.MessageReceived+=XDMessageHandler(this.listener_MessageReceived);

// process the message
private void listener_MessageReceived(object sender, XDMessageEventArgs e)
{
 // e.DataGram.Message is the message
 // e.DataGram.Channel is the channel name
 switch(e.DataGram.Message)
 {
  case "shutdown":
             this.Close();
      break;
 }
}

Further Reading

History

  • 12 Dec 2009: Initial release
  • 16 Dec 2009: Optimized performance
  • 4 Jan 2010: Adding network propagation support via MailSlots

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Architect
United Kingdom United Kingdom
Mike Carlisle - Technical Architect with over 20 years experience in a wide range of technologies.

@TheCodeKing

Comments and Discussions

 
GeneralRe: Windows Server 2008 Pin
TheCodeKing12-Mar-10 9:24
TheCodeKing12-Mar-10 9:24 
GeneralAwesome solution Pin
Ondrej Salplachta14-Feb-10 0:52
Ondrej Salplachta14-Feb-10 0:52 
GeneralAdditional Features & Thoughts Pin
sam.hill1-Jan-10 9:42
sam.hill1-Jan-10 9:42 
GeneralRe: Additional Features & Thoughts Pin
TheCodeKing1-Jan-10 11:57
TheCodeKing1-Jan-10 11:57 
GeneralNew features coming soon... Pin
TheCodeKing16-Dec-09 14:21
TheCodeKing16-Dec-09 14:21 
GeneralRe: New features coming soon... Pin
TheCodeKing17-Dec-09 10:38
TheCodeKing17-Dec-09 10:38 
GeneralRe: New features coming soon... Pin
sam.hill18-Dec-09 17:04
sam.hill18-Dec-09 17:04 
GeneralRe: New features coming soon... [modified] Pin
TheCodeKing19-Dec-09 0:02
TheCodeKing19-Dec-09 0:02 
Oh really? Which OS are you running on?

I've uploaded 2.0.2.2 which writes any unhanded exceptions to a log file. Please could you let me know the details and I'll implement a fix. Seems like the MailSlot read/write might be failing for some reason.


modified on Saturday, December 19, 2009 8:49 AM

GeneralRe: New features coming soon... [modified] Pin
sam.hill19-Dec-09 6:43
sam.hill19-Dec-09 6:43 
GeneralRe: New features coming soon... Pin
TheCodeKing20-Dec-09 9:18
TheCodeKing20-Dec-09 9:18 
GeneralRe: New features coming soon... Pin
sam.hill20-Dec-09 16:33
sam.hill20-Dec-09 16:33 
GeneralRe: New features coming soon... Pin
TheCodeKing21-Dec-09 7:19
TheCodeKing21-Dec-09 7:19 
GeneralRe: New features coming soon... Pin
sam.hill21-Dec-09 18:32
sam.hill21-Dec-09 18:32 
GeneralRe: New features coming soon... Pin
TheCodeKing21-Dec-09 22:15
TheCodeKing21-Dec-09 22:15 
GeneralRe: New features coming soon... Pin
sam.hill22-Dec-09 5:48
sam.hill22-Dec-09 5:48 
GeneralRe: New features coming soon... Pin
TheCodeKing22-Dec-09 7:50
TheCodeKing22-Dec-09 7:50 
GeneralRe: New features coming soon... Pin
TheCodeKing1-Jan-10 5:39
TheCodeKing1-Jan-10 5:39 
GeneralBy George, I Think You've Done It! Pin
sam.hill1-Jan-10 9:22
sam.hill1-Jan-10 9:22 
Generalthe title Pin
Akram Ben Hassan14-Dec-09 1:06
Akram Ben Hassan14-Dec-09 1:06 
GeneralRe: the title Pin
TheCodeKing14-Dec-09 1:13
TheCodeKing14-Dec-09 1:13 
GeneralExcellent Work [modified] Pin
sam.hill13-Dec-09 8:32
sam.hill13-Dec-09 8:32 
GeneralRe: Excellent Work Pin
TheCodeKing13-Dec-09 12:04
TheCodeKing13-Dec-09 12:04 
GeneralRe: Excellent Work Pin
TheCodeKing14-Dec-09 1:48
TheCodeKing14-Dec-09 1:48 
GeneralRe: Excellent Work Pin
sam.hill14-Dec-09 7:58
sam.hill14-Dec-09 7:58 
GeneralRe: Excellent Work Pin
TheCodeKing15-Dec-09 16:47
TheCodeKing15-Dec-09 16:47 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.