AngularJS on top of ASP.NET: Moving the MVC framework out to the browser

Posted by Varun Chatterji on Simple Talk See other posts from Simple Talk or by Varun Chatterji
Published on Wed, 16 Oct 2013 14:12:12 +0000 Indexed on 2013/10/17 22:10 UTC
Read the original article Hit count: 828

Filed under:

Heavily drawing inspiration from Ruby on Rails, MVC4’s convention over configuration model of development soon became the Holy Grail of .NET web development. The MVC model brought with it the goodness of proper separation of concerns between business logic, data, and the presentation logic.

However, the MVC paradigm, was still one in which server side .NET code could be mixed with presentation code. The Razor templating engine, though cleaner than its predecessors, still encouraged and allowed you to mix .NET server side code with presentation logic. Thus, for example, if the developer required a certain <div> tag to be shown if a particular variable ShowDiv was true in the View’s model, the code could look like the following:

Fig 1: To show a div or not. Server side .NET code is used in the View

Fig 1: To show a div or not. Server side .NET code is used in the View

Mixing .NET code with HTML in views can soon get very messy. Wouldn’t it be nice if the presentation layer (HTML) could be pure HTML? Also, in the ASP.NET MVC model, some of the business logic invariably resides in the controller. It is tempting to use an anti­pattern like the one shown above to control whether a div should be shown or not.

However, best practice would indicate that the Controller should not be aware of the div. The ShowDiv variable in the model should not exist. A controller should ideally, only be used to do the plumbing of getting the data populated in the model and nothing else. The view (ideally pure HTML) should render the presentation layer based on the model.

In this article we will see how Angular JS, a new JavaScript framework by Google can be used effectively to build web applications where:

1. Views are pure HTML

2. Controllers (in the server sense) are pure REST based API calls

3. The presentation layer is loaded as needed from partial HTML only files.

What is MVVM?

MVVM short for Model View View Model is a new paradigm in web development. In this paradigm, the Model and View stuff exists on the client side through javascript instead of being processed on the server through postbacks. These frameworks are JavaScript frameworks that facilitate the clear separation of the “frontend” or the data rendering logic from the “backend” which is typically just a REST based API that loads and processes data through a resource model.

The frameworks are called MVVM as a change to the Model (through javascript) gets reflected in the view immediately i.e. Model > View. Also, a change on the view (through manual input) gets reflected in the model immediately i.e. View > Model. The following figure shows this conceptually (comments are shown in red):

Fig 2: Demonstration of MVVM in action

Fig 2: Demonstration of MVVM in action

In Fig 2, two text boxes are bound to the same variable model.myInt. Thus, changing the view manually (changing one text box through keyboard input) also changes the other textbox in real time demonstrating V > M property of a MVVM framework.

Furthermore, clicking the button adds 1 to the value of model.myInt thus changing the model through JavaScript. This immediately updates the view (the value in the two textboxes) thus demonstrating the M > V property of a MVVM framework.

Thus we see that the model in a MVVM JavaScript framework can be regarded as “the single source of truth“. This is an important concept. Angular is one such MVVM framework. We shall use it to build a simple app that sends SMS messages to a particular number.

Application, Routes, Views, Controllers, Scope and Models

Angular can be used in many ways to construct web applications. For this article, we shall only focus on building Single Page Applications (SPAs). Many of the approaches we will follow in this article have alternatives. It is beyond the scope of this article to explain every nuance in detail but we shall try to touch upon the basic concepts and end up with a working application that can be used to send SMS messages using Sent.ly Plus (a service that is itself built using Angular).

Before you read on, we would like to urge you to forget what you know about Models, Views, Controllers and Routes in the ASP.NET MVC4 framework. All these words have different meanings in the Angular world. Whenever these words are used in this article, they will refer to Angular concepts and not ASP.NET MVC4 concepts.

The following figure shows the skeleton of the root page of an SPA:

Fig 3: The skeleton of a SPA

Fig 3: The skeleton of a SPA

The skeleton of the application is based on the Bootstrap starter template which can be found at: http://getbootstrap.com/examples/starter­template/

Apart from loading the Angular, jQuery and Bootstrap JavaScript libraries, it also loads our custom scripts

/app/js/controllers.js /app/js/app.js

These scripts define the routes, views and controllers which we shall come to in a moment.

Application

Notice that the body tag (Fig. 3) has an extra attribute:

ng­app=”smsApp”

Providing this tag “bootstraps” our single page application. It tells Angular to load a “module” called smsApp. This “module” is defined /app/js/app.js

angular.module('smsApp', ['smsApp.controllers', function () {}])

Fig 4: The definition of our application module

The line shows above, declares a module called smsApp. It also declares that this module “depends” on another module called “smsApp.controllers”. The smsApp.controllers module will contain all the controllers for our SPA.

Routing and Views

Notice that in the Navbar (in Fig 3) we have included two hyperlinks to:

“#/app” “#/help”

This is how Angular handles routing. Since the URLs start with “#”, they are actually just bookmarks (and not server side resources). However, our route definition (in /app/js/app.js) gives these URLs a special meaning within the Angular framework.

angular.module('smsApp',  ['smsApp.controllers',  function  ()  {
}])
//Configure the  routes
.config(['$routeProvider',  function  ($routeProvider)  {
   $routeProvider.when('/binding',  {
      templateUrl:  '/app/partials/bindingexample.html', 
      controller:  'BindingController'
   });
}]);

Fig 5: The definition of a route with an associated partial view and controller

As we can see from the previous code sample, we are using the $routeProvider object in the configuration of our smsApp module. Notice how the code “asks for” the $routeProvider object by specifying it as a dependency in the [] braces and then defining a function that accepts it as a parameter. This is known as dependency injection. Please refer to the following link if you want to delve into this topic: http://docs.angularjs.org/guide/di

What the above code snippet is doing is that it is telling Angular that when the URL is “#/binding”, then it should load the HTML snippet (“partial view”) found at /app/partials/bindingexample.html. Also, for this URL, Angular should load the controller called “BindingController”.

We have also marked the div with the class “container” (in Fig 3) with the ng­view attribute. This attribute tells Angular that views (partial HTML pages) defined in the routes will be loaded within this div.

You can see that the Angular JavaScript framework, unlike many other frameworks, works purely by extending HTML tags and attributes. It also allows you to extend HTML with your own tags and attributes (through directives) if you so desire, you can find out more about directives at the following URL: http://www.codeproject.com/Articles/607873/Extending­HTML­with­AngularJS­Directives

Controllers and Models

We have seen how we define what views and controllers should be loaded for a particular route. Let us now consider how controllers are defined. Our controllers are defined in the file /app/js/controllers.js. The following snippet shows the definition of the “BindingController” which is loaded when we hit the URL http://localhost:port/index.html#/binding (as we have defined in the route earlier as shown in Fig 5).

Remember that we had defined that our application module “smsApp” depends on the “smsApp.controllers” module (see Fig 4). The code snippet below shows how the “BindingController” defined in the route shown in Fig 5 is defined in the module smsApp.controllers:

angular.module('smsApp.controllers',  [function  ()  {
}])
.controller('BindingController',  ['$scope',  function  ($scope)  {
   $scope.model  =  {};
   $scope.model.myInt  =  6;

   $scope.addOne  =  function  ()  {
      $scope.model.myInt++;
   }
}]);

Fig 6: The definition of a controller in the “smsApp.controllers” module.

The pieces are falling in place! Remember Fig.2? That was the code of a partial view that was loaded within the container div of the skeleton SPA shown in Fig 3. The route definition shown in Fig 5 also defined that the controller called “BindingController” (shown in Fig 6.) was loaded when we loaded the URL: http://localhost:22544/index.html#/binding

The button in Fig 2 was marked with the attribute ng­click=”addOne()” which added 1 to the value of model.myInt. In Fig 6, we can see that this function is actually defined in the “BindingController”.

Scope

We can see from Fig 6, that in the definition of “BindingController”, we defined a dependency on $scope and then, as usual, defined a function which “asks for” $scope as per the dependency injection pattern.

So what is $scope? Any guesses? As you might have guessed a scope is a particular “address space” where variables and functions may be defined. This has a similar meaning to scope in a programming language like C#.

Model: The Scope is not the Model

It is tempting to assign variables in the scope directly. For example, we could have defined myInt as $scope.myInt = 6 in Fig 6 instead of $scope.model.myInt = 6. The reason why this is a bad idea is that scope in hierarchical in Angular. Thus if we were to define a controller which was defined within the another controller (nested controllers), then the inner controller would inherit the scope of the parent controller. This inheritance would follow JavaScript prototypal inheritance.

Let’s say the parent controller defined a variable through $scope.myInt = 6. The child controller would inherit the scope through java prototypical inheritance. This basically means that the child scope has a variable myInt that points to the parent scopes myInt variable. Now if we assigned the value of myInt in the parent, the child scope would be updated with the same value as the child scope’s myInt variable points to the parent scope’s myInt variable.

However, if we were to assign the value of the myInt variable in the child scope, then the link of that variable to the parent scope would be broken as the variable myInt in the child scope now points to the value 6 and not to the parent scope’s myInt variable.

But, if we defined a variable model in the parent scope, then the child scope will also have a variable model that points to the model variable in the parent scope. Updating the value of $scope.model.myInt in the parent scope would change the model variable in the child scope too as the variable is pointed to the model variable in the parent scope.

Now changing the value of $scope.model.myInt in the child scope would ALSO change the value in the parent scope. This is because the model reference in the child scope is pointed to the scope variable in the parent. We did no new assignment to the model variable in the child scope. We only changed an attribute of the model variable. Since the model variable (in the child scope) points to the model variable in the parent scope, we have successfully changed the value of myInt in the parent scope. Thus the value of $scope.model.myInt in the parent scope becomes the “single source of truth“.

This is a tricky concept, thus it is considered good practice to NOT use scope inheritance. More info on prototypal inheritance in Angular can be found in the “JavaScript Prototypal Inheritance” section at the following URL: https://github.com/angular/angular.js/wiki/Understanding­Scopes.

Building It: An Angular JS application using a .NET Web API Backend

Now that we have a perspective on the basic components of an MVVM application built using Angular, let’s build something useful. We will build an application that can be used to send out SMS messages to a given phone number. The following diagram describes the architecture of the application we are going to build:

Fig 7: Broad application architecture

Fig 7: Broad application architecture

We are going to add an HTML Partial to our project. This partial will contain the form fields that will accept the phone number and message that needs to be sent as an SMS. It will also display all the messages that have previously been sent.

All the executable code that is run on the occurrence of events (button clicks etc.) in the view resides in the controller.

The controller interacts with the ASP.NET WebAPI to get a history of SMS messages, add a message etc. through a REST based API. For the purposes of simplicity, we will use an in memory data structure for the purposes of creating this application.

Thus, the tasks ahead of us are:

  1. Creating the REST WebApi with GET, PUT, POST, DELETE methods.
  2. Creating the SmsView.html partial
  3. Creating the SmsController controller with methods that are called from the SmsView.html partial
  4. Add a new route that loads the controller and the partial.

1. Creating the REST WebAPI

This is a simple task that should be quite straightforward to any .NET developer. The following listing shows our ApiController:

public class SmsMessage
{
   public string to { get; set; }
   public string message { get; set; }
}

public class SmsResource : SmsMessage
{
   public int smsId { get; set; }
}

public class SmsResourceController : ApiController
{
   public static Dictionary<int, SmsResource> messages = new Dictionary<int, SmsResource>();
   public static int currentId = 0;

   // GET api/<controller>
   public List<SmsResource> Get()
   {
      List<SmsResource>  result = new List<SmsResource>();
      foreach (int key in messages.Keys)
      {
         result.Add(messages[key]);
      }
      return result;
   }

   // GET api/<controller>/5
   public SmsResource Get(int id)
   {
      if (messages.ContainsKey(id))
         return messages[id];
      return null;
   }

   // POST api/<controller>
   public List<SmsResource>  Post([FromBody] SmsMessage value)
   {
      //Synchronize on messages so we don't have id collisions
      lock (messages)
      {
         SmsResource res = (SmsResource) value; 
         res.smsId = currentId++; 
         messages.Add(res.smsId, res);
         //SentlyPlusSmsSender.SendMessage(value.to, value.message);
         return Get();
      }
   }

   // PUT api/<controller>/5
   public List<SmsResource>  Put(int id, [FromBody] SmsMessage value)
   {
      //Synchronize on messages so we don't have id collisions
      lock (messages)
      {
         if (messages.ContainsKey(id))
         {
            //Update the message 
            messages[id].message  = value.message;
            messages[id].to = value.message;
         }
         return Get();
      } 
   }

   // DELETE api/<controller>/5
   public List<SmsResource>  Delete(int id)
   {
      if (messages.ContainsKey(id))
      {
         messages.Remove(id);
      } 
      return Get();
   }
}

Once this class is defined, we should be able to access the WebAPI by a simple GET request using the browser: http://localhost:port/api/SmsResource

Notice the commented line: //SentlyPlusSmsSender.SendMessage

The SentlyPlusSmsSender class is defined in the attached solution. We have shown this line as commented as we want to explain the core Angular concepts. If you load the attached solution, this line is uncommented in the source and an actual SMS will be sent!

By default, the API returns XML. For consumption of the API in Angular, we would like it to return JSON. To change the default to JSON, we make the following change to WebApiConfig.cs file located in the App_Start folder.

public static class WebApiConfig
{
   public static void Register(HttpConfiguration config) 
   {
      config.Routes.MapHttpRoute(
         name: "DefaultApi",
         routeTemplate: "api/{controller}/{id}",
         defaults: new { id = RouteParameter.Optional }
   );

   var appXmlType =  
      config.Formatters.XmlFormatter.
      SupportedMediaTypes.
      FirstOrDefault(
         t => t.MediaType == "application/xml");
   config.Formatters.XmlFormatter.SupportedMediaTypes.Remove(appXmlType);
   }
}

We now have our backend REST Api which we can consume from Angular!

2. Creating the SmsView.html partial

This simple partial will define two fields: the destination phone number (international format starting with a +) and the message. These fields will be bound to model.phoneNumber and model.message. We will also add a button that we shall hook up to sendMessage() in the controller. A list of all previously sent messages (bound to model.allMessages) will also be displayed below the form input. The following code shows the code for the partial:

<!--­­  If model.errorMessage  is defined,  then  render the  error div  -­­>

<div  class="alert  alert-­danger  alert-­dismissable"   style="margin­-top:  30px;" 
ng­-show="model.errorMessage  !=  undefined"> 
  <button  type="button"  class="close"  data­dismiss="alert"  aria­hidden="true">&times;</button>
  <strong>Error!</strong> 
<br  /> 
{{ model.errorMessage  }} 
</div> 

<!--­­  The  input  fields  bound  to  the  model  --­­>
<div  class="well"  style="margin-­top:  30px;"> 
   <table  style="width:  100%;">
      <tr> 
         <td  style="width:  45%;  text-­align:   center;"> 
            <input  type="text"  placeholder="Phone  number  (eg;  +44    7778  609466)" ng­-model="model.phoneNumber"  class="form-­control"  style="width:  90%"  onkeypress="return checkPhoneInput();"  /> 
         </td> 
         <td  style="width:  45%;  text-­align: center;"> 
            <input  type="text"  placeholder="Message"  ng­-model="model.message" class="form-­control"  style="width:  90%"  /> 
         </td>
         <td  style="text-­align:  center;">
            <button  class="btn  btn-­danger"  ng-­click="sendMessage();" ng-­disabled="model.isAjaxInProgress"  style="margin­right:  5px;">Send</button>
<img  src="/Content/ajax-­loader.gif"  ng­-show="model.isAjaxInProgress"  />
         </td>
      </tr>
   </table>
</div>

<!--­­  The  past  messages  ­­-->
<div  style="margin-­top: 30px;">

   <!­­--  The  following  div  is shown  if there  are no   past  messages  --­­>
   <div  ng­-show="model.allMessages.length  ==  0"> 
      No  messages  have been sent  yet!
   </div>

   <!--­­  The  following  div  is shown  if there  are some  past  messages  --­­>
   <div  ng-­show="model.allMessages.length  ==  0">
      <table  style="width:  100%;"  class="table  table-­striped">
         <tr>
            <td>Phone  Number</td>
            <td>Message</td>
            <td></td>
         </tr>

         <!--­­  The  ng-­repeat  directive  is line  the  repeater  control  in  .NET,  but  as you can see this partial is pure HTML which is much cleaner -->
         <tr  ng-­repeat="message  in  model.allMessages">
            <td>{{  message.to  }}</td>
            <td>{{  message.message  }}</td>
            <td>
               <button  class="btn  btn-­danger"  ng-­click="delete(message.smsId);" ng­-disabled="model.isAjaxInProgress">Delete</button>
            </td>
         </tr>
      </table>
   </div>
</div>

The above code is commented and should be self explanatory. Conditional rendering is achieved through using the ng-­show=”condition” attribute on various div tags.

Input fields are bound to the model and the send button is bound to the sendMessage() function in the controller as through the ng­click=”sendMessage()” attribute defined on the button tag.

While AJAX calls are taking place, the controller sets model.isAjaxInProgress to true. Based on this variable, buttons are disabled through the ng-­disabled directive which is added as an attribute to the buttons.

The ng-­repeat directive added as an attribute to the tr tag causes the table row to be rendered multiple times much like an ASP.NET repeater.

3. Creating the SmsController controller

The penultimate piece of our application is the controller which responds to events from our view and interacts with our MVC4 REST WebAPI.

The following listing shows the code we need to add to /app/js/controllers.js. Note that controller definitions can be chained. Also note that this controller “asks for” the $http service. The $http service is a simple way in Angular to do AJAX. So far we have only encountered modules, controllers, views and directives in Angular. The $http is new entity in Angular called a service. More information on Angular services can be found at the following URL: http://docs.angularjs.org/guide/dev_guide.services.understanding_services.

