1adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/* 2adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 3adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 4adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this work for additional information regarding copyright ownership. 5adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 6adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * (the "License"); you may not use this file except in compliance with 7adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the License. You may obtain a copy of the License at 8adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 9adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 10adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * See the License for the specific language governing permissions and 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * limitations under the License. 16adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 17adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 18adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage java.net; 19adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 20adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.io.UnsupportedEncodingException; 21f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilsonimport java.nio.charset.Charset; 2256099d23fcb002b164bff8fb7f14d6ec0453509eJesse Wilsonimport libcore.net.UriCodec; 23adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 24adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 25adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * This class is used to decode a string which is encoded in the {@code 26adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * application/x-www-form-urlencoded} MIME content type. 27adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 28adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic class URLDecoder { 29adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 30adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Decodes the argument which is assumed to be encoded in the {@code 31adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * x-www-form-urlencoded} MIME content type. 32adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 33adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project *'+' will be converted to space, '%' and two following hex digit 34adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * characters are converted to the equivalent byte value. All other 35adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * characters are passed through unmodified. For example "A+B+C %24%25" -> 36adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * "A B C $%". 37f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 38adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param s 39adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the encoded string. 40adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the decoded clear-text representation of the given string. 41adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @deprecated use {@link #decode(String, String)} instead. 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Deprecated 44adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static String decode(String s) { 45783631d82682027beaf80540ab08912fd56fea0cJesse Wilson return UriCodec.decode(s, true, Charset.defaultCharset(), true); 46adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 47f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 48adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 49adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Decodes the argument which is assumed to be encoded in the {@code 50adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * x-www-form-urlencoded} MIME content type using the specified encoding 51adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * scheme. 52adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 53adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project *'+' will be converted to space, '%' and two following hex digit 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * characters are converted to the equivalent byte value. All other 55adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * characters are passed through unmodified. For example "A+B+C %24%25" -> 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * "A B C $%". 57f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 58adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param s 59adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the encoded string. 60b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes * @param encoding 61adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the encoding scheme to be used. 62adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the decoded clear-text representation of the given string. 63adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws UnsupportedEncodingException 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the specified encoding scheme is invalid. 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 66b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes public static String decode(String s, String encoding) throws UnsupportedEncodingException { 67783631d82682027beaf80540ab08912fd56fea0cJesse Wilson return UriCodec.decode(s, true, Charset.forName(encoding), true); 68adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 69adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 70