Skip to Content

Let’s first refresh our memory on SAPUI5 controller. I have a simple xml view which only contains a button:

<core:View xmlns:core="sap.ui.core" xmlns:common="sap.ui.commons" controllerName="buttontutorial.view.simple">
<common:Button text="Jerry" id="jerryButton"/>
</core:View>

And a simple controller:

sap.ui.define(["sap/ui/core/mvc/Controller"], function(Controller){
"use strict";
return Controller.extend("buttontutorial.view.simple",{
onInit : function() {
  debugger;
}
  });}
);

due to the attribute controllerName=”buttontutorial.view.simple” in XML view, the controller instance is created and connect with XML view instance by UI5 framework:

/wp-content/uploads/2016/07/clipboard1_987438.png

And we can use JavaScript code in console to list the larget number of attributes belonging to created controller instance:

for( var name in this ) { console.log("attribute: " + name + " value: " + this[name]);}

/wp-content/uploads/2016/07/clipboard2_987439.png

Or you can simply type “this.” in console, and see there are lots of methods available for controller instance:

/wp-content/uploads/2016/07/clipboard3_987479.png

For example, byId method of controller instance is widely used, if you type this.byId in console, you can see its implementation just delegates the call to this.oView.byId.

/wp-content/uploads/2016/07/clipboard4_987480.png

This makes sense since every controller instance holds a reference to its host view via oView, and the connection between controller and its view is established in function connectToView:

/wp-content/uploads/2016/07/clipboard5_987481.png

Angular Controller

You can play with the sample Angular application from this url.

/wp-content/uploads/2016/07/clipboard7_987485.png

It consists of 31 lines of source code:

<html ng-app>
  <head>
    <meta charset="utf-8">
    <title>Angular.js Example</title>
    <script src="angular/angular.js"></script>
    <script>
      function NameCtrl($scope){
        $scope.names = ['ABAP', 'Java'];
        $scope.addName = function() {
          if( $scope.names.indexOf($scope.enteredName) != -1){
            alert("duplicate key is not allowed in list: " + $scope.enteredName);
            $scope.enteredName = '';
            return;
          }
          $scope.names.push($scope.enteredName);
          $scope.enteredName = '';
        };
    }
    </script>
  </head>
  <body ng-controller="NameCtrl">
    <ul>
      <li ng-repeat="name in names">{{name}}
      </li>
    </ul>
    <form ng-submit="addName()">
      <input type="text" ng-model="enteredName">
      <input type="submit" value="add">
    </form>
  </body>
</html>

When you type a new language in input field and click “Add” button, the language will be added into list above:

/wp-content/uploads/2016/07/clipboard8_987486.png

Let me first briefly introduce the idea of source code, then I will go through with each point in detail.

/wp-content/uploads/2016/07/clipboard9_987487.png

1. controller instance initialization

During Angular bootstrap phase, due to this line of source code in html, <body ng-controller=”NameCtrl”>, Angular will create a new controller instance in line 5327. You can consider $controller as a factory function.

/wp-content/uploads/2016/07/clipboard1_987438.png

Let’s have a look at the content of argument locals for factory function:

/wp-content/uploads/2016/07/clipboard2_987439.png

The most important attribute is $scope, which is passed into function NameCtrl defined by us:

/wp-content/uploads/2016/07/clipboard1_987438.png

Once our application code is executed, controller instance is created. However, after checking it in Chrome, I found it is just a dummy instance without any important attribute. Instead, the data model and addName function are appended and available in current scope:

/wp-content/uploads/2016/07/clipboard2_987439.png

2. How addFunction available in scope object will be called when add button is called

Based on study result in step1, the addName function is located in scope object. My question is, when I press add button, why is it called?

In previous blog Compare Event handling mechanism: SAPUI5 and Angular, I already introduced that Angular does event handler registration automatically for us, as long as it detects the directive like this:

<form ng-submit=”addName()”>.

Actually I have made modifications on angular.js, adding more trace so that you can easily find where Angular achieves event registration under the hood:

/wp-content/uploads/2016/07/clipboard1_987438.png

/wp-content/uploads/2016/07/clipboard2_987439.png

/wp-content/uploads/2016/07/clipboard3_987479.png

So it is called as expected:

/wp-content/uploads/2016/07/clipboard4_987480.png

Summary

UI5 controller instance has a large number of useful functions available to use, and for Angular, controller instance is just a dummy one: data model and event handler function are located in scope object instead.

To report this post you need to login first.

Be the first to leave a comment

You must be Logged on to comment or reply to a post.

Leave a Reply