Click here to Skip to main content
Click here to Skip to main content

SignalR Online Counter Sample

, 22 Apr 2013
Rate this:
Please Sign up or sign in to vote.
A very simple SignalR Web Application which counts how many users are online.

SignalR is a web technology for building real time ASP.NET web applications. SignalR is an open source project which simplifies the complicated tasks of creating bidirectional communication between clients and server. SignalR is founded on top of WebSockets, as well as other similar technologies.

As you probably know WebSockets introduced a new way to communicate between server and clients, and it is specified by the HTML5 API specification. When it is available SignalR will use this technology, otherwise it will use what is supported by your system. SignalR also provides a high-level API for server communication to client RPC (call JavaScript functions in clients’ browsers from server-side .NET code) in ASP.NET applications, as well as adds useful hooks for connection management, e.g., connect/disconnect events, grouping connections, authorization. More information about SignalR can be found on the official web site for SignalR.

For this post I have implemented a very simple SignalR Web Application which counts how many users are online, so it is called Online Counter. Online Counters are a very popular component for the web.

So let’s start with the implementation.

  1. Open Visual Studio 2012, and create new Empty Web Application called OnlineCounter.

SignalR_image1

The first thing we will do is adding SignalR reference for the clients (JavaScript files) and the Server (.NET Components).

2. So open NuGet Manager console and input the following command: Install-Package Microsoft.AspNet.SignalR –Pre

SignalR_image2

After we added SignalR references, we are implementing Server side of the SignalR HitCounter Web Application.

3. Add a new class named HitCounter.

SignalR_image3

The HitCounter class must be derived from the Hub. More info about Hub and other SignalR components you can find on the official site.

The implementation for the HitCounter class is shown below:

public class HitCounter : Hub
{
 private static int clientCounter = 0;

 public void Send()
 {
 string message = "";
 // Call the recalculateOnlineUsers method to update clients
 if(clientCounter<2)
 message = string.Format("Currently {0} user is online.",clientCounter);
 else
 message = string.Format("Currently {0} users are online.", clientCounter);

 Clients.All.recalculateOnlineUsers(message);
 }

 ///
/// register online user
 ///
 ///
 public override System.Threading.Tasks.Task OnConnected()
 {
 clientCounter++;
 return base.OnConnected();
 }

 ///
/// unregister disconected user
 ///
 ///
 public override System.Threading.Tasks.Task OnDisconnected()
 {
 clientCounter--;
 return base.OnDisconnected();
 }
}

As you can see from the source code, we have override two virtual methods when user is reach the page, and also when the user live the page. The Send method is responsible to send message to all available clients.

We need also to implement Global Application Class to register this hub.

4. Add Global Application Class in to your project, and register MapHubs, as picture shows below.

SignalR_image4

The following code implementation shows how to register Hub in the Global App class.

public class Global : System.Web.HttpApplication
{
    protected void Application_Start(object sender, EventArgs e)
    {
        // Register the default hubs route: ~/signalr/hubs
        RouteTable.Routes.MapHubs();
    }
    //rest of the implememtation.....

After we implemented Services side of SignalR, we need to implement client side.

5. Add new html web page in to project.

SignalR_image6

6. Include standard set of JavaScript files necessary for SignalR client to run.

<!--Script references. -->
<!--Reference the jQuery library. -->
<script type="text/javascript" src="Scripts/jquery-1.6.4.min.js"></script>
  <!--Reference the SignalR library. --><script type="text/javascript" 
    src="Scripts/jquery.signalR-1.0.0-rc2.js"></script>
<!--Reference the autogenerated SignalR hub script. -->
<script type="text/javascript" src="/signalr/hubs"></script>

7. Send Notification to Server that the new user is reached the page.
8. Implemet JavaScript code to receive recalculateOnlineUser event sent from server.

$(function () {

    // Declare a proxy to reference the hub.
    var counter = $.connection.hitCounter;

    // register online user at the very begining of the page
    $.connection.hub.start().done(function () {
        // Call the Send method on the hub.
        counter.server.send();
    });

    // Create a function that the hub can call to recalculate online users.
    counter.client.recalculateOnlineUsers = function (message) {

        // Add the message to the page.
        $('paragraph').text(message);
    };

});

9. Compile and run the code. Open two Browser Windows. You can see that SignalR has counted two online users.

SignalR_image7

Source code for this blog post demo you can find below.

Source code link.

License

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

Share

About the Author

Bahrudin Hrnjica
Software Developer (Senior)
Bosnia And Herzegovina Bosnia And Herzegovina
Senior Software Developer at daenet.eu and Microsoft MVP for Visual C#.
Follow on   Twitter   Google+

Comments and Discussions

 
Questiontanks Pinmemberbabak354810-Dec-13 0:44 
Questiondesign flaws PinmemberVahid_N28-Nov-13 0:06 
QuestionError when running in IIS rather than IIS Express PinmemberMember 103267949-Oct-13 17:34 
QuestionSignalR Deployment Problem Pinmembersimanchal@gmx.com24-Sep-13 22:19 
QuestionJavaScript runtime error PinmemberMo Kash2-Jun-13 23:49 
AnswerRe: JavaScript runtime error PinmemberBahrudin Hrnjica4-Jul-13 20:06 
QuestionI like this article! PinmemberMo Kash31-May-13 1:53 
GeneralMy vote of 4 PinmemberMo Kash31-May-13 1:48 
QuestionRegarding hub url for autogenerated code PinmemberTridip Bhattacharjee22-Apr-13 3:41 
AnswerRe: Regarding hub url for autogenerated code PinmemberBahrudin Hrnjica22-Apr-13 22:24 
GeneralMy vote of 5 PinmemberMember 43208448-Feb-13 6:42 

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

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

| Advertise | Privacy | Mobile
Web04 | 2.8.140827.1 | Last Updated 23 Apr 2013
Article Copyright 2013 by Bahrudin Hrnjica
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid