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.net
mas01mj@732: {
mas01mj@732: 	import flash.utils.ByteArray;
mas01mj@732: 	
mas01mj@732: 	/**
mas01mj@732: 	 * This class implements an efficient lookup table for URI
mas01mj@732: 	 * character escaping.  This class is only needed if you
mas01mj@732: 	 * create a derived class of URI to handle custom URI
mas01mj@732: 	 * syntax.  This class is used internally by URI.
mas01mj@732: 	 * 
mas01mj@732: 	 * @langversion ActionScript 3.0
mas01mj@732: 	 * @playerversion Flash 9.0* 
mas01mj@732: 	 */
mas01mj@732: 	public class URIEncodingBitmap extends ByteArray
mas01mj@732: 	{
mas01mj@732: 		/**
mas01mj@732: 		 * Constructor.  Creates an encoding bitmap using the given
mas01mj@732: 		 * string of characters as the set of characters that need
mas01mj@732: 		 * to be URI escaped.
mas01mj@732: 		 * 
mas01mj@732: 		 * @langversion ActionScript 3.0
mas01mj@732: 		 * @playerversion Flash 9.0
mas01mj@732: 		 */
mas01mj@732: 		public function URIEncodingBitmap(charsToEscape:String) : void
mas01mj@732: 		{
mas01mj@732: 			var i:int;
mas01mj@732: 			var data:ByteArray = new ByteArray();
mas01mj@732: 			
mas01mj@732: 			// Initialize our 128 bits (16 bytes) to zero
mas01mj@732: 			for (i = 0; i < 16; i++)
mas01mj@732: 				this.writeByte(0);
mas01mj@732: 				
mas01mj@732: 			data.writeUTFBytes(charsToEscape);
mas01mj@732: 			data.position = 0;
mas01mj@732: 			
mas01mj@732: 			while (data.bytesAvailable)
mas01mj@732: 			{
mas01mj@732: 				var c:int = data.readByte();
mas01mj@732: 				
mas01mj@732: 				if (c > 0x7f)
mas01mj@732: 					continue;  // only escape low bytes
mas01mj@732: 					
mas01mj@732: 				var enc:int;
mas01mj@732: 				this.position = (c >> 3);
mas01mj@732: 				enc = this.readByte();
mas01mj@732: 				enc |= 1 << (c & 0x7);
mas01mj@732: 				this.position = (c >> 3);
mas01mj@732: 				this.writeByte(enc);
mas01mj@732: 			}
mas01mj@732: 		}
mas01mj@732: 		
mas01mj@732: 		/**
mas01mj@732: 		 * Based on the data table contained in this object, check
mas01mj@732: 		 * if the given character should be escaped.
mas01mj@732: 		 * 
mas01mj@732: 		 * @param char	the character to be escaped.  Only the first
mas01mj@732: 		 * character in the string is used.  Any other characters
mas01mj@732: 		 * are ignored.
mas01mj@732: 		 * 
mas01mj@732: 		 * @return	the integer value of the raw UTF8 character.  For
mas01mj@732: 		 * example, if '%' is given, the return value is 37 (0x25).
mas01mj@732: 		 * If the character given does not need to be escaped, the
mas01mj@732: 		 * return value is zero.
mas01mj@732: 		 * 
mas01mj@732: 		 * @langversion ActionScript 3.0
mas01mj@732: 		 * @playerversion Flash 9.0 
mas01mj@732: 		 */
mas01mj@732: 		public function ShouldEscape(char:String) : int
mas01mj@732: 		{
mas01mj@732: 			var data:ByteArray = new ByteArray();
mas01mj@732: 			var c:int, mask:int;
mas01mj@732: 			
mas01mj@732: 			// write the character into a ByteArray so
mas01mj@732: 			// we can pull it out as a raw byte value.
mas01mj@732: 			data.writeUTFBytes(char);
mas01mj@732: 			data.position = 0;
mas01mj@732: 			c = data.readByte();
mas01mj@732: 			
mas01mj@732: 			if (c & 0x80)
mas01mj@732: 			{
mas01mj@732: 				// don't escape high byte characters.  It can make international
mas01mj@732: 				// URI's unreadable.  We just want to escape characters that would
mas01mj@732: 				// make URI syntax ambiguous.
mas01mj@732: 				return 0;
mas01mj@732: 			}
mas01mj@732: 			else if ((c < 0x1f) || (c == 0x7f))
mas01mj@732: 			{
mas01mj@732: 				// control characters must be escaped.
mas01mj@732: 				return c;
mas01mj@732: 			}
mas01mj@732: 			
mas01mj@732: 			this.position = (c >> 3);
mas01mj@732: 			mask = this.readByte();
mas01mj@732: 			
mas01mj@732: 			if (mask & (1 << (c & 0x7)))
mas01mj@732: 			{
mas01mj@732: 				// we need to escape this, return the numeric value
mas01mj@732: 				// of the character
mas01mj@732: 				return c;
mas01mj@732: 			}
mas01mj@732: 			else
mas01mj@732: 			{
mas01mj@732: 				return 0;
mas01mj@732: 			}
mas01mj@732: 		}
mas01mj@732: 	}
mas01mj@732: }