/* ***** BEGIN LICENSE BLOCK *****
 * Version: MPL 1.1/GPL 2.0/LGPL 2.1
 *
 * The contents of this file are subject to the Mozilla Public License Version
 * 1.1 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the
 * License.
 *
 * The Original Code is the Mozilla Community QA Extension
 *
 * The Initial Developer of the Original Code is the Mozilla Corporation.
 * Portions created by the Initial Developer are Copyright (C) 2006
 * the Initial Developer. All Rights Reserved.
 *
 * Contributor(s):
 *  Zach Lipton <zach@zachlipton.com>
 *
 * Alternatively, the contents of this file may be used under the terms of
 * either the GNU General Public License Version 2 or later (the "GPL"), or
 * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
 * in which case the provisions of the GPL or the LGPL are applicable instead
 * of those above. If you wish to allow use of your version of this file only
 * under the terms of either the GPL or the LGPL, and not to allow others to
 * use your version of this file under the terms of the MPL, indicate your
 * decision by deleting the provisions above and replace them with the notice
 * and other provisions required by the GPL or the LGPL. If you do not delete
 * the provisions above, a recipient may use your version of this file under
 * the terms of any one of the MPL, the GPL or the LGPL.
 *
* ***** END LICENSE BLOCK ***** */


const Ci = Components.interfaces;
const Cc = Components.classes;
const Cr = Components.results;

var qaTools = {
	// load a JSON doc into a menulist/menupopup
	// takes the url to load, the menulist to populate, the name of the method 
	// to use to get the name from the JSON doc, and the name of the method to 
	// use to get the value from the JSON doc, plus an optional callback
	loadJsonMenu : function(url, menulist, nameMethod, valueMethod, callback) {
		var d = loadJSONDoc(url);
		d.addErrback(function (err) { 
        if (err instanceof CancelledError) { 
          return; 
        }
        alert(err);
      });
	  d.addCallback(function(obj) {
	      if (obj instanceof Array) {
	          for (var i=0; i<obj.length; i++) {
	              var item = obj[i];
	              if (! item) { continue; }
	              var newitem = menulist.appendItem(item[nameMethod], 
	              									item[valueMethod]);
	          }
	      } else {
	          var newitem = menulist.appendItem(obj[nameMethod], obj[valueMethod]);
	      }
	      // stash the JSON object in the userData attribute for 
	      // later use (e.g. when filtering the list).
	      newitem.userData = item;
	      if (callback) {
	      	callback();
	      }
	  });
	},
	fetchFeed : function(url, callback) {
		var httpRequest = null;
		function FeedResultListener() {}
		FeedResultListener.prototype = {
			handleResult : function(result) {
				var feed = result.doc;
				feed.QueryInterface(Ci.nsIFeed);
				callback(feed);
			},
		};
		
		function infoReceived() {
			var data = httpRequest.responseText;
			var ioService = Cc['@mozilla.org/network/io-service;1']
							   .getService(Ci.nsIIOService);
			var uri = ioService.newURI(url, null, null);
			if (data.length) {
				var processor = Cc["@mozilla.org/feed-processor;1"]
								   .createInstance(Ci.nsIFeedProcessor);
				try {
					processor.listener = new FeedResultListener;
					processor.parseFromString(data, uri);
				} catch(e) {
					alert("Error parsing feed: " + e);
				}
			}
		}
		httpRequest = new XMLHttpRequest();
		httpRequest.open("GET", url, true);
		try {
			httpRequest.onload = infoReceived;
			httpRequest.send(null);
		} catch(e) {
			alert(e);
		}
	},
	showHideLoadingMessage : function(box, bool) {
		if (bool == true) { // show
			var loading = document.createElementNS("http://www.w3.org/1999/xhtml", "p");
			loading.textContent = qaMain.bundle.getString("qa.extension.loading");
			loading.setAttributeNS("http://www.w3.org/1999/xhtml", "class", "loading_message");
			box.appendChild(loading);
		} else { // hide
			var elements = box.childNodes;
			for (var i=0; i<elements.length; i++) {
				if (elements[i] && elements[i].getAttributeNS && 
				  elements[i].getAttributeNS(
				  "http://www.w3.org/1999/xhtml", "class") == "loading_message") {
					box.removeChild(elements[i]);
					break;
				}
			}
		}
	},
    arrayify : function(obj) {
        if (obj instanceof Array) {
            return obj;
        }
        var newArray = new Array();
        newArray[0] = obj;
        return newArray;
    },
    writeSafeHTML : function(elementID, htmlstr) {
        document.getElementById(elementID).innerHTML = "";  //clear it.
        var gUnescapeHTML = Components.classes["@mozilla.org/feed-unescapehtml;1"].getService(Components.interfaces.nsIScriptableUnescapeHTML);
        var context = document.getElementById(elementID);
        var fragment = gUnescapeHTML.parseFragment(htmlstr, false, null, context);
        context.appendChild(fragment);
        
    },
    
    linkTargetsToBlank : function(node) {
        var children = node.getElementsByTagName('a');
        for (var i = 0; i < children.length; i++)
            children[i].setAttribute("target", "_blank");
    }
};