Friday, July 17, 2015

Javascript Prototypes and Prototype Pattern

JAVASCRIPT PROTOTYPES

Reason why i am blogging about this because i seriously like to share how i got my confusion removed regarding JavaScript Prototypes, i used prototypes for last 3 years just because someone has used it and with a confusion regarding its basics i was just implementing it, this is the case with many of us and this is one of the most confusing topic until unless you don't explore it practically.

I will show you how i actually got clear about prototype and finally i love these and consider its pattern as the most handy and important when comes to developing APPS.

Note:- I am using Chrome Developer tools console tab for demonstrations.

Prototype, as per the oxford dictionary a prototype is  :-

A first, typical or preliminary model of something, especially a machine, from which other forms are developed or copied.

So in simple words prototype is a model to create copies out of, and if i relate it at this point with JavaScript and my programming knowledge so it must be my functional blueprints to create objects out of, which is partially true but it has more functionality, now lets see what popular article says about prototype as single lines definitions:-
  1. A prototype is an object from which other objects inherit properties.
  2. Every JavaScript object has a prototype. The prototype is also an object.
  3. All JavaScript objects inherit their properties and methods from their prototype.
So keeping above three definitions in mind i thought to explore it Chrome browser console and see the practicality of definitions. But first for folks  who does not know what a JavaScript object is!
 here is a quick information:-

JavaScript Object (Layman Language {key:value} )
A JavaScript object is really just an unordered collection of key:value pairs, and you create  key:value pairs separated by commas and packed in Mustaches(Curly Braces):-

var Student = {Name:'John Doe', ID:1} // this is a container with properties.


A JavaScript object contains properties as shown above and can also contain methods/functions too :-

var Student = {Name:'John Doe', ID:1,SayHi:function(){alert('hey By ' + this.Name)}}

And to access property one has to use:- Student.Name or Student['Name']

To access methods:-
Student.SayHi();

Analyze JavaScript Object in Chrome console window for prototype

Open Chrome, default will be google.com, and just press F12 open console (Open Console window, i have put it in the source tab)
  1. There are many ways to create a simple blank object:-

  2. As you can see above i created ankur1,ankur2 and ankur object by different ways.
  3. Now when i checked my object ankur i can see some method which says ankur.isPrototypeOf () which raised my eye brows and immediately i thought using this method i can actually verify and relate the second definition which says every Object has a prototype.
Now if every object has prototype which is an object then there ankur.prototype should be that property/object.
Thinking the same when i checked in my browser console i got surprised to see that ankur.prototype is undefined:-

so is the definition wrong or confusing? Actually it turned out that it was  confusing not wrong:-

The true prototype of an object is held by the internal [[Prototype]] property. ECMA 5 introduces the standard accessor Object.getPrototypeOf(object) which to-date is implemented in Firefox, Safari, Chrome and IE9. In addition all browsers except IE support the non-standard accessor __proto__


And every object is created using with a Constructor initiation so we can access prototype object using prototype property of constructor too(this works in every browser):-


Now this gave me a bigger clarification on the definition of prototype:-

Every JavaScript object has a prototype. The prototype is also an object.

 Lets move forward and analyze the use of prototypes with its two other significant definition:-

  • A prototype is an object from which other objects inherit properties.
  • All JavaScript objects inherit their properties and methods from their prototype.


To show exactly what these two definition mean, we need first to know something very unique to functions in javscript:-

Every function in javscript has a property called prototype, and we use functions to create objects like i did above when used function Object() with new to create ankur1, just see this :-


Now as shown in the console above, we created a new function Myfunction and it does have a prototype Object which is the same when we create a new object as "new Myfunction()" and try to get the Prototype of that Object.

This prototype property does have significance when  functions are used as constructors to construct a Javascript Object.
A function’s prototype property is the object that will be assigned as the prototype to all instances created when this function is used as a constructor.

There is chain in javascript Objects, every Objects inherits from Object.prototype which sits at the top of the Chain.

Moving forward, i saw many examples on net where people have defined one level of inheritance using Protoypes, you can find multiple blogs which talks about single level of inheritance like this example:-



var humanConstructor = function human(name) { this.Name = name };
var Male = new humanConstructor("Man");
var Female = new humanConstructor("woman");
//later on i added this..
humanConstructor.prototype.From = function () {
    this.Name === "Man" ? alert("I am from Mars") : alert("I am from Venus");
}

Male.From();//Output:"I am from Mars"
Female.From();//Output: "I am from Venus"

The above example is very nice and simple one level inheritance example of prototypes definition mentioned above.
I just added From later on and automatically it got inherited by my objects.

Using this way i can customize my initial functions(constructors) and add Methods to prototype Object later on, Automatically all my Objects constructed using initial function will get new methods.
But it stores the reference of prototype not the value.


Till this it was fine, but later i thought:-
How can i create a Object from Male(from above example)  example Boy, and test multilevel inheritance and Chain behavior. And if i try to do this :-


var Boy = new Male(); //This will give error.

I got error:-

So, after a research i learned about Object.create()

So What does actually Object.create() do?

  • Object.create(proto [, propertiesObject ])

It extends a prototype and also can add properties using propertiesObject parameter.

So this is the way to create multilevel inheritance and define the chain mechanism in prototype.

See the use of Object.create():- here:-




var humanConstructor = function human(name) { this.Name = name };

var Male = new humanConstructor("Man");
var Female = new humanConstructor("woman");

//later on i added this..
humanConstructor.prototype.From = function () {
    this.Name === "Man" ? alert("I am from Mars") : alert("I am from Venus");
}

Male.From();
Female.From();
Male.About = "I am the man";
//Object.getPrototypeOf(Boy).About = "My Name is George, and i am  a Male";
var Boy = Object.create(Male);
alert(Boy.About);//I am the Man
alert(Female.About);//Unidentified
alert(Boy.Name);//Man
alert(Female.Name);//woman


One practical use of prototypes:-
This was where i recently used prototypes, i created a single page app that is meant to work on every browser, it was required to work even in IE8, there is a function in latest browsers called  "toISOString()", this was not working in IE8 and some other versions of browsers, but i did used it excessively, so to overcome the issue i used prototypes and created this :-



 if (!Date.prototype.toISOString) {
        (function () {
            function pad(number) {
                var r = String(number);
                //it takes data type in consideration...
                if (r.length === 1) {

                    r = '0' + r;
                }
                return r;

            }

            //here in this case of prototype pattern, this is the object/datatype on which prototype is applied.
            Date.prototype.toISOString = function () {

                return this.getUTCFullYear()
                   + '-' + pad(this.getUTCMonth() + 1)
                   + '-' + pad(this.getUTCDate())
                   + 'T' + pad(this.getUTCHours())
                   + ':' + pad(this.getUTCMinutes())
                   + ':' + pad(this.getUTCSeconds())
                   + '.' + String((this.getUTCMilliseconds() / 1000).toFixed(3)).slice(2, 5)
                   + 'Z';
            };
        }());
    }

Still there is enough left to discuss about JavaScript Prototype but in this blog i wanted to discuss the actual basics of prototypes with practical impressions. Hope it helps.

Tuesday, July 14, 2015

JavaScript Closures (Step 1 for App development)

JavaScript Closures

In this blog i like to write and discuss about the Closures in JavaScript, i am using JavaScript in SharePoint sites from 2007 version, In my first working assignment i was told to premeditate a Site template made using SPServices and Jquery to new SharePoint JavaScript client object model Site back in 2009, It was a Template which enables functionality of  Twitter on SharePoint. But that time i just created and written everything in functions which were added under Global namespace automatically.
And this is normally we do in creating our applications or making some modifications, but with the advancement in client side programming and trend of Single Page applications and many other factors  has introduced design patterns and writing javascript libraries.

To make such libraries one basic important concept is Closure.

A closure is concept made out of anonymous functions and a basic fact in javascript that an anonymous function can be returned from other functions, like it  can also be assigned to a variable

Local variables defined within the containing function are available through the returned anonymous function and this is called Closure.

Now lets see this in a series of examples:-


  1. Basic Closure example:-
    var Maddy = window.Maddy || {};
    
    Maddy.getStudentName = function Student(id) {
        var students = { '1': 'ankur', '2': 'nelson', '3': 'drew' };
        var getName = function () {
            alert(students[id]);
        };
        return getName;
    
    };
    
    Maddy.getStudentName(3)();
    


    here we have a namespace Maddy and under that we have a function getStudentName which incorporates an anonymous function accessing local variable students  and retrieving the value of name of student contained in students variable.

    We have just returned the function to the original function.
  2. The inner function is the closure in above example, it has three access chains, it can access its own variable and variables scoped to outer function and also can access Global function, but it can not access arguments directly of outer function, see this example:-

    Look at this example which does not use Closure:-

    Maddy.addArguments = function()
    {
        var sum =0;
        for(var i=0;i<arguments.length;i++)
        {
    
            sum += Number(arguments[i]);
        }
    
        return sum;
    }
    alert(Maddy.addArguments(1,2,3,4,5));
    
    

    It will work perfectly and will give you output of 15.

    Now if you use Closure and try to access arguments it wont work.

    Maddy.addArgumentsWithclosure = function () {
        var sum = 0;
    
        var doTheSum = function () {
            for (var i = 0; i < arguments.length; i++) {
    
                sum += Number(arguments[i]);
            }
    
            return sum;
        };
        return doTheSum;
    };
    
    alert(Maddy.addArguments(1,2,3,4,5)());
    

    it will return '0' in alert and wont work.

    So Closure can access local,outer and global variables but cant work with outer function arguments object.
  3. Closures have access to the outer function’s variable even after the outer function returns, also it stores references to the outer function’s variables;

    example demonstration:-

    Maddy.getValueID = function () {
        var valueId = 101;
    
    
        return {
    
            get_valueId: function () {
    
                return valueId;
            },
    
            set_valueId: function (newValue) {
                valueId = newValue;
            }
    
    
    
        };
    
    };
    
    var dummyVar = Maddy.getValueID();
    alert(dummyVar.get_valueId()); //output will be 101
    dummyVar.set_valueId(1000); 
    alert(dummyVar.get_valueId()); //output will be 1000
    
    
As shown above set_valueId closure still keeps reference to outer function variables even outer functions is allready executed.

Wednesday, July 1, 2015

Configure HostHeaders for SharePoint Web Application in Dev Boxes.

Hi,

How bad it looks when developing our applications in our dev boxes we use url's like http://xyz-servername:port/

With 2013 to configure apps we need to have some DNS entries created. But traditionally not every developer care to have dns entries created for web applications in dev boxes.

Also learning from my past lessons with different urls in Dev and Production for the simmilar sites, sometimes you have to manually change the urls in infopath forms, workflows to republish the working stuff.

To make things better, here is the way i am sharing on how to configure host header and edit bindings to let the host header work for you without configuring anything on DNS.

We will use Powershell to modify the host file and will also set bindings on IIS to make WebApplication availlable outside the server.

Here are the steps:-

  1. Create a WebApplication (You can extend one if you want to override the existing one).
    I just have created a normal web application with host header "ankurmadaan" and port i used is 80. Note:- i allready have a sharepoint default web application on port 80.
  2. Now we need a root site collection,  I like to keep my site collections in there own database, for me it will be root collection so it will go into default database.

  3. So now if you try to browse, you will be surprise to see that your site does not works, unless you have an entry for http://ankurmadaan in DNS mapped to ip of your server.
  4. Also you will be loop back and Authentication Required pop up will keep coming.
  5. So here is the solution, we will write Powershell Script to make this work:-
  6. First we will write script to get path of hosts file and create a copy of it:-
    #Make backup copy of the Hosts file with today's date 
    $hostsfile = 'C:\Windows\System32\drivers\etc\hosts'
    $date = Get-Date -UFormat "%y%m%d%H%M%S"
    $filecopy = $hostsfile + '.' + $date + '.copy'
    Copy-Item $hostsfile -Destination $filecopy
    
    
  7. Above code will create a copy of host file for safe way purpose.
  8. Next we will add entry for "ankurmadaan" in it:-
    Write-host "Adding entry for webapplication" 
    add-content -path $hostsfile -value "127.0.0.1 `t ankurmadaan"

  9. Last but not the least if not done allready in your server, entry for LoobBackCheck:-
    # Disable the loopback check
     New-ItemProperty HKLM:\System\CurrentControlSet\Control\Lsa -Name "DisableLoopbackCheck" -Value "1" -PropertyType dword

  10. So here it is the working http://ankurmadaan/ :-
    
  11. If you have multiple webapplications and you want to do this entire step in one go, in that case you can use alternate access mappings, here is the script for it:-

    # Get a list of the AAMs and weed out the duplicates $hostsfile = 'C:\Windows\System32\drivers\etc\hosts' $hosts = Get-SPAlternateURL | ForEach-Object {$_.incomingurl.replace("https://","").replace("http://","")} | where-Object { $_.tostring() -notlike "*:*" } | Select-Object -Unique # Get the contents of the Hosts file $file = Get-Content $hostsfile $file = $file | Out-String # write the AAMs to the hosts file, unless they already exist. $hosts | ForEach-Object { if ($file.contains($_)) {Write-Host "Entry for $_ already exists. Skipping"} else {Write-host "Adding entry for $_" ; add-content -path $hostsfile -value "127.0.0.1 `t $_ " }}
  12. Now, this will work when you are inside the servers, what will you do to have it accessed by users from outside of the server in your network, like you want to demo it someone, so here is the way to do it:-
  13. Go to IIS  and right click on this Web Application and click on Edit Bindings:-

  14. Add a new entry and specify the port name and add server name(current server) on which you are configuring this, WFE if your dev box has multiple servers:-




  15. Click ok and the last step is to create an extra alternative access mapping. Open Central Admin ->Configure alternate access mappings -> Add Internal URLs -> Change alternate access mapping location to this web application.

  16. Add internal url http://servername:93 what we used in step 14. also select custom for zone
  17. Now browse http://servername:93 , it will open the same site as http://ankurmadaan will open in the server.


    NOTE:- you have to configure hosts file in each of the server connected to your dev box but binding can be done on any WFE to expose the site outside of the server.


Thanks.