URLDecoder.java revision f6c387128427e121477c1b32ad35cdcaa5101ba3
1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * this work for additional information regarding copyright ownership. 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * (the "License"); you may not use this file except in compliance with 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the License. You may obtain a copy of the License at 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See the License for the specific language governing permissions and 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * limitations under the License. 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpackage java.net; 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport java.io.ByteArrayOutputStream; 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport java.io.UnsupportedEncodingException; 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport org.apache.harmony.luni.util.Msg; 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport org.apache.harmony.luni.util.Util; 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * This class is used to decode a string which is encoded in the {@code 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * application/x-www-form-urlencoded} MIME content type. 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @since Android 1.0 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic class URLDecoder { 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Decodes the argument which is assumed to be encoded in the {@code 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * x-www-form-urlencoded} MIME content type. 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p> 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project *'+' will be converted to space, '%' and two following hex digit 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * characters are converted to the equivalent byte value. All other 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * characters are passed through unmodified. For example "A+B+C %24%25" -> 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * "A B C $%". 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * </p> 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @param s 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the encoded string. 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the decoded clear-text representation of the given string. 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @deprecated use {@link #decode(String, String)} instead. 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @since Android 1.0 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Deprecated 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static String decode(String s) { 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return Util.decode(s, true); 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Decodes the argument which is assumed to be encoded in the {@code 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * x-www-form-urlencoded} MIME content type using the specified encoding 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * scheme. 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p> 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project *'+' will be converted to space, '%' and two following hex digit 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * characters are converted to the equivalent byte value. All other 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * characters are passed through unmodified. For example "A+B+C %24%25" -> 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * "A B C $%". 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * </p> 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @param s 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the encoded string. 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @param enc 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the encoding scheme to be used. 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the decoded clear-text representation of the given string. 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @throws UnsupportedEncodingException 72f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * if the specified encoding scheme is invalid. 73f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @since Android 1.0 74f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 75f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static String decode(String s, String enc) 76f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throws UnsupportedEncodingException { 77f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 78f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (enc == null) { 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new NullPointerException(); 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // If the given encoding is an empty string throw an exception. 83f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (enc.length() == 0) { 84f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new UnsupportedEncodingException(Msg 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project .getString("K00a5", "enc")); //$NON-NLS-1$ //$NON-NLS-2$ 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 87f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 88f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project StringBuffer result = new StringBuffer(s.length()); 89f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project ByteArrayOutputStream out = new ByteArrayOutputStream(); 90f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project for (int i = 0; i < s.length();) { 91f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project char c = s.charAt(i); 92f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (c == '+') { 93f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project result.append(' '); 94f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } else if (c == '%') { 95f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project out.reset(); 96f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project do { 97f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (i + 2 >= s.length()) { 98f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new IllegalArgumentException(Msg.getString( 99f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project "K01fe", i)); //$NON-NLS-1$ 100f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 101f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project int d1 = Character.digit(s.charAt(i + 1), 16); 102f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project int d2 = Character.digit(s.charAt(i + 2), 16); 103f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (d1 == -1 || d2 == -1) { 104f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new IllegalArgumentException(Msg.getString( 105f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project "K01ff", //$NON-NLS-1$ 106f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project s.substring(i, i + 3), String.valueOf(i))); 107f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 108f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project out.write((byte) ((d1 << 4) + d2)); 109f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project i += 3; 110f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } while (i < s.length() && s.charAt(i) == '%'); 111f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project result.append(out.toString(enc)); 112f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project continue; 113f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } else { 114f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project result.append(c); 115f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 116f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project i++; 117f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 118f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return result.toString(); 119f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 120f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 121