001: /*
002: * Licensed to the Apache Software Foundation (ASF) under one or more
003: * contributor license agreements. See the NOTICE file distributed with
004: * this work for additional information regarding copyright ownership.
005: * The ASF licenses this file to You under the Apache License, Version 2.0
006: * (the "License"); you may not use this file except in compliance with
007: * the License. You may obtain a copy of the License at
008: *
009: * http://www.apache.org/licenses/LICENSE-2.0
010: *
011: * Unless required by applicable law or agreed to in writing, software
012: * distributed under the License is distributed on an "AS IS" BASIS,
013: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014: * See the License for the specific language governing permissions and
015: * limitations under the License.
016: */
017:
018: package java.net;
019:
020: import java.io.UnsupportedEncodingException;
021:
022: /**
023: * This class is used to encode a string using the format required by
024: * <code>application/x-www-form-urlencoded</code> MIME content type.
025: */
026: public class URLEncoder {
027:
028: static final String digits = "0123456789ABCDEF"; //$NON-NLS-1$
029:
030: /**
031: * Prevents this class from being instantiated.
032: */
033: private URLEncoder() {
034: }
035:
036: /**
037: * This class contains a utility method for converting a string to the
038: * format required by the <code>application/x-www-form-urlencoded</code>
039: * MIME content type.
040: * <p>
041: * All characters except letters ('a'..'z', 'A'..'Z') and numbers ('0'..'9')
042: * and characters '.', '-', '*', '_' are converted into their hexidecimal
043: * value prepended by '%'.
044: * <p>
045: * For example: '#' -> %23
046: * <p>
047: * In addition, spaces are substituted by '+'
048: *
049: * @return java.lang.String the string to be converted
050: * @param s
051: * java.lang.String the converted string
052: *
053: * @deprecated use URLEncoder#encode(String, String) instead
054: */
055: @Deprecated
056: public static String encode(String s) {
057: StringBuffer buf = new StringBuffer();
058: for (int i = 0; i < s.length(); i++) {
059: char ch = s.charAt(i);
060: if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z')
061: || (ch >= '0' && ch <= '9')
062: || ".-*_".indexOf(ch) > -1) { //$NON-NLS-1$
063: buf.append(ch);
064: } else if (ch == ' ') {
065: buf.append('+');
066: } else {
067: byte[] bytes = new String(new char[] { ch }).getBytes();
068: for (int j = 0; j < bytes.length; j++) {
069: buf.append('%');
070: buf.append(digits.charAt((bytes[j] & 0xf0) >> 4));
071: buf.append(digits.charAt(bytes[j] & 0xf));
072: }
073: }
074: }
075: return buf.toString();
076: }
077:
078: /**
079: * This class contains a utility method for converting a string to the
080: * format required by the <code>application/x-www-form-urlencoded</code>
081: * MIME content type.
082: *
083: * All characters except letters ('a'..'z', 'A'..'Z') and numbers ('0'..'9')
084: * and characters '.', '-', '*', '_' are converted into their hexadecimal
085: * value prepended by '%'.
086: *
087: * For example: '#' -> %23
088: *
089: * In addition, spaces are substituted by '+'
090: *
091: * @param s
092: * the string to be converted
093: * @param enc
094: * the name of a charset to use for encoding unsafe chars
095: * @return the converted string
096: * @throws UnsupportedEncodingException
097: * if the named charset is unsupported
098: */
099: public static String encode(String s, String enc)
100: throws UnsupportedEncodingException {
101:
102: if (s == null || enc == null) {
103: throw new NullPointerException();
104: }
105: // check for UnsupportedEncodingException
106: "".getBytes(enc); //$NON-NLS-1$
107:
108: StringBuffer buf = new StringBuffer();
109: int start = -1;
110: for (int i = 0; i < s.length(); i++) {
111: char ch = s.charAt(i);
112: if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z')
113: || (ch >= '0' && ch <= '9')
114: || " .-*_".indexOf(ch) > -1) { //$NON-NLS-1$
115: if (start >= 0) {
116: convert(s.substring(start, i), buf, enc);
117: start = -1;
118: }
119: if (ch != ' ') {
120: buf.append(ch);
121: } else {
122: buf.append('+');
123: }
124: } else {
125: if (start < 0) {
126: start = i;
127: }
128: }
129: }
130: if (start >= 0) {
131: convert(s.substring(start, s.length()), buf, enc);
132: }
133: return buf.toString();
134: }
135:
136: private static void convert(String s, StringBuffer buf, String enc)
137: throws UnsupportedEncodingException {
138: byte[] bytes = s.getBytes(enc);
139: for (int j = 0; j < bytes.length; j++) {
140: buf.append('%');
141: buf.append(digits.charAt((bytes[j] & 0xf0) >> 4));
142: buf.append(digits.charAt(bytes[j] & 0xf));
143: }
144: }
145: }
|