/* vkJSONRemote.js */

/*

Interface to the vkJSONRemote.php counterpart.

*/




/*********************************************/
/* PUBLIC */


function	vkJSONRemote()
{
	this.xmlRequest = null;
	this.aborted = false;
	this.currentTimeout = null;
	this.debug = false;
}

// bool
vkJSONRemote.prototype.reset = function()
{
	try
	{
		// Get the "right" XML request object
		if(!window.XMLHttpRequest)
		{
			if(document.all && window.ActiveXObject)
			{
				try
				{
					this.xmlRequest = new ActiveXObject('Msxml2.XMLHTTP');
				}
				catch (e1)
				{
					try
					{
						this.xmlRequest = new ActiveXObject('Microsoft.XMLHTTP');
					}
					catch (e2)
					{
						throw 'Browser lacks XMLHttpRequest support';
					}
				}
			}
			else
				throw 'Browser lacks XMLHttpRequest support';
		}
		else
			this.xmlRequest = new XMLHttpRequest();
	}
	catch(e0)
	{
		return false;
	}

	this.aborted = false;
	this.currentTimeout = null;

	return true;
}



vkJSONRemote.prototype.buildUrl = function(base, arguments)
{
	var	i, args;

	args = '';

	for(i in arguments)
	{
		args += (args.length ? '&' : '?') + encodeURIComponent(i) + '=' + encodeURIComponent(arguments[i]);
	}

	return base + args;
}



// bool
vkJSONRemote.prototype.get = function(url, timeout)
{
	var	vkJSONRemote = this;

	if(!this.reset())
		return false;

	if(timeout !== undefined)
		this.currentTimeout = window.setTimeout(
			function() { vkJSONRemote._onTimeout(); },
			timeout);

	this.xmlRequest.open('GET', url);
//	this.xmlRequest.setRequestHeader('Content-Type', 'text/plain; charset='+this.charset)
	this.xmlRequest.setRequestHeader('Content-Type', 'text/plain; charset=UTF-8')

	this.xmlRequest.onreadystatechange = function()
	{
		if(vkJSONRemote.aborted)
			return;

		switch(vkJSONRemote.xmlRequest.readyState)
		{
			case 3:		// receiving
				vkJSONRemote.onLoading();
				break;

			case 4:		// loaded
				vkJSONRemote._onLoad();
				break;

			case 0:		// uninitialized
			case 1:		// open
			case 2:		// sent
			default:
				// we don't care
		}
	}

	this.xmlRequest.send(null);

	return true;
}





// bool
vkJSONRemote.prototype.post = function(url, data, timeout)
{
	var	vkJSONRemote = this;

	if(!this.reset())
		return false;

	if(timeout !== undefined)
		this.currentTimeout = window.setTimeout(
			function() { vkJSONRemote._onTimeout() },
			timeout);

	this.xmlRequest.open('POST', url);
	this.xmlRequest.setRequestHeader('Content-Type', 'text/plain; charset=UTF-8')

	this.xmlRequest.onreadystatechange = function()
	{
		if(vkJSONRemote.aborted)
			return;

		switch(vkJSONRemote.xmlRequest.readyState)
		{
			case 3:		// receiving
				vkJSONRemote.onLoading();
				break;

			case 4:		// loaded
				vkJSONRemote._onLoad();
				break;

			case 0:		// uninitialized
			case 1:		// open
			case 2:		// sent
			default:
				// we don't care
		}
	}

	var	json;

	try
	{
		json = data.toJSONString();
	}
	catch (e)
	{
		json = 'null';
	}

	this.xmlRequest.send(json);

	return true;
}


vkJSONRemote.prototype.abort = function()
{
	this.aborted = true;
	if(this.currentTimeout)
	{
		clearTimeout(this.currentTimeout);
		this.currentTimeout = null;
	}
}

/*********************************************/
/* PROTECTED */


// May be overriden
vkJSONRemote.prototype.onLoading = function()
{
	/* Default beehaviour: do nothing */
}

// Should be overriden
vkJSONRemote.prototype.onLoad = function(httpStatus, result)
{
	/* Default beehaviour: do nothing */
}

// May be overriden
vkJSONRemote.prototype.onTimeout = function()
{
	/* Default beehaviour: do nothing */
}

/*********************************************/
/* PRIVATE */

vkJSONRemote.prototype._onLoad = function()
{
	var	status, result;

	this.abort();	// Clears the timeout
	
	status = this.xmlRequest.status;

	if(this.debug)
	{
		vkDebug.text('========== vkJSONRemote reply ==========');
		vkDebug.text('STATUS: '+status);
		vkDebug.text('DATA:');
		vkDebug.text('----------------------------------------');
		vkDebug.text(this.xmlRequest.responseText);
		vkDebug.text('----------------------------------------');
	}

	if(status == 200)
	{
		var	xmlObject, nodeList;

		if(	(xmlObject = this.xmlRequest.responseXML) &&
			(nodeList = xmlObject.getElementsByTagName('JSON')) &&
			nodeList.length == 1 &&
			nodeList[0].firstChild )
		{
			// 21/01/2008
			// Some browsers (Firefox) have limitation on maximum node length, and therefore split
			// the received data in multiple nodes...

			var	i, value = '';

			for(i = 0; i < nodeList[0].childNodes.length; i++)
				value += nodeList[0].childNodes[i].nodeValue;

			try
			{
				// eval('result='+nodeList[0].firstChild.nodeValue);
				// 21/01/2008 fix
				eval('result='+value);

			}
			catch (e)
			{
				if(this.debug)
					vkDebug.text('FAILED PARSING JSON STRING');
				result = null;
			}
		}
		else
			result = null;
	}
	else
		result = null;

	this.onLoad(status, result);
}

vkJSONRemote.prototype._onTimeout = function()
{
	this.abort();	// Clears the timeout
	this.onTimeout();
}




/***********************************************************************/
/* STOLEN */



/*
    json.js
    2007-02-18

    Public Domain

    This file adds these methods to JavaScript:

        array.toJSONString()
        boolean.toJSONString()
        date.toJSONString()
        number.toJSONString()
        object.toJSONString()
        string.toJSONString()
            These methods produce a JSON text from a JavaScript value.
            It must not contain any cyclical references. Illegal values
            will be excluded.

            The default conversion for dates is to an ISO string. You can
            add a toJSONString method to any date object to get a different
            representation.

        string.parseJSON(filter)
            This method parses a JSON text to produce an object or
            array. It can throw a SyntaxError exception.

            The optional filter parameter is a function which can filter and
            transform the results. It receives each of the keys and values, and
            its return value is used instead of the original value. If it
            returns what it received, then structure is not modified. If it
            returns undefined then the member is deleted.

            Example:

            // Parse the text. If a key contains the string 'date' then
            // convert the value to a date.

            myData = text.parseJSON(function (key, value) {
                return key.indexOf('date') >= 0 ? new Date(value) : value;
            });

    It is expected that these methods will formally become part of the
    JavaScript Programming Language in the Fourth Edition of the
    ECMAScript standard in 2008.
*/

// Augment the basic prototypes if they have not already been augmented.

if (!Object.prototype.toJSONString) {

    Array.prototype.toJSONString = function () {
        var a = ['['],  // The array holding the text fragments.
            b,          // A boolean indicating that a comma is required.
            i,          // Loop counter.
            l = this.length,
            v;          // The value to be stringified.

        function p(s) {

// p accumulates text fragments in an array. It inserts a comma before all
// except the first fragment.

            if (b) {
                a.push(',');
            }
            a.push(s);
            b = true;
        }

// For each value in this array...

        for (i = 0; i < l; i += 1) {
            v = this[i];
            switch (typeof v) {

// Values without a JSON representation are ignored.

            case 'undefined':
            case 'function':
            case 'unknown':
                break;

// Serialize a JavaScript object value. Ignore objects thats lack the
// toJSONString method. Due to a specification error in ECMAScript,
// typeof null is 'object', so watch out for that case.

            case 'object':
                if (v) {
                    if (typeof v.toJSONString === 'function') {
                        p(v.toJSONString());
                    }
                } else {
                    p("null");
                }
                break;

// Otherwise, serialize the value.

            default:
                p(v.toJSONString());
            }
        }

// Join all of the fragments together and return.

        a.push(']');
        return a.join('');
    };


    Boolean.prototype.toJSONString = function () {
        return String(this);
    };


    Date.prototype.toJSONString = function () {

// Ultimately, this method will be equivalent to the date.toISOString method.

        function f(n) {

// Format integers to have at least two digits.

            return n < 10 ? '0' + n : n;
        }

        return '"' + this.getFullYear() + '-' +
                f(this.getMonth() + 1) + '-' +
                f(this.getDate()) + 'T' +
                f(this.getHours()) + ':' +
                f(this.getMinutes()) + ':' +
                f(this.getSeconds()) + '"';
    };


    Number.prototype.toJSONString = function () {

// JSON numbers must be finite. Encode non-finite numbers as null.

        return isFinite(this) ? String(this) : "null";
    };


    Object.prototype.toJSONString = function () {
        var a = ['{'],  // The array holding the text fragments.
            b,          // A boolean indicating that a comma is required.
            k,          // The current key.
            v;          // The current value.

        function p(s) {

// p accumulates text fragment pairs in an array. It inserts a comma before all
// except the first fragment pair.

            if (b) {
                a.push(',');
            }
            a.push(k.toJSONString(), ':', s);
            b = true;
        }

// Iterate through all of the keys in the object, ignoring the proto chain.

        for (k in this) {
            if (this.hasOwnProperty(k)) {
                v = this[k];
                switch (typeof v) {

// Values without a JSON representation are ignored.

                case 'undefined':
                case 'function':
                case 'unknown':
                    break;

// Serialize a JavaScript object value. Ignore objects that lack the
// toJSONString method. Due to a specification error in ECMAScript,
// typeof null is 'object', so watch out for that case.

                case 'object':
                    if (v) {
                        if (typeof v.toJSONString === 'function') {
                            p(v.toJSONString());
                        }
                    } else {
                        p("null");
                    }
                    break;
                default:
                    p(v.toJSONString());
                }
            }
        }

// Join all of the fragments together and return.

        a.push('}');
        return a.join('');
    };


    (function (s) {

// Augment String.prototype. We do this in an immediate anonymous function to
// avoid defining global variables.

// m is a table of character substitutions.

        var m = {
            '\b': '\\b',
            '\t': '\\t',
            '\n': '\\n',
            '\f': '\\f',
            '\r': '\\r',
            '"' : '\\"',
            '\\': '\\\\'
        };


        s.parseJSON = function (filter) {

// Parsing happens in three stages. In the first stage, we run the text against
// a regular expression which looks for non-JSON characters. We are especially
// concerned with '()' and 'new' because they can cause invocation, and '='
// because it can cause mutation. But just to be safe, we will reject all
// unexpected characters.

            try {
                if (/^("(\\.|[^"\\\n\r])*?"|[,:{}\[\]0-9.\-+Eaeflnr-u \n\r\t])+?$/.
                        test(this)) {

// In the second stage we use the eval function to compile the text into a
// JavaScript structure. The '{' operator is subject to a syntactic ambiguity
// in JavaScript: it can begin a block or an object literal. We wrap the text
// in parens to eliminate the ambiguity.

                    var j = eval('(' + this + ')');

// In the optional third stage, we recursively walk the new structure, passing
// each name/value pair to a filter function for possible transformation.

                    if (typeof filter === 'function') {

                        function walk(k, v) {
                            if (v && typeof v === 'object') {
                                for (var i in v) {
                                    if (v.hasOwnProperty(i)) {
                                        v[i] = walk(i, v[i]);
                                    }
                                }
                            }
                            return filter(k, v);
                        }

                        walk('', j);
                    }
                    return j;
                }
            } catch (e) {

// Fall through if the regexp test fails.

            }
            throw new SyntaxError("parseJSON");
        };


        s.toJSONString = function () {

// If the string contains no control characters, no quote characters, and no
// backslash characters, then we can simply slap some quotes around it.
// Otherwise we must also replace the offending characters with safe
// sequences.

            if (/["\\\x00-\x1f]/.test(this)) {
                return '"' + this.replace(/([\x00-\x1f\\"])/g, function(a, b) {
                    var c = m[b];
                    if (c) {
                        return c;
                    }
                    c = b.charCodeAt();
                    return '\\u00' +
                        Math.floor(c / 16).toString(16) +
                        (c % 16).toString(16);
                }) + '"';
            }
            return '"' + this + '"';
        };
    })(String.prototype);
}