.controller('SmsController',  ['$scope',  '$http',  function  ($scope,  $http)  {
   //We  define  the  model
   $scope.model  =  {};

   //We  define  the  allMessages  array in  the  model
   //that  will  contain  all  the  messages  sent  so far
   $scope.model.allMessages  =  [];

    //The  error if any
    $scope.model.errorMessage  =  undefined;

   //We  initially  load  data  so set  the  isAjaxInProgress  =  true; 
   $scope.model.isAjaxInProgress  =  true;

   //Load  all  the  messages
   $http({
      url:  '/api/smsresource', method:  "GET"
   }).
   success(function  (data,  status,  headers,  config)  {

      this callback  will  be called  asynchronously
      //when  the  response is available
      $scope.model.allMessages  =  data;

      //We  are  done with  AJAX  loading
      $scope.model.isAjaxInProgress  =  false;
   }).

   error(function  (data,  status,  headers,  config)  {
      //called  asynchronously  if an   error occurs
      //or server  returns response with  an   error status.
      $scope.model.errorMessage  =  "Error  occurred  status:"  +  status;

      //We  are  done with  AJAX  loading
      $scope.model.isAjaxInProgress  =  false;
   });

   $scope.delete  =  function  (id)  {
   //We  are making  an   ajax  call  so we  set  this  to  true
   $scope.model.isAjaxInProgress  =  true;
   $http({
      url:  '/api/smsresource/'  +  id, 
      method:  "DELETE"
   }).

      success(function  (data,  status,  headers,  config)  {
         // this  callback  will  be called  asynchronously
         // when the  response is available
         $scope.model.allMessages  =  data;

         //We  are  done with  AJAX  loading
         $scope.model.isAjaxInProgress  =  false;
      });
      error(function  (data,  status,  headers,  config)  {
         // called  asynchronously  if an   error occurs
         // or server returns response with  an   error status.
         $scope.model.errorMessage  =  "Error  occurred  status:"  +  status;

         //We are  done with  AJAX  loading
         $scope.model.isAjaxInProgress  =  false;
      });
   }

   $scope.sendMessage  =  function  ()  {
      $scope.model.errorMessage  =  undefined;

      var  message  =  '';

      if($scope.model.message  !=  undefined)
         message  =  $scope.model.message.trim();

      if ($scope.model.phoneNumber  ==  undefined  ||
         $scope.model.phoneNumber  ==  '' ||
         $scope.model.phoneNumber.length  <  10   ||
         $scope.model.phoneNumber[0]  !=  '+')  {
            $scope.model.errorMessage  =  "You  must  enter  a valid  phone  number  in international  format.  Eg:  +44   7778  609466";
            return;
      }

      if (message.length  ==  0)  {
         $scope.model.errorMessage  =  "You  must  specify  a message!";
         return;
      }

      //We  are making  an   ajax  call  so we  set  this  to  true
      $scope.model.isAjaxInProgress  =  true;

     $http({
        url:  '/api/smsresource', method:  "POST",
        data:  { to:  $scope.model.phoneNumber,  message:  $scope.model.message  }
     }).

     success(function  (data,  status,  headers,  config)  {
        // this callback  will  be called  asynchronously
        // when the  response is available
        $scope.model.allMessages  =  data;

        //We are  done with  AJAX  loading
        $scope.model.isAjaxInProgress  =  false;
     }).
     error(function (data,  status,  headers,  config)  {
        // called asynchronously if an error occurs
        // or server  returns response with  an   error status.
        $scope.model.errorMessage  =  "Error  occurred  status:"  +  status

        // We are  done with  AJAX  loading
        $scope.model.isAjaxInProgress  =  false;
     });
  }
}]);

We can see from the previous listing how the functions that are called from the view are defined in the controller. It should also be evident how easy it is to make AJAX calls to consume our MVC4 REST WebAPI. Now we are left with the final piece. We need to define a route that associates a particular path with the view we have defined and the controller we have defined.

4. Add a new route that loads the controller and the partial

This is the easiest part of the puzzle. We simply define another route in the /app/js/app.js file:

$routeProvider.when('/sms',  {
      templateUrl:  '/app/partials/smsview.html', 
      controller:  'SmsController'
   });

Conclusion

In this article we have seen how much of the server side functionality in the MVC4 framework can be moved to the browser thus delivering a snappy and fast user interface.

We have seen how we can build client side HTML only views that avoid the messy syntax offered by server side Razor views.

We have built a functioning app from the ground up.

The significant advantage of this approach to building web apps is that the front end can be completely platform independent. Even though we used ASP.NET to create our REST API, we could just easily have used any other language such as Node.js, Ruby etc without changing a single line of our front end code.

Angular is a rich framework and we have only touched on basic functionality required to create a SPA. For readers who wish to delve further into the Angular framework, we would recommend the following URL as a starting point: http://docs.angularjs.org/misc/started.

To get started with the code for this project:

  1. Sign up for an account at http://plus.sent.ly (free)
  2. Add your phone number
  3. Go to the “My Identies Page”sently
  4. Note Down your Sender ID, Consumer Key and Consumer Secret
  5. Download the code for this article at: https://docs.google.com/file/d/0BzjEWqSE31yoZjZlV0d0R2Y3eW8/edit?usp=sharing
  6. Change the values of Sender Id, Consumer Key and Consumer Secret in the web.config file
  7. Run the project through Visual Studio!

© Simple Talk or respective owner

Related posts about ASP.NET MVC