001: /*
002: License $Id: URLDecoder.java,v 1.6 2005/03/15 20:08:14 hendriks73 Exp $
003:
004: Copyright (c) 2001-2005 tagtraum industries.
005:
006: LGPL
007: ====
008:
009: jo! is free software; you can redistribute it and/or
010: modify it under the terms of the GNU Lesser General Public
011: License as published by the Free Software Foundation; either
012: version 2.1 of the License, or (at your option) any later version.
013:
014: jo! is distributed in the hope that it will be useful,
015: but WITHOUT ANY WARRANTY; without even the implied warranty of
016: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
017: Lesser General Public License for more details.
018:
019: You should have received a copy of the GNU Lesser General Public
020: License along with this library; if not, write to the Free Software
021: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
022:
023: For LGPL see <http://www.fsf.org/copyleft/lesser.txt>
024:
025:
026: Sun license
027: ===========
028:
029: This release contains software by Sun Microsystems. Therefore
030: the following conditions have to be met, too. They apply to the
031: files
032:
033: - lib/mail.jar
034: - lib/activation.jar
035: - lib/jsse.jar
036: - lib/jcert.jar
037: - lib/jaxp.jar
038: - lib/crimson.jar
039: - lib/servlet.jar
040: - lib/jnet.jar
041: - lib/jaas.jar
042: - lib/jaasmod.jar
043:
044: contained in this release.
045:
046: a. Licensee may not modify the Java Platform
047: Interface (JPI, identified as classes contained within the javax
048: package or any subpackages of the javax package), by creating additional
049: classes within the JPI or otherwise causing the addition to or modification
050: of the classes in the JPI. In the event that Licensee creates any
051: Java-related API and distribute such API to others for applet or
052: application development, you must promptly publish broadly, an accurate
053: specification for such API for free use by all developers of Java-based
054: software.
055:
056: b. Software is confidential copyrighted information of Sun and
057: title to all copies is retained by Sun and/or its licensors. Licensee
058: shall not modify, decompile, disassemble, decrypt, extract, or otherwise
059: reverse engineer Software. Software may not be leased, assigned, or
060: sublicensed, in whole or in part. Software is not designed or intended
061: for use in on-line control of aircraft, air traffic, aircraft navigation
062: or aircraft communications; or in the design, construction, operation or
063: maintenance of any nuclear facility. Licensee warrants that it will not
064: use or redistribute the Software for such purposes.
065:
066: c. Software is provided "AS IS," without a warranty
067: of any kind. ALL EXPRESS OR IMPLIED REPRESENTATIONS AND WARRANTIES,
068: INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
069: PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED.
070:
071: d. This License is effective until terminated. Licensee may
072: terminate this License at any time by destroying all copies of Software.
073: This License will terminate immediately without notice from Sun if Licensee
074: fails to comply with any provision of this License. Upon such termination,
075: Licensee must destroy all copies of Software.
076:
077: e. Software, including technical data, is subject to U.S.
078: export control laws, including the U.S. Export Administration Act and its
079: associated regulations, and may be subject to export or import regulations
080: in other countries. Licensee agrees to comply strictly with all such
081: regulations and acknowledges that it has the responsibility to obtain
082: licenses to export, re-export, or import Software. Software may not be
083: downloaded, or otherwise exported or re-exported (i) into, or to a national
084: or resident of, Cuba, Iraq, Iran, North Korea, Libya, Sudan, Syria or any
085: country to which the U.S. has embargoed goods; or (ii) to anyone on the
086: U.S. Treasury Department's list of Specially Designated Nations or the U.S.
087: Commerce Department's Table of Denial Orders.
088:
089:
090: Feedback
091: ========
092:
093: We encourage your feedback and suggestions and want to use your feedback to
094: improve the Software. Send all such feedback to:
095: <feedback@tagtraum.com>
096:
097: For more information on tagtraum industries and jo!
098: please see <http://www.tagtraum.com/>.
099:
100:
101: */
102: package com.tagtraum.framework.util;
103:
104: import java.net.URLEncoder;
105:
106: /**
107: * Fast but also correct URLDecoder.
108: *
109: * @author Hendrik Schreiber
110: * @version 1.1beta1 $Id: URLDecoder.java,v 1.6 2005/03/15 20:08:14 hendriks73 Exp $
111: */
112: public final class URLDecoder {
113:
114: /**
115: * Source-Version
116: */
117: public static String vcid = "$Id: URLDecoder.java,v 1.6 2005/03/15 20:08:14 hendriks73 Exp $";
118:
119: /**
120: * Decodes a URL.
121: */
122: public final static String decode(String anEncodedURL)
123: throws Exception {
124: if (anEncodedURL == null) {
125: return null;
126: // shortcut if no metachar is in there
127: }
128:
129: if (Math.max(anEncodedURL.indexOf('+'), anEncodedURL
130: .indexOf('%')) == -1) {
131: return anEncodedURL;
132:
133: }
134:
135: StringBuffer theDecodedURL = new StringBuffer();
136: int pos = 0;
137: int len = anEncodedURL.length();
138: char[] cbuf = anEncodedURL.toCharArray();
139:
140: theDecodedURL.ensureCapacity(len);
141:
142: while (pos < len) {
143: int plus = anEncodedURL.indexOf('+', pos);
144: int percent = anEncodedURL.indexOf('%', pos);
145: int laPos = Math.min(plus, percent);
146:
147: if (laPos == -1) {
148: laPos = Math.max(plus, percent);
149:
150: }
151:
152: if (laPos > pos) {
153: // yes we found some metachar
154: theDecodedURL
155: .append(anEncodedURL.substring(pos, laPos));
156: pos = laPos;
157: }
158:
159: if (pos >= len) {
160: break;
161: }
162:
163: if (laPos == -1) {
164: theDecodedURL.append(anEncodedURL.substring(pos));
165:
166: break;
167: }
168: char metaChar = cbuf[pos];
169: if (metaChar == '+') {
170: theDecodedURL.append(' ');
171: pos++;
172: continue;
173: } else if (metaChar == '%') {
174: try {
175: int c = Integer.parseInt(anEncodedURL.substring(
176: pos + 1, pos + 3), 16);
177: if (c > 127) {
178: return java.net.URLDecoder.decode(anEncodedURL,
179: "UTF-8"); // nice try, but we're fucked. somebody used non ASCII characters, so we do it the slow way
180: }
181: // we don't want to add %00 chars as they are a potential security risk. (rik)
182: else if (c != 0)
183: theDecodedURL.append((char) c);
184: } catch (NumberFormatException e) {
185: throw new IllegalArgumentException(
186: "Invalid % encoded character: " + e);
187: }
188: pos += 3;
189: }
190: }
191: return theDecodedURL.toString();
192: }
193:
194: // move this to a proper testcase. (rik)
195:
196: /**
197: * Test Method.
198: */
199: public static void main(String[] args) throws Exception {
200: String param = URLEncoder.encode("@hs@tagtraum.com@?");
201:
202: System.out.println(param);
203: System.out.println(decode(param));
204:
205: param = URLEncoder.encode("hs@tagtr+au?m.com");
206:
207: System.out.println(param);
208: System.out.println(decode(param));
209:
210: param = URLEncoder.encode("I'm here, where are you?");
211:
212: System.out.println(param);
213: System.out.println(decode(param));
214: }
215:
216: }
|