问查询字符串参数的Java URL编码

EN

URLEncoder是最好的选择。您只需记住仅对单个查询字符串参数名称和/或值进行编码，而不是对整个URL进行编码，确保不会对查询字符串参数分隔符字符&或参数名称-值分隔符=进行编码。

String q = "random word £500 bank $";
String url = "https://example.com?q=" + URLEncoder.encode(q, StandardCharsets.UTF_8);

如果您仍未使用Java10或更新版本，则使用StandardCharsets.UTF_8.toString()作为字符集参数，或者如果仍未使用Java7或更新版本，则使用"UTF-8"。

请注意，查询参数中的空格由+表示，而不是%20，这是合法有效的。%20通常用于表示URI本身(URI-查询字符串分隔符?之前的部分)中的空格，而不是查询字符串(?之后的部分)中的空格。

还要注意，这里有三个encode()方法。一个没有Charset作为第二个参数，另一个使用String作为第二个参数，这引发了一个检查异常。不推荐使用不带Charset参数的参数。永远不要使用它，并且始终指定Charset参数。javadoc甚至明确建议使用RFC3986和W3C要求的UTF8编码。

所有其他字符都是不安全的，它们首先使用某种编码方案转换为一个或多个字节。然后，每个字节由3个字符的字符串"% xy“表示，其中xy是字节的两位十六进制表示。建议使用的编码方案是-8。但是，出于兼容性原因，如果未指定编码，则使用平台的默认编码。

另请参阅：

• What every web developer must know about URL encoding

我不会使用URLEncoder。除了命名错误(URLEncoder与URL无关)，效率低下(它使用StringBuffer而不是生成器，并且做一些其他很慢的事情)，它也很容易搞砸。

相反，我会使用URIBuilder或Spring's org.springframework.web.util.UriUtils.encodeQuery or Commons Apache HttpClient。原因是您必须以不同于参数值的方式转义查询参数名称(即BalusC的答案q)。

上面唯一的缺点(我痛苦地发现了这一点)是URL's are not a true subset of URI's。

示例代码：

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

URIBuilder ub = new URIBuilder("http://example.com/query");
ub.addParameter("q", "random word £500 bank \$");
String url = ub.toString();

// Result: http://example.com/query?q=random+word+%C2%A3500+bank+%24

由于我只是链接到其他答案，所以我将其标记为社区维基。请随意编辑。

您需要首先创建一个URI，如下所示：

String urlStr = "http://www.example.com/CEREC® Materials & Accessories/IPS Empress® CAD.pdf"
URL url= new URL(urlStr);
URI uri = new URI(url.getProtocol(), url.getUserInfo(), url.getHost(), url.getPort(), url.getPath(), url.getQuery(), url.getRef());

然后将该Uri转换为ASCII字符串：

urlStr=uri.toASCIIString();

现在你的url字符串是完全编码的，首先我们做了简单的url编码，然后我们将它转换成ASCII字符串，以确保字符串中没有US-ASCII以外的字符。这正是浏览器所做的事情。