sproutcore 1.4.5-java → 1.5.0-java

data/lib/frameworks/sproutcore/frameworks/foundation/system/image_cache.js

@@ -1,433 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2010 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-
-sc_require('system/locale');
-
-SC.IMAGE_ABORTED_ERROR = SC.$error("SC.Image.AbortedError", "Image", -100) ;
-
-SC.IMAGE_FAILED_ERROR = SC.$error("SC.Image.FailedError", "Image", -101) ;
-
-/**
-  @class
-  
-  The image cache can be used to control the order of loading images into the
-   browser cache.
-  
-  Images queues are necessary because browsers impose strict limits on the 
-  number of concurrent connections that can be open at any one time to any one 
-  host. By controlling the order and timing of your loads using this image 
-  queue, you can improve the percieved performance of your application by 
-  ensuring the images you need most load first.
-  
-  Note that if you use the SC.ImageView class, it will use this image cache 
-  for you automatically.
-  
-  h1. Loading Images
-  
-  When you need to display an image, simply call the loadImage() method with 
-  the URL of the image, along with a target/method callback. The signature of 
-  your callback should be:
-  
-  {{{
-    imageDidLoad: function(imageUrl, imageOrError) {
-      //...
-    }
-  }}}
-
-  The "imageOrError" parameter will contain either an image object or an error 
-  object if the image could not be loaded for some reason.  If you receive an 
-  error object, it will be one of SC.IMAGE_ABORTED_ERROR or 
-  SC.IMAGE_FAILED_ERROR.
-  
-  You can also optionally specify that the image should be loaded in the 
-  background.  Background images are loaded with a lower priority than 
-  foreground images.
-  
-  h1. Aborting Image Loads
-  
-  If you request an image load but then no longer require the image for some 
-  reason, you should notify the imageCache by calling the releaseImage() 
-  method.  Pass the URL, target and method that you included in your original 
-  loadImage() request.  
-  
-  If you have requested an image before, you should always call releaseImage() 
-  when you are finished with it, even if the image has already loaded.  This 
-  will allow the imageCache to properly manage its own internal resources.
-  
-  This method may remove the image from the queue of images that need or load 
-  or it may abort an image load in progress to make room for other images.  If 
-  the image is already loaded, this method will have no effect.
-  
-  h1. Reloading an Image
-  
-  If you have already loaded an image, the imageCache will avoid loading the 
-  image again.  However, if you need to force the imageCache to reload the 
-  image for some reason, you can do so by calling reloadImage(), passing the 
-  URL. 
-  
-  This will cause the image cache to attempt to load the image again the next 
-  time you call loadImage on it.
-  
-  @extends SC.Object
-  @since SproutCore 1.0
-*/
-SC.imageCache = SC.Object.create(/** @scope SC.imageCache.prototype */ {
-
-  /**
-    The maximum number of images that can load from a single hostname at any
-    one time.  For most browsers 4 is a reasonable number, though you may 
-    tweak this on a browser-by-browser basis.
-  */
-  loadLimit: 4,
-  
-  /**
-    The number of currently active requests on the cache. 
-  */
-  activeRequests: 0,
-  
-  /**
-    Loads an image from the server, calling your target/method when complete.
-    
-    You should always pass at least a URL and optionally a target/method.  If 
-    you do not pass the target/method, the image will be loaded in background 
-    priority.  Usually, however, you will want to pass a callback to be 
-    notified when the image has loaded.  Your callback should have a signature 
-    like:
-
-    {{{
-      imageDidLoad: function(imageUrl, imageOrError) { .. }
-    }}}
-    
-    If you do pass a target/method you can optionally also choose to load the 
-    image either in the foreground or in the background.  The image cache 
-    prioritizes foreground images over background images.  This does not impact 
-    how many images load at one time.
-    
-    @param {String} url
-    @param {Object} target
-    @param {String|Function} method
-    @param {Boolean} isBackgroundFlag
-    @returns {SC.imageCache} receiver
-  */
-  loadImage: function(url, target, method, isBackgroundFlag) {
-    // normalize params
-    var type = SC.typeOf(target);
-    if (SC.none(method) && SC.typeOf(target)===SC.T_FUNCTION) {
-      target = null; method = target ;
-    }
-    if (SC.typeOf(method) === SC.T_STRING) {
-      method = target[method];      
-    }
-    // if no callback is passed, assume background image.  otherwise, assume
-    // foreground image.
-    if (SC.none(isBackgroundFlag)) {
-      isBackgroundFlag = SC.none(target) && SC.none(method);
-    }
-    
-    // get image entry in cache.  If entry is loaded, just invoke callback
-    // and quit.
-    var entry = this._imageEntryFor(url) ;
-    if (entry.status === this.IMAGE_LOADED) {
-      if (method) method.call(target || entry.image, entry.url, entry.image);
-      
-    // otherwise, add to list of callbacks and queue image.
-    } else {
-      if (target || method) this._addCallback(entry, target, method);
-      entry.retainCount++; // increment retain count, regardless of callback
-      this._scheduleImageEntry(entry, isBackgroundFlag);
-    }
-  },
-  
-  /**
-    Invoke this method when you are finished with an image URL.  If you 
-    passed a target/method, you should also pass it here to remove it from
-    the list of callbacks.
-    
-    @param {String} url
-    @param {Object} target
-    @param {String|Function} method
-    @returns {SC.imageCache} receiver
-  */
-  releaseImage: function(url, target, method) {
-    
-    // get entry.  if there is no entry, just return as there is nothing to 
-    // do.
-    var entry = this._imageEntryFor(url, NO) ;
-    if (!entry) return this ;
-    
-    // there is an entry, decrement the retain count.  If <=0, delete!
-    if (--entry.retainCount <= 0) {
-      this._deleteEntry(entry); 
-    
-    // if >0, just remove target/method if passed
-    } else if (target || method) {
-      // normalize
-      var type = SC.typeOf(target);
-      if (SC.none(method) && SC.typeOf(target)===SC.T_FUNCTION) {
-        target = null; method = target ;
-      }
-      if (SC.typeOf(method) === SC.T_STRING) {
-        method = target[method];      
-      }
-
-      // and remove
-      this._removeCallback(entry, target, method) ;
-    }
-  },
-
-  /** 
-    Forces the image to reload the next time you try to load it.
-  */
-  reloadImage: function(url) {
-    var entry = this._imageEntryFor(url, NO); 
-    if (entry && entry.status===this.IMAGE_LOADED) {
-      entry.status = this.IMAGE_WAITING;
-    }
-  },
-  
-  /**
-    Initiates a load of the next image in the image queue.  Normally you will
-    not need to call this method yourself as it will be initiated 
-    automatically when the queue becomes active.
-  */
-  loadNextImage: function() {
-    var entry = null, queue;
-
-    // only run if we don't have too many active request...
-    if (this.get('activeRequests')>=this.get('loadLimit')) return; 
-    
-    // first look in foreground queue
-    queue = this._foregroundQueue ;
-    while(queue.length>0 && !entry) entry = queue.shift();
-    
-    // then look in background queue
-    if (!entry) {
-      queue = this._backgroundQueue ;
-      while(queue.length>0 && !entry) entry = queue.shift();
-    }
-    this.set('isLoading', !!entry); // update isLoading...
-    
-    // if we have an entry, then initiate an image load with the proper 
-    // callbacks.
-    if (entry) {
-      // var img = (entry.image = new Image()) ;
-      var img = entry.image ;
-      img.onabort = this._imageDidAbort ;
-      img.onerror = this._imageDidError ;
-      img.onload = this._imageDidLoad ;
-      img.src = entry.url ;
-
-      // add to loading queue.
-      this._loading.push(entry) ;
-    
-      // increment active requests and start next request until queue is empty
-      // or until load limit is reached.
-      this.incrementProperty('activeRequests');
-      this.loadNextImage();
-    } 
-  },
-  
-  // ..........................................................
-  // SUPPORT METHODS
-  // 
-
-  /** @private Find or create an entry for the URL. */
-  _imageEntryFor: function(url, createIfNeeded) {
-    if (createIfNeeded === undefined) createIfNeeded = YES;
-    var entry = this._images[url] ;
-    if (!entry && createIfNeeded) {
-      var img = new Image() ;
-      entry = this._images[url] = { 
-        url: url, status: this.IMAGE_WAITING, callbacks: [], retainCount: 0, image: img
-      };
-      img.entry = entry ; // provide a link back to the image
-    }
-    return entry ;
-  },
-  
-  /** @private deletes an entry from the image queue, descheduling also */
-  _deleteEntry: function(entry) {
-    this._unscheduleImageEntry(entry) ;
-    delete this._images[entry.url];    
-  },
-  
-  /** @private 
-    Add a callback to the image entry.  First search the callbacks to make
-    sure this is only added once.
-  */
-  _addCallback: function(entry, target, method) {
-    var callbacks = entry.callbacks;
-
-    // try to find in existing array
-    var handler = callbacks.find(function(x) {
-      return x[0]===target && x[1]===method;
-    }, this);
-    
-    // not found, add...
-    if (!handler) callbacks.push([target, method]);
-    callbacks = null; // avoid memory leaks
-    return this ;
-  },
-  
-  /** @private
-    Removes a callback from the image entry.  Removing a callback just nulls
-    out that position in the array.  It will be skipped when executing.
-  */
-  _removeCallback: function(entry, target, method) {
-    var callbacks = entry.callbacks ;
-    callbacks.forEach(function(x, idx) {
-      if (x[0]===target && x[1]===method) callbacks[idx] = null;
-    }, this);
-    callbacks = null; // avoid memory leaks
-    return this ;
-  },
-  
-  /** @private 
-    Adds an entry to the foreground or background queue to load.  If the 
-    loader is not already running, start it as well.  If the entry is in the
-    queue, but it is in the background queue, possibly move it to the
-    foreground queue.
-  */
-  _scheduleImageEntry: function(entry, isBackgroundFlag) {
-
-    var background = this._backgroundQueue ;
-    var foreground = this._foregroundQueue ;
-    
-    // if entry is loaded, nothing to do...
-    if (entry.status === this.IMAGE_LOADED) return this;
-
-    // if image is already in background queue, but now needs to be
-    // foreground, simply remove from background queue....
-    if ((entry.status===this.IMAGE_QUEUED) && !isBackgroundFlag && entry.isBackground) {
-      background[background.indexOf(entry)] = null ;
-      entry.status = this.IMAGE_WAITING ;
-    }
-    
-    // if image is not in queue already, add to queue.
-    if (entry.status!==this.IMAGE_QUEUED) {
-      var queue = (isBackgroundFlag) ? background : foreground ;
-      queue.push(entry);
-      entry.status = this.IMAGE_QUEUED ;
-      entry.isBackground = isBackgroundFlag ;
-    }
-    
-    // if the image loader is not already running, start it...
-    if (!this.isLoading) this.invokeLater(this.loadNextImage, 100);
-    this.set('isLoading', YES);
-    
-    return this ; // done!
-  },
-  
-  /** @private
-    Removes an entry from the foreground or background queue.  
-  */
-  _unscheduleImageEntry: function(entry) {
-    // if entry is not queued, do nothing
-    if (entry.status !== this.IMAGE_QUEUED) return this ;
-    
-    var queue = entry.isBackground ? this._backgroundQueue : this._foregroundQueue ;
-    queue[queue.indexOf(entry)] = null; 
-    
-    // if entry is loading, abort it also.  Call local abort method in-case
-    // browser decides not to follow up.
-    if (this._loading.indexOf(entry) >= 0) {
-      // In some cases queue.image is undefined. Is it ever defined?
-      if (queue.image) queue.image.abort();
-      this.imageStatusDidChange(entry, this.ABORTED);
-    }
-    
-    return this ;
-  },
-  
-  /** @private invoked by Image().  Note that this is the image instance */
-  _imageDidAbort: function() {
-    SC.run(function() {
-      SC.imageCache.imageStatusDidChange(this.entry, SC.imageCache.ABORTED);
-    }, this);
-  },
-  
-  _imageDidError: function() {
-    SC.run(function() {
-      SC.imageCache.imageStatusDidChange(this.entry, SC.imageCache.ERROR);
-    }, this);
-  },
-  
-  _imageDidLoad: function() {
-    SC.run(function() {
-      SC.imageCache.imageStatusDidChange(this.entry, SC.imageCache.LOADED);
-    }, this);
-  },
-
-  /** @private called whenever the image loading status changes.  Notifies
-    items in the queue and then cleans up the entry.
-  */
-  imageStatusDidChange: function(entry, status) {
-    if (!entry) return; // nothing to do...
-    
-    var url = entry.url ;
-    
-    // notify handlers.
-    var value ;
-    switch(status) {
-      case this.LOADED:
-        value = entry.image;
-        break;
-      case this.ABORTED:
-        value = SC.IMAGE_ABORTED_ERROR;
-        break;
-      case this.ERROR:
-        value = SC.IMAGE_FAILED_ERROR ;
-        break;
-      default:
-        value = SC.IMAGE_FAILED_ERROR ;
-        break;
-    }
-    entry.callbacks.forEach(function(x){
-      var target = x[0], method = x[1];
-      method.call(target, url, value);
-    },this);
-    
-    // now clear callbacks so they aren't called again.
-    entry.callbacks = [];
-    
-    // finally, if the image loaded OK, then set the status.  Otherwise
-    // set it to waiting so that further attempts will load again
-    entry.status = (status === this.LOADED) ? this.IMAGE_LOADED : this.IMAGE_WAITING ;
-    
-    // now cleanup image...
-    var image = entry.image ;
-    if (image) {
-      image.onload = image.onerror = image.onabort = null ; // no more notices
-      if (status !== this.LOADED) entry.image = null;
-    }
-
-    // remove from loading queue and periodically compact
-    this._loading[this._loading.indexOf(entry)]=null;
-    if (this._loading.length > this.loadLimit*2) {
-      this._loading = this._loading.compact();
-    }
-    
-    this.decrementProperty('activeRequests');
-    this.loadNextImage() ;
-  },
-  
-  init: function() {
-    sc_super();
-    this._images = {};
-    this._loading = [] ;
-    this._foregroundQueue = [];
-    this._backgroundQueue = [];
-  },
-  
-  IMAGE_LOADED: "loaded",
-  IMAGE_QUEUED: "queued",
-  IMAGE_WAITING: "waiting",
-  
-  ABORTED: 'aborted',
-  ERROR: 'error',
-  LOADED: 'loaded'
-});

data/lib/frameworks/sproutcore/frameworks/foundation/system/json.js

@@ -1,515 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2010 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-
-SC.json = {
-  
-  /**
-    Encodes an object graph to a JSON output.  Beware that JSON cannot deal
-    with circular references.  If you try to encode an object graph with
-    references it could hang your browser.
-    
-    @param {Object} root object graph
-    @returns {String} encode JSON
-  */
-  encode: function(root) {
-    return JSON.stringify(root) ;
-  },
-  
-  /**
-    Decodes a JSON file in a safe way, returning the generated object graph.
-  
-    @param {String} encoded JSON
-    @returns {Object} object graph or Error if there was a problem.
-  */
-  decode: function(root) {
-    return JSON.parse(root) ;
-  }
-
-} ;
-
-/*
-    http://www.JSON.org/json2.js
-    2010-03-20
-
-    Public Domain.
-
-    NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.
-
-    See http://www.JSON.org/js.html
-
-
-    This code should be minified before deployment.
-    See http://javascript.crockford.com/jsmin.html
-
-    USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO
-    NOT CONTROL.
-
-
-    This file creates a global JSON object containing two methods: stringify
-    and parse.
-
-        JSON.stringify(value, replacer, space)
-            value       any JavaScript value, usually an object or array.
-
-            replacer    an optional parameter that determines how object
-                        values are stringified for objects. It can be a
-                        function or an array of strings.
-
-            space       an optional parameter that specifies the indentation
-                        of nested structures. If it is omitted, the text will
-                        be packed without extra whitespace. If it is a number,
-                        it will specify the number of spaces to indent at each
-                        level. If it is a string (such as '\t' or ' '),
-                        it contains the characters used to indent at each level.
-
-            This method produces a JSON text from a JavaScript value.
-
-            When an object value is found, if the object contains a toJSON
-            method, its toJSON method will be called and the result will be
-            stringified. A toJSON method does not serialize: it returns the
-            value represented by the name/value pair that should be serialized,
-            or undefined if nothing should be serialized. The toJSON method
-            will be passed the key associated with the value, and this will be
-            bound to the value
-
-            For example, this would serialize Dates as ISO strings.
-
-                Date.prototype.toJSON = function (key) {
-                    function f(n) {
-                        // Format integers to have at least two digits.
-                        return n < 10 ? '0' + n : n;
-                    }
-
-                    return this.getUTCFullYear()   + '-' +
-                         f(this.getUTCMonth() + 1) + '-' +
-                         f(this.getUTCDate())      + 'T' +
-                         f(this.getUTCHours())     + ':' +
-                         f(this.getUTCMinutes())   + ':' +
-                         f(this.getUTCSeconds())   + 'Z';
-                };
-
-            You can provide an optional replacer method. It will be passed the
-            key and value of each member, with this bound to the containing
-            object. The value that is returned from your method will be
-            serialized. If your method returns undefined, then the member will
-            be excluded from the serialization.
-
-            If the replacer parameter is an array of strings, then it will be
-            used to select the members to be serialized. It filters the results
-            such that only members with keys listed in the replacer array are
-            stringified.
-
-            Values that do not have JSON representations, such as undefined or
-            functions, will not be serialized. Such values in objects will be
-            dropped; in arrays they will be replaced with null. You can use
-            a replacer function to replace those with JSON values.
-            JSON.stringify(undefined) returns undefined.
-
-            The optional space parameter produces a stringification of the
-            value that is filled with line breaks and indentation to make it
-            easier to read.
-
-            If the space parameter is a non-empty string, then that string will
-            be used for indentation. If the space parameter is a number, then
-            the indentation will be that many spaces.
-
-            Example:
-
-            text = JSON.stringify(['e', {pluribus: 'unum'}]);
-            // text is '["e",{"pluribus":"unum"}]'
-
-
-            text = JSON.stringify(['e', {pluribus: 'unum'}], null, '\t');
-            // text is '[\n\t"e",\n\t{\n\t\t"pluribus": "unum"\n\t}\n]'
-
-            text = JSON.stringify([new Date()], function (key, value) {
-                return this[key] instanceof Date ?
-                    'Date(' + this[key] + ')' : value;
-            });
-            // text is '["Date(---current time---)"]'
-
-
-        JSON.parse(text, reviver)
-            This method parses a JSON text to produce an object or array.
-            It can throw a SyntaxError exception.
-
-            The optional reviver parameter is a function that 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 the structure is not modified.
-            If it returns undefined then the member is deleted.
-
-            Example:
-
-            // Parse the text. Values that look like ISO date strings will
-            // be converted to Date objects.
-
-            myData = JSON.parse(text, function (key, value) {
-                var a;
-                if (typeof value === 'string') {
-                    a =
-/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}(?:\.\d*)?)Z$/.exec(value);
-                    if (a) {
-                        return new Date(Date.UTC(+a[1], +a[2] - 1, +a[3], +a[4],
-                            +a[5], +a[6]));
-                    }
-                }
-                return value;
-            });
-
-            myData = JSON.parse('["Date(09/09/2001)"]', function (key, value) {
-                var d;
-                if (typeof value === 'string' &&
-                        value.slice(0, 5) === 'Date(' &&
-                        value.slice(-1) === ')') {
-                    d = new Date(value.slice(5, -1));
-                    if (d) {
-                        return d;
-                    }
-                }
-                return value;
-            });
-
-
-    This is a reference implementation. You are free to copy, modify, or
-    redistribute.
-*/
-
-/*jslint evil: true, strict: false */
-
-/*members "", "\b", "\t", "\n", "\f", "\r", "\"", JSON, "\\", apply,
-    call, charCodeAt, getUTCDate, getUTCFullYear, getUTCHours,
-    getUTCMinutes, getUTCMonth, getUTCSeconds, hasOwnProperty, join,
-    lastIndex, length, parse, prototype, push, replace, slice, stringify,
-    test, toJSON, toString, valueOf
-*/
-
-
-// Create a JSON object only if one does not already exist. We create the
-// methods in a closure to avoid creating global variables.
-
-if (!this.JSON) {
-    this.JSON = {};
-}
-
-(function () {
-
-    function f(n) {
-        // Format integers to have at least two digits.
-        return n < 10 ? '0' + n : n;
-    }
-
-    if (typeof Date.prototype.toJSON !== 'function') {
-
-        Date.prototype.toJSON = function (key) {
-
-            return isFinite(this.valueOf()) ?
-                   this.getUTCFullYear()   + '-' +
-                 f(this.getUTCMonth() + 1) + '-' +
-                 f(this.getUTCDate())      + 'T' +
-                 f(this.getUTCHours())     + ':' +
-                 f(this.getUTCMinutes())   + ':' +
-                 f(this.getUTCSeconds())   + 'Z' : null;
-        };
-
-        String.prototype.toJSON =
-        Number.prototype.toJSON =
-        Boolean.prototype.toJSON = function (key) {
-            return this.valueOf();
-        };
-    }
-
-    var cx = /[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
-        escapable = /[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
-        gap,
-        indent,
-        meta = {    // table of character substitutions
-            '\b': '\\b',
-            '\t': '\\t',
-            '\n': '\\n',
-            '\f': '\\f',
-            '\r': '\\r',
-            '"' : '\\"',
-            '\\': '\\\\'
-        },
-        rep;
-
-
-    function quote(string) {
-
-// If the string contains no control characters, no quote characters, and no
-// backslash characters, then we can safely slap some quotes around it.
-// Otherwise we must also replace the offending characters with safe escape
-// sequences.
-
-        escapable.lastIndex = 0;
-        return escapable.test(string) ?
-            '"' + string.replace(escapable, function (a) {
-                var c = meta[a];
-                return typeof c === 'string' ? c :
-                    '\\u' + ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
-            }) + '"' :
-            '"' + string + '"';
-    }
-
-
-    function str(key, holder) {
-
-// Produce a string from holder[key].
-
-        var i,          // The loop counter.
-            k,          // The member key.
-            v,          // The member value.
-            length,
-            mind = gap,
-            partial,
-            value = holder[key];
-
-// If the value has a toJSON method, call it to obtain a replacement value.
-
-        if (value && typeof value === 'object' &&
-                typeof value.toJSON === 'function') {
-            value = value.toJSON(key);
-        }
-
-// If we were called with a replacer function, then call the replacer to
-// obtain a replacement value.
-
-        if (typeof rep === 'function') {
-            value = rep.call(holder, key, value);
-        }
-
-// What happens next depends on the value's type.
-
-        switch (typeof value) {
-        case 'string':
-            return quote(value);
-
-        case 'number':
-
-// JSON numbers must be finite. Encode non-finite numbers as null.
-
-            return isFinite(value) ? String(value) : 'null';
-
-        case 'boolean':
-        case 'null':
-
-// If the value is a boolean or null, convert it to a string. Note:
-// typeof null does not produce 'null'. The case is included here in
-// the remote chance that this gets fixed someday.
-
-            return String(value);
-
-// If the type is 'object', we might be dealing with an object or an array or
-// null.
-
-        case 'object':
-
-// Due to a specification blunder in ECMAScript, typeof null is 'object',
-// so watch out for that case.
-
-            if (!value) {
-                return 'null';
-            }
-
-// Make an array to hold the partial results of stringifying this object value.
-
-            gap += indent;
-            partial = [];
-
-// Is the value an array?
-
-            if (Object.prototype.toString.apply(value) === '[object Array]') {
-
-// The value is an array. Stringify every element. Use null as a placeholder
-// for non-JSON values.
-
-                length = value.length;
-                for (i = 0; i < length; i += 1) {
-                    partial[i] = str(i, value) || 'null';
-                }
-
-// Join all of the elements together, separated with commas, and wrap them in
-// brackets.
-
-                v = partial.length === 0 ? '[]' :
-                    gap ? '[\n' + gap +
-                            partial.join(',\n' + gap) + '\n' +
-                                mind + ']' :
-                          '[' + partial.join(',') + ']';
-                gap = mind;
-                return v;
-            }
-
-// If the replacer is an array, use it to select the members to be stringified.
-
-            if (rep && typeof rep === 'object') {
-                length = rep.length;
-                for (i = 0; i < length; i += 1) {
-                    k = rep[i];
-                    if (typeof k === 'string') {
-                        v = str(k, value);
-                        if (v) {
-                            partial.push(quote(k) + (gap ? ': ' : ':') + v);
-                        }
-                    }
-                }
-            } else {
-
-// Otherwise, iterate through all of the keys in the object.
-
-                for (k in value) {
-                    if (Object.hasOwnProperty.call(value, k)) {
-                        v = str(k, value);
-                        if (v) {
-                            partial.push(quote(k) + (gap ? ': ' : ':') + v);
-                        }
-                    }
-                }
-            }
-
-// Join all of the member texts together, separated with commas,
-// and wrap them in braces.
-
-            v = partial.length === 0 ? '{}' :
-                gap ? '{\n' + gap + partial.join(',\n' + gap) + '\n' +
-                        mind + '}' : '{' + partial.join(',') + '}';
-            gap = mind;
-            return v;
-        }
-    }
-
-// If the JSON object does not yet have a stringify method, give it one.
-
-    if (typeof JSON.stringify !== 'function') {
-        JSON.stringify = function (value, replacer, space) {
-
-// The stringify method takes a value and an optional replacer, and an optional
-// space parameter, and returns a JSON text. The replacer can be a function
-// that can replace values, or an array of strings that will select the keys.
-// A default replacer method can be provided. Use of the space parameter can
-// produce text that is more easily readable.
-
-            var i;
-            gap = '';
-            indent = '';
-
-// If the space parameter is a number, make an indent string containing that
-// many spaces.
-
-            if (typeof space === 'number') {
-                for (i = 0; i < space; i += 1) {
-                    indent += ' ';
-                }
-
-// If the space parameter is a string, it will be used as the indent string.
-
-            } else if (typeof space === 'string') {
-                indent = space;
-            }
-
-// If there is a replacer, it must be a function or an array.
-// Otherwise, throw an error.
-
-            rep = replacer;
-            if (replacer && typeof replacer !== 'function' &&
-                    (typeof replacer !== 'object' ||
-                     typeof replacer.length !== 'number')) {
-                throw new Error('JSON.stringify');
-            }
-
-// Make a fake root object containing our value under the key of ''.
-// Return the result of stringifying the value.
-
-            return str('', {'': value});
-        };
-    }
-
-
-// If the JSON object does not yet have a parse method, give it one.
-
-    if (typeof JSON.parse !== 'function') {
-        JSON.parse = function (text, reviver) {
-
-// The parse method takes a text and an optional reviver function, and returns
-// a JavaScript value if the text is a valid JSON text.
-
-            var j;
-
-            function walk(holder, key) {
-
-// The walk method is used to recursively walk the resulting structure so
-// that modifications can be made.
-
-                var k, v, value = holder[key];
-                if (value && typeof value === 'object') {
-                    for (k in value) {
-                        if (Object.hasOwnProperty.call(value, k)) {
-                            v = walk(value, k);
-                            if (v !== undefined) {
-                                value[k] = v;
-                            } else {
-                                delete value[k];
-                            }
-                        }
-                    }
-                }
-                return reviver.call(holder, key, value);
-            }
-
-
-// Parsing happens in four stages. In the first stage, we replace certain
-// Unicode characters with escape sequences. JavaScript handles many characters
-// incorrectly, either silently deleting them, or treating them as line endings.
-
-            text = String(text);
-            cx.lastIndex = 0;
-            if (cx.test(text)) {
-                text = text.replace(cx, function (a) {
-                    return '\\u' +
-                        ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
-                });
-            }
-
-// In the second stage, we run the text against regular expressions that look
-// for non-JSON patterns. We are especially concerned with '()' and 'new'
-// because they can cause invocation, and '=' because it can cause mutation.
-// But just to be safe, we want to reject all unexpected forms.
-
-// We split the second stage into 4 regexp operations in order to work around
-// crippling inefficiencies in IE's and Safari's regexp engines. First we
-// replace the JSON backslash pairs with '@' (a non-JSON character). Second, we
-// replace all simple value tokens with ']' characters. Third, we delete all
-// open brackets that follow a colon or comma or that begin the text. Finally,
-// we look to see that the remaining characters are only whitespace or ']' or
-// ',' or ':' or '{' or '}'. If that is so, then the text is safe for eval.
-
-            if (/^[\],:{}\s]*$/.
-test(text.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, '@').
-replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']').
-replace(/(?:^|:|,)(?:\s*\[)+/g, ''))) {
-
-// In the third 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.
-
-                j = eval('(' + text + ')');
-
-// In the optional fourth stage, we recursively walk the new structure, passing
-// each name/value pair to a reviver function for possible transformation.
-
-                return typeof reviver === 'function' ?
-                    walk({'': j}, '') : j;
-            }
-
-// If the text is not JSON parseable, then a SyntaxError is thrown.
-
-            throw new SyntaxError('JSON.parse');
-        };
-    }
-}());