YUI Library Examples: Get Utility: Getting a Script Node with JSON Data

Using the Get Utility to Get a Script File with JSON-formatted Contents

Here, we'll use the YUI Get Utility to retrieve data via the Yahoo! Search Site-Explorer web service, one of many Yahoo! APIs that support JSON.

First, we create a plain HTML form that will work for users who do not have JavaScript enabled:

With this in place, we can progressively enhance the form to create an in-page interaction for users with JavaScript turned on.

The most important JavaScript piece here is the method that we fire on form submission. This method triggers our call to the Get Utility. This method, called getSiteExplorerData, accomplishes four things:

It loads a transitional state for the display, alerting the user to the fact that data is being retrieved as a result of her action (line 7ff);
It prepares the URL that will be passed to the Get Utility (line 13ff);
It calls the Get Utility, passing in the URL of the script resource to load (in this case, the URL of our web service with the relevant paramaters assembled in the querystring) (line 22ff);
It specifies the callback (line 23) and the scope in which the callback should run (line 24). Note that in this example the web service itself provides callback functionality, allowing us to pass a globally accessible callback function name as one of the parameters of the REST API; you can see this reference in line 16 below. As a result, we're making direct use of the intrinsic web service callback in this example and just stubbing out the built-in Get Utility callback for the sake of illustration.

//function to retrieve data from Yahoo! Site Explorer web service -- // http://developer.yahoo.com/search/siteexplorer/V1/inlinkData.html var getSiteExplorerData = function() { YAHOO.log("Button clicked; getSiteExplorerData firing.", "info", "example"); //Load the transitional state of the results section: elResults.innerHTML = "<h3>Retrieving incoming links for " + Dom.get("p").value + ":</h3>" + "<img src='http://l.yimg.com/us.yimg.com/i/nt/ic/ut/bsc/busybar_1.gif' " + "alt='Please wait...'>"; //prepare the URL for the Yahoo Site Explorer API: var sURL = "http://search.yahooapis.com/SiteExplorerService/V1/inlinkData?" + "appid=3wEDxLHV34HvAU2lMnI51S4Qra5m.baugqoSv4gcRllqqVZm3UrMDZWToMivf5BJ3Mom" + "&results=20&output=json&omit_inlinks=domain" + "&callback=YAHOO.example.SiteExplorer.callback" + "&query=" + encodeURIComponent(Dom.get("p").value); //This simple line is the call to the Get Utility; we pass //in the URL and the configuration object, which in this case //consists merely of our success and failure callbacks: var transactionObj = Get.script(sURL, { onSuccess: onSiteExplorerSuccess, scope : this }); //The script method returns a single-field object containing the //tranaction id: YAHOO.log("Get Utility transaction started; transaction object: " + YAHOO.lang.dump(transactionObj), "info", "example"); }

The full JavaScript codeblock for this example reads as follows:

//create a namespace for this example:
YAHOO.namespace("example.SiteExplorer");

//This example uses the "Module Pattern"; a full explanation of 
//this pattern can be found on yuiblog:
// http://yuiblog.com/blog/2007/06/12/module-pattern
YAHOO.example.SiteExplorer = function() {

//set up some shortcuts in case our typing fingers
	//get lazy:
	var Event = YAHOO.util.Event,
		Dom = YAHOO.util.Dom,
		JSON = YAHOO.lang.JSON,
		Button = YAHOO.widget.Button,
		Get = YAHOO.util.Get,
		elResults = Dom.get("results");
		
	//we won't use the Get Utility's success handler in this example
	//because the web service we're using has a built-in callback
	//mechanism.  But we'll stub it out here and use it to simply
	//log a message to the logger:
	var onSiteExplorerSuccess = function() {
		YAHOO.log("The Get Utility has fired the success handler indicating that the requested script has loaded and is ready for use.", "info", "example");
	}
	
	//function to retrieve data from Yahoo! Site Explorer web service --
	// http://developer.yahoo.com/search/siteexplorer/V1/inlinkData.html
	var getSiteExplorerData = function() {
		YAHOO.log("Button clicked; getSiteExplorerData firing.", "info", "example");
		
		//Load the transitional state of the results section:
		elResults.innerHTML = "<h3>Retrieving incoming links for " +
			Dom.get("p").value + ":</h3>" +
			"<img src='http://l.yimg.com/us.yimg.com/i/nt/ic/ut/bsc/busybar_1.gif' " +
			"alt='Please wait...'>";
		
		//prepare the URL for the Yahoo Site Explorer API:
		var sURL = "http://search.yahooapis.com/SiteExplorerService/V1/inlinkData?" +
			"appid=3wEDxLHV34HvAU2lMnI51S4Qra5m.baugqoSv4gcRllqqVZm3UrMDZWToMivf5BJ3Mom" +
			"&results=20&output=json&omit_inlinks=domain" +
			"&callback=YAHOO.example.SiteExplorer.callback" +
			"&query=" + encodeURIComponent(Dom.get("p").value);
		
		//This simple line is the call to the Get Utility; we pass
		//in the URL and the configuration object, which in this case
		//consists merely of our success and failure callbacks:
		var transactionObj = Get.script(sURL, {
			onSuccess: onSiteExplorerSuccess,
			scope    : this
		});
		
		//The script method returns a single-field object containing the
		//tranaction id:
		YAHOO.log("Get Utility transaction started; transaction object: " + YAHOO.lang.dump(transactionObj), "info", "example");
		
	}

return {
		init: function() {
				
			//suppress default form behavior
			Event.on("siteExplorer", "submit", function(e) {
				Event.preventDefault(e);
				getSiteExplorerData();
			}, this, true);
		
			//instantiate Button:
			var oButton = new Button("getSiteExplorerData");
			YAHOO.log("Button instantiated.", "info", "example");
		},

callback: function(results) {
			YAHOO.log("Web service returned data to YAHOO.example.SiteExplorer.callback; beginning to process.", "info", "example");
			
			//work with the returned data to extract meaningful fields:
			var aResults = results.ResultSet.Result;
			var totalLinks = results.ResultSet.totalResultsAvailable;
			var returnedLinkCount = results.ResultSet.totalResultsReturned;
			
			if(aResults) {//there are inbound links; process and display them:
			
				//write header and open list of inbound links:			
				var html = "<h3>There are " +
					totalLinks + 
					" inbound links for this page; here are the first " + 
					returnedLinkCount +
					":</h3><ol>";
				
				//process list of inbound links:
				for (var i=0; i < aResults.length; i++) {
					html += "<li><strong>" +
						aResults[i].Title +
						":</strong> <a href='" +
						aResults[i].Url +
						"'>" + aResults[i].Url +
						"</a></li>";
				}
				
				//close list of inbound links
				html += "</ol>";
				
			} else {//no inbound links exist for this page:
			
				var html = "<h3>There are no inbound links for the page specified.</h3";
				
			}
			
			//insert string into DOM:
			elResults.innerHTML = html;
		}
	}
}();

//Initialize the example when the DOM is completely loaded:
YAHOO.util.Event.onDOMReady(
	YAHOO.example.SiteExplorer.init, 
	YAHOO.example.SiteExplorer, 		//pass this object to init and...
	true);								//...run init in the passed object's
										//scope

YUI Library Examples: Get Utility: Getting a Script Node with JSON Data

Using the Get Utility to Get a Script File with JSON-formatted Contents

YUI Logger Output:

Get Utility Examples:

More Get Utility Resources: