mas01mj@732: /*
mas01mj@732:   Copyright (c) 2008, Adobe Systems Incorporated
mas01mj@732:   All rights reserved.
mas01mj@732: 
mas01mj@732:   Redistribution and use in source and binary forms, with or without 
mas01mj@732:   modification, are permitted provided that the following conditions are
mas01mj@732:   met:
mas01mj@732: 
mas01mj@732:   * Redistributions of source code must retain the above copyright notice, 
mas01mj@732:     this list of conditions and the following disclaimer.
mas01mj@732:   
mas01mj@732:   * Redistributions in binary form must reproduce the above copyright
mas01mj@732:     notice, this list of conditions and the following disclaimer in the 
mas01mj@732:     documentation and/or other materials provided with the distribution.
mas01mj@732:   
mas01mj@732:   * Neither the name of Adobe Systems Incorporated nor the names of its 
mas01mj@732:     contributors may be used to endorse or promote products derived from 
mas01mj@732:     this software without specific prior written permission.
mas01mj@732: 
mas01mj@732:   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
mas01mj@732:   IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
mas01mj@732:   THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
mas01mj@732:   PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 
mas01mj@732:   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
mas01mj@732:   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
mas01mj@732:   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
mas01mj@732:   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
mas01mj@732:   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
mas01mj@732:   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
mas01mj@732:   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mas01mj@732: */
mas01mj@732: 
mas01mj@732: package com.adobe.serialization.json
mas01mj@732: {
mas01mj@732: 
mas01mj@732: 	/**
mas01mj@732: 	 * This class provides encoding and decoding of the JSON format.
mas01mj@732: 	 *
mas01mj@732: 	 * Example usage:
mas01mj@732: 	 * <code>
mas01mj@732: 	 * 		// create a JSON string from an internal object
mas01mj@732: 	 * 		JSON.encode( myObject );
mas01mj@732: 	 *
mas01mj@732: 	 *		// read a JSON string into an internal object
mas01mj@732: 	 *		var myObject:Object = JSON.decode( jsonString );
mas01mj@732: 	 *	</code>
mas01mj@732: 	 */
mas01mj@732: 	public class JSON
mas01mj@732: 	{
mas01mj@732: 		/**
mas01mj@732: 		 * Encodes a object into a JSON string.
mas01mj@732: 		 *
mas01mj@732: 		 * @param o The object to create a JSON string for
mas01mj@732: 		 * @return the JSON string representing o
mas01mj@732: 		 * @langversion ActionScript 3.0
mas01mj@732: 		 * @playerversion Flash 9.0
mas01mj@732: 		 * @tiptext
mas01mj@732: 		 */
mas01mj@732: 		public static function encode( o:Object ):String
mas01mj@732: 		{	
mas01mj@732: 			return new JSONEncoder( o ).getString();
mas01mj@732: 		}
mas01mj@732: 		
mas01mj@732: 		/**
mas01mj@732: 		 * Decodes a JSON string into a native object.
mas01mj@732: 		 * 
mas01mj@732: 		 * @param s The JSON string representing the object
mas01mj@732: 		 * @param strict Flag indicating if the decoder should strictly adhere
mas01mj@732: 		 * 		to the JSON standard or not.  The default of <code>true</code>
mas01mj@732: 		 * 		throws errors if the format does not match the JSON syntax exactly.
mas01mj@732: 		 * 		Pass <code>false</code> to allow for non-properly-formatted JSON
mas01mj@732: 		 * 		strings to be decoded with more leniancy.
mas01mj@732: 		 * @return A native object as specified by s
mas01mj@732: 		 * @throw JSONParseError
mas01mj@732: 		 * @langversion ActionScript 3.0
mas01mj@732: 		 * @playerversion Flash 9.0
mas01mj@732: 		 * @tiptext
mas01mj@732: 		 */
mas01mj@732: 		public static function decode( s:String, strict:Boolean = true ):*
mas01mj@732: 		{	
mas01mj@732: 			return new JSONDecoder( s, strict ).getValue();	
mas01mj@732: 		}
mas01mj@732: 	
mas01mj@732: 	}
mas01mj@732: 
mas01mj@732: }