| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You under the Apache License, Version 2.0 |
| * (the "License"); you may not use this file except in compliance with |
| * the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package java.net; |
| |
| import java.io.UnsupportedEncodingException; |
| import java.nio.ByteBuffer; |
| import java.nio.CharBuffer; |
| import java.nio.charset.Charset; |
| import java.nio.charset.IllegalCharsetNameException; |
| import java.nio.charset.UnsupportedCharsetException; |
| |
| import org.apache.harmony.luni.internal.nls.Messages; |
| |
| /** |
| * This class is used to decode a string which is encoded in the {@code |
| * application/x-www-form-urlencoded} MIME content type. |
| */ |
| public class URLDecoder { |
| |
| static Charset defaultCharset; |
| |
| /** |
| * Decodes the argument which is assumed to be encoded in the {@code |
| * x-www-form-urlencoded} MIME content type. |
| * <p> |
| *'+' will be converted to space, '%' and two following hex digit |
| * characters are converted to the equivalent byte value. All other |
| * characters are passed through unmodified. For example "A+B+C %24%25" -> |
| * "A B C $%". |
| * |
| * @param s |
| * the encoded string. |
| * @return the decoded clear-text representation of the given string. |
| * @deprecated use {@link #decode(String, String)} instead. |
| */ |
| @Deprecated |
| public static String decode(String s) { |
| |
| if (defaultCharset == null) { |
| try { |
| defaultCharset = Charset.forName( |
| System.getProperty("file.encoding")); //$NON-NLS-1$ |
| } catch (IllegalCharsetNameException e) { |
| // Ignored |
| } catch (UnsupportedCharsetException e) { |
| // Ignored |
| } |
| |
| if (defaultCharset == null) { |
| defaultCharset = Charset.forName("ISO-8859-1"); //$NON-NLS-1$ |
| } |
| } |
| return decode(s, defaultCharset); |
| } |
| |
| /** |
| * Decodes the argument which is assumed to be encoded in the {@code |
| * x-www-form-urlencoded} MIME content type using the specified encoding |
| * scheme. |
| * <p> |
| *'+' will be converted to space, '%' and two following hex digit |
| * characters are converted to the equivalent byte value. All other |
| * characters are passed through unmodified. For example "A+B+C %24%25" -> |
| * "A B C $%". |
| * |
| * @param s |
| * the encoded string. |
| * @param enc |
| * the encoding scheme to be used. |
| * @return the decoded clear-text representation of the given string. |
| * @throws UnsupportedEncodingException |
| * if the specified encoding scheme is invalid. |
| */ |
| public static String decode(String s, String enc) |
| throws UnsupportedEncodingException { |
| |
| if (enc == null) { |
| throw new NullPointerException(); |
| } |
| |
| // If the given encoding is an empty string throw an exception. |
| if (enc.length() == 0) { |
| throw new UnsupportedEncodingException( |
| // luni.99=Invalid parameter - {0} |
| Messages.getString("luni.99", "enc")); //$NON-NLS-1$ //$NON-NLS-2$ |
| } |
| |
| if (s.indexOf('%') == -1) { |
| if (s.indexOf('+') == -1) |
| return s; |
| char str[] = s.toCharArray(); |
| for (int i = 0; i < str.length; i++) { |
| if (str[i] == '+') |
| str[i] = ' '; |
| } |
| return new String(str); |
| } |
| |
| Charset charset = null; |
| try { |
| charset = Charset.forName(enc); |
| } catch (IllegalCharsetNameException e) { |
| throw (UnsupportedEncodingException) (new UnsupportedEncodingException( |
| enc).initCause(e)); |
| } catch (UnsupportedCharsetException e) { |
| throw (UnsupportedEncodingException) (new UnsupportedEncodingException( |
| enc).initCause(e)); |
| } |
| |
| return decode(s, charset); |
| } |
| |
| private static String decode(String s, Charset charset) { |
| |
| char str_buf[] = new char[s.length()]; |
| byte buf[] = new byte[s.length() / 3]; |
| int buf_len = 0; |
| |
| for (int i = 0; i < s.length();) { |
| char c = s.charAt(i); |
| if (c == '+') { |
| str_buf[buf_len] = ' '; |
| } else if (c == '%') { |
| |
| int len = 0; |
| do { |
| if (i + 2 >= s.length()) { |
| throw new IllegalArgumentException( |
| // luni.80=Incomplete % sequence at\: {0} |
| Messages.getString("luni.80", i)); //$NON-NLS-1$ |
| } |
| int d1 = Character.digit(s.charAt(i + 1), 16); |
| int d2 = Character.digit(s.charAt(i + 2), 16); |
| if (d1 == -1 || d2 == -1) { |
| throw new IllegalArgumentException( |
| // luni.81=Invalid % sequence ({0}) at\: {1} |
| Messages.getString( |
| "luni.81", //$NON-NLS-1$ |
| s.substring(i, i + 3), |
| String.valueOf(i))); |
| } |
| buf[len++] = (byte) ((d1 << 4) + d2); |
| i += 3; |
| } while (i < s.length() && s.charAt(i) == '%'); |
| |
| CharBuffer cb = charset.decode(ByteBuffer.wrap(buf, 0, len)); |
| len = cb.length(); |
| System.arraycopy(cb.array(), 0, str_buf, buf_len, len); |
| buf_len += len; |
| continue; |
| } else { |
| str_buf[buf_len] = c; |
| } |
| i++; |
| buf_len++; |
| } |
| return new String(str_buf, 0, buf_len); |
| } |
| } |