Java еквівалентна encodeURIComponent JavaScript, яка видає однакові результати?

Я експериментував з різними бітами коду Java, намагаючись придумати щось, що буде кодувати рядок, що містить лапки, пробіли та "екзотичні" символи Unicode, і видаватиме результат, ідентичний функції encodeURIComponent JavaScript .

Мій рядок для тестування на катування: "A" B ± "

Якщо я введу в Firebug такий вираз JavaScript:

encodeURIComponent('"A" B ± "');

—Тоді я отримую:

"%22A%22%20B%20%C2%B1%20%22"

Ось моя маленька тестова програма Java:

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;

public class EncodingTest
{
  public static void main(String[] args) throws UnsupportedEncodingException
  {
    String s = "\"A\" B ± \"";
    System.out.println("URLEncoder.encode returns "
      + URLEncoder.encode(s, "UTF-8"));

    System.out.println("getBytes returns "
      + new String(s.getBytes("UTF-8"), "ISO-8859-1"));
  }
}

—Ця програма виводить:

URLEncoder.encode повертає% 22A% 22 + B +% C2% B1 +% 22
getBytes повертає "A" B ± "

Близько, але сигари немає! Який найкращий спосіб кодування рядка UTF-8 за допомогою Java, щоб він видавав ті самі результати, що і JavaScript encodeURIComponent?

РЕДАКТУВАТИ: Я використовую Java 1.4 незабаром переходячи до Java 5

Дивлячись на відмінності в реалізації, я бачу, що:

MDC наencodeURIComponent() :

• буквальні символи (подання регулярного виразу): [-a-zA-Z0-9._*~'()!]

Документація Java 1.5.0 щодоURLEncoder :

• буквальні символи (подання регулярного виразу): [-a-zA-Z0-9._*]
• пробіл " "перетворюється в знак плюса "+".

Отже, в основному, щоб отримати бажаний результат, використовуйте, URLEncoder.encode(s, "UTF-8")а потім виконайте певну обробку:

• замінити всі входження "+"з"%20"
• замінити всі випадки, що "%xx"представляють будь-який із [~'()!]back, на їх буквальні зустрічні частини

Зрештою, це клас я придумав:

import java.io.UnsupportedEncodingException;
import java.net.URLDecoder;
import java.net.URLEncoder;

/**
 * Utility class for JavaScript compatible UTF-8 encoding and decoding.
 * 
 * @see http://stackoverflow.com/questions/607176/java-equivalent-to-javascripts-encodeuricomponent-that-produces-identical-output
 * @author John Topley 
 */
public class EncodingUtil
{
  /**
   * Decodes the passed UTF-8 String using an algorithm that's compatible with
   * JavaScript's <code>decodeURIComponent</code> function. Returns
   * <code>null</code> if the String is <code>null</code>.
   *
   * @param s The UTF-8 encoded String to be decoded
   * @return the decoded String
   */
  public static String decodeURIComponent(String s)
  {
    if (s == null)
    {
      return null;
    }

    String result = null;

    try
    {
      result = URLDecoder.decode(s, "UTF-8");
    }

    // This exception should never occur.
    catch (UnsupportedEncodingException e)
    {
      result = s;  
    }

    return result;
  }

  /**
   * Encodes the passed String as UTF-8 using an algorithm that's compatible
   * with JavaScript's <code>encodeURIComponent</code> function. Returns
   * <code>null</code> if the String is <code>null</code>.
   * 
   * @param s The String to be encoded
   * @return the encoded String
   */
  public static String encodeURIComponent(String s)
  {
    String result = null;

    try
    {
      result = URLEncoder.encode(s, "UTF-8")
                         .replaceAll("\\+", "%20")
                         .replaceAll("\\%21", "!")
                         .replaceAll("\\%27", "'")
                         .replaceAll("\\%28", "(")
                         .replaceAll("\\%29", ")")
                         .replaceAll("\\%7E", "~");
    }

    // This exception should never occur.
    catch (UnsupportedEncodingException e)
    {
      result = s;
    }

    return result;
  }  

  /**
   * Private constructor to prevent this class from being instantiated.
   */
  private EncodingUtil()
  {
    super();
  }
}

Використовуючи механізм javascript, який постачається з Java 6:

import javax.script.ScriptEngine;
import javax.script.ScriptEngineManager;

public class Wow
{
    public static void main(String[] args) throws Exception
    {
        ScriptEngineManager factory = new ScriptEngineManager();
        ScriptEngine engine = factory.getEngineByName("JavaScript");
        engine.eval("print(encodeURIComponent('\"A\" B ± \"'))");
    }
}

Вихід:% 22A% 22% 20B% 20% c2% b1% 20% 22

Справа інша, але вона ближча до того, що ви хочете.

Я використовую java.net.URI#getRawPath(), напр

String s = "a+b c.html";
String fixed = new URI(null, null, s, null).getRawPath();

Значення fixedбуде a+b%20c.html, це те, що ви хочете.

Подальша обробка результатів URLEncoder.encode()видалення всіх плюсів, які повинні бути в URI. Наприклад

URLEncoder.encode("a+b c.html").replaceAll("\\+", "%20");

дасть вам a%20b%20c.html, що буде інтерпретовано як a b c.html.

Я придумав власну версію encodeURIComponent, тому що розміщене рішення має одну проблему, якщо в рядку був +, який слід закодувати, він перетвориться на пробіл.

Ось мій клас:

import java.io.UnsupportedEncodingException;
import java.util.BitSet;

public final class EscapeUtils
{
    /** used for the encodeURIComponent function */
    private static final BitSet dontNeedEncoding;

    static
    {
        dontNeedEncoding = new BitSet(256);

        // a-z
        for (int i = 97; i <= 122; ++i)
        {
            dontNeedEncoding.set(i);
        }
        // A-Z
        for (int i = 65; i <= 90; ++i)
        {
            dontNeedEncoding.set(i);
        }
        // 0-9
        for (int i = 48; i <= 57; ++i)
        {
            dontNeedEncoding.set(i);
        }

        // '()*
        for (int i = 39; i <= 42; ++i)
        {
            dontNeedEncoding.set(i);
        }
        dontNeedEncoding.set(33); // !
        dontNeedEncoding.set(45); // -
        dontNeedEncoding.set(46); // .
        dontNeedEncoding.set(95); // _
        dontNeedEncoding.set(126); // ~
    }

    /**
     * A Utility class should not be instantiated.
     */
    private EscapeUtils()
    {

    }

    /**
     * Escapes all characters except the following: alphabetic, decimal digits, - _ . ! ~ * ' ( )
     * 
     * @param input
     *            A component of a URI
     * @return the escaped URI component
     */
    public static String encodeURIComponent(String input)
    {
        if (input == null)
        {
            return input;
        }

        StringBuilder filtered = new StringBuilder(input.length());
        char c;
        for (int i = 0; i < input.length(); ++i)
        {
            c = input.charAt(i);
            if (dontNeedEncoding.get(c))
            {
                filtered.append(c);
            }
            else
            {
                final byte[] b = charToBytesUTF(c);

                for (int j = 0; j < b.length; ++j)
                {
                    filtered.append('%');
                    filtered.append("0123456789ABCDEF".charAt(b[j] >> 4 & 0xF));
                    filtered.append("0123456789ABCDEF".charAt(b[j] & 0xF));
                }
            }
        }
        return filtered.toString();
    }

    private static byte[] charToBytesUTF(char c)
    {
        try
        {
            return new String(new char[] { c }).getBytes("UTF-8");
        }
        catch (UnsupportedEncodingException e)
        {
            return new byte[] { (byte) c };
        }
    }
}

Я придумав ще одну реалізацію, задокументовану за адресою: http://blog.sangupta.com/2010/05/encodeuricomponent-and.html . Реалізація також може обробляти байти Unicode.

Я успішно використав клас java.net.URI так:

public static String uriEncode(String string) {
    String result = string;
    if (null != string) {
        try {
            String scheme = null;
            String ssp = string;
            int es = string.indexOf(':');
            if (es > 0) {
                scheme = string.substring(0, es);
                ssp = string.substring(es + 1);
            }
            result = (new URI(scheme, ssp, null)).toString();
        } catch (URISyntaxException usex) {
            // ignore and use string that has syntax error
        }
    }
    return result;
}

Це прямий приклад рішення Раві Валлау:

public String buildSafeURL(String partialURL, String documentName)
        throws ScriptException {
    ScriptEngineManager scriptEngineManager = new ScriptEngineManager();
    ScriptEngine scriptEngine = scriptEngineManager
            .getEngineByName("JavaScript");

    String urlSafeDocumentName = String.valueOf(scriptEngine
            .eval("encodeURIComponent('" + documentName + "')"));
    String safeURL = partialURL + urlSafeDocumentName;

    return safeURL;
}

public static void main(String[] args) {
    EncodeURIComponentDemo demo = new EncodeURIComponentDemo();
    String partialURL = "https://www.website.com/document/";
    String documentName = "Tom & Jerry Manuscript.pdf";

    try {
        System.out.println(demo.buildSafeURL(partialURL, documentName));
    } catch (ScriptException se) {
        se.printStackTrace();
    }
}

Вихід: https://www.website.com/document/Tom%20%26%20Jerry%20Manuscript.pdf

Він також відповідає на висяче запитання в коментарях Лорена Шкіпогня про те, як передати змінну String encodeURIComponent(). Метод scriptEngine.eval()повертає an Object, тому він може перетворюватись на String за допомогою String.valueOf()інших методів.

для мене це спрацювало:

import org.apache.http.client.utils.URIBuilder;

String encodedString = new URIBuilder()
  .setParameter("i", stringToEncode)
  .build()
  .getRawQuery() // output: i=encodedString
  .substring(2);

або з іншим UriBuilder

import javax.ws.rs.core.UriBuilder;

String encodedString = UriBuilder.fromPath("")
  .queryParam("i", stringToEncode)
  .toString()   // output: ?i=encodedString
  .substring(3);

На мій погляд, використання стандартної бібліотеки - краща ідея, а не подальша обробка вручну. Також відповідь @Chris виглядала добре, але вона не працює для URL-адрес, наприклад " http: // a + b c.html"

Це те, що я використовую:

private static final String HEX = "0123456789ABCDEF";

public static String encodeURIComponent(String str) {
    if (str == null) return null;

    byte[] bytes = str.getBytes(StandardCharsets.UTF_8);
    StringBuilder builder = new StringBuilder(bytes.length);

    for (byte c : bytes) {
        if (c >= 'a' ? c <= 'z' || c == '~' :
            c >= 'A' ? c <= 'Z' || c == '_' :
            c >= '0' ? c <= '9' :  c == '-' || c == '.')
            builder.append((char)c);
        else
            builder.append('%')
                   .append(HEX.charAt(c >> 4 & 0xf))
                   .append(HEX.charAt(c & 0xf));
    }

    return builder.toString();
}

Це виходить за рамки Javascript шляхом відсоткового кодування кожного символу, який не є беззастережним символом відповідно до RFC 3986 .

Це протилежне перетворення:

public static String decodeURIComponent(String str) {
    if (str == null) return null;

    int length = str.length();
    byte[] bytes = new byte[length / 3];
    StringBuilder builder = new StringBuilder(length);

    for (int i = 0; i < length; ) {
        char c = str.charAt(i);
        if (c != '%') {
            builder.append(c);
            i += 1;
        } else {
            int j = 0;
            do {
                char h = str.charAt(i + 1);
                char l = str.charAt(i + 2);
                i += 3;

                h -= '0';
                if (h >= 10) {
                    h |= ' ';
                    h -= 'a' - '0';
                    if (h >= 6) throw new IllegalArgumentException();
                    h += 10;
                }

                l -= '0';
                if (l >= 10) {
                    l |= ' ';
                    l -= 'a' - '0';
                    if (l >= 6) throw new IllegalArgumentException();
                    l += 10;
                }

                bytes[j++] = (byte)(h << 4 | l);
                if (i >= length) break;
                c = str.charAt(i);
            } while (c == '%');
            builder.append(new String(bytes, 0, j, UTF_8));
        }
    }

    return builder.toString();
}

Я знайшов клас PercentEscaper з бібліотеки google-http-java-client, який можна використовувати для реалізації encodeURIComponent досить легко.

PercentEscaper з домашньої сторінки google-http-java-client javadoc google-http-java-client

У бібліотеці Гуави є PercentEscaper:

Escaper percentEscaper = new PercentEscaper("-_.*", false);

"-_. *" - це безпечні символи

false говорить PercentEscaper, щоб уникнути космосу за допомогою "% 20", а не "+"

Раніше я String encodedUrl = new URI(null, url, null).toASCIIString(); кодував URL-адреси. Щоб додати параметри після існуючих у urlI, що використовуютьсяUriComponentsBuilder