在 Jersey Client 2 中编码大括号
Encoding curly braces in Jersey Client 2
我们正在使用 Jersey Client 2.21。我注意到当我们将大括号(又名大括号)作为参数值时,它没有得到正确编码。不仅如此,花括号内的任何内容也不会被编码。对于我测试过的常规括号或其他不安全字符,情况并非如此。
请看下面的例子。在这个例子中,我输入了三个参数。一个只有空格的控制参数。一种带有花括号,另一种带有普通括号。
public static void testJerseyEncoding() {
Client client = ClientBuilder.newClient();
String url = "http://foo.com/path";
Map<String, String> map = new HashMap<>();
map.put("paramWithCurly", " {with a space}");
map.put("paramWithOutCurly", "with a space");
map.put("paramWithBracket", "[with a space]");
WebTarget target = client.target(url);
for (Map.Entry<String, String> entry : map.entrySet()) {
target = target.queryParam(entry.getKey(), entry.getValue());
}
System.out.println(target.toString());
}
这是输出:
JerseyWebTarget { http://foo.com/path?paramWithBracket=%5Bwith+a+space%5D¶mWithOutCurly=with+a+space¶mWithCurly=+{with a space} }
Jersey Client 有问题还是我遗漏了什么?大括号应该编码为“%7B”。
当您在 curly 中创建一个带有值的参数时,Jersey 认为您要使用 URL 参数。参见 https://jersey.github.io/documentation/latest/uris-and-links.html。
UriBuilder.fromUri("http://localhost/")
.path("{a}")
.queryParam("name", "{value}")
.build("segment", "value");
所以你应该通过 URLEncoder 自己编码花括号,可能就像那里描述的那样:How to force URIBuilder.path(...) to encode parameters like "%AD"? This method doesn't always encode parameters with percentage, correctly.
与其手动对查询参数值进行预编码,更好的方法可能是 始终 使用模板参数,然后使用 resolveTemplate()
和不安全的值。
Client client = ClientBuilder.newClient();
WebTarget target = client.target("http://server")
.path("/foo")
.queryParam("bar", "{bar}")
.resolveTemplate("bar", "{\"foo\":\"bar\"}");
assertThat(target.getUri().toString())
.isEqualTo("http://server/foo?bar=%7B%22foo%22%3A%22bar%22%7D");
您可以使用 URLEncoder.encode( "..." , "UTF-8") 方法解决此问题
String java.net.URLEncoder.encode(String s, String enc) throws UnsupportedEncodingException
Translates a string into application/x-www-form-urlencoded format using a specific encoding scheme. This method uses the supplied encoding scheme to obtain the bytes for unsafe characters.
使用 URLEncoder.encode 更新您的代码
try {
map.put("paramWithCurly", URLEncoder.encode(" {with a space}", "UTF-8"));
map.put("paramWithOutCurly", URLEncoder.encode("with a space", "UTF-8"));
map.put("paramWithBracket", URLEncoder.encode("[with a space]", "UTF-8"));
} catch (UnsupportedEncodingException e1) {
System.err.println("........");
}
这是输出:
JerseyWebTarget { http://foo.com/path?paramWithBracket=%5Bwith%2Ba%2Bspace%5D¶mWithOutCurly=with%2Ba%2Bspace¶mWithCurly=%2B%7Bwith%2Ba%2Bspace%7D }
提示:-
using UTF-8 as the encoding scheme the string "The string ü@foo-bar" would get converted to "The+string+%C3%BC%40foo-bar"
参考:
所以,首先,Jersey 默认执行模板是很疯狂的。其次,这里的所有解决方案都是错误的...执行 URLEncoder.encode(..., "UTF-8")
将不适用于包含 space 的查询参数。由于 URLEncoder 会将 space 编码为 +
,Jersey 会将其解释为加号,因此 Jersey 最终将其编码为 %2B
。请参阅 https://docs.oracle.com/javase/7/docs/api/java/net/URLEncoder.html 以供参考。
我提出的解决方案(我对 Java 一直不太满意)是用 %7B
和 [ 替换所有 {
和 }
=17=]分别如下:
Map<String, String> map = new HashMap<>();
map.put("paramWithCurly", " {with a space}".replaceAll("\{", "%7B").replaceAll("\}", "%7D"));
map.put("paramWithOutCurly", "with a space");
map.put("paramWithBracket", "[with a space]");
WebTarget target = client.target(url);
for (Map.Entry<String, String> entry : map.entrySet()) {
target = target.queryParam(entry.getKey(), entry.getValue());
}
看来 Karim 上面的解决方案行不通,正如 Tapped 预测的那样。 URLEncoder.encode 将空格编码为加号,然后 Jersey 将其编码为 %2B 个不正确的字符。
我们正在使用 Jersey Client 2.21。我注意到当我们将大括号(又名大括号)作为参数值时,它没有得到正确编码。不仅如此,花括号内的任何内容也不会被编码。对于我测试过的常规括号或其他不安全字符,情况并非如此。
请看下面的例子。在这个例子中,我输入了三个参数。一个只有空格的控制参数。一种带有花括号,另一种带有普通括号。
public static void testJerseyEncoding() {
Client client = ClientBuilder.newClient();
String url = "http://foo.com/path";
Map<String, String> map = new HashMap<>();
map.put("paramWithCurly", " {with a space}");
map.put("paramWithOutCurly", "with a space");
map.put("paramWithBracket", "[with a space]");
WebTarget target = client.target(url);
for (Map.Entry<String, String> entry : map.entrySet()) {
target = target.queryParam(entry.getKey(), entry.getValue());
}
System.out.println(target.toString());
}
这是输出:
JerseyWebTarget { http://foo.com/path?paramWithBracket=%5Bwith+a+space%5D¶mWithOutCurly=with+a+space¶mWithCurly=+{with a space} }
Jersey Client 有问题还是我遗漏了什么?大括号应该编码为“%7B”。
当您在 curly 中创建一个带有值的参数时,Jersey 认为您要使用 URL 参数。参见 https://jersey.github.io/documentation/latest/uris-and-links.html。
UriBuilder.fromUri("http://localhost/")
.path("{a}")
.queryParam("name", "{value}")
.build("segment", "value");
所以你应该通过 URLEncoder 自己编码花括号,可能就像那里描述的那样:How to force URIBuilder.path(...) to encode parameters like "%AD"? This method doesn't always encode parameters with percentage, correctly.
与其手动对查询参数值进行预编码,更好的方法可能是 始终 使用模板参数,然后使用 resolveTemplate()
和不安全的值。
Client client = ClientBuilder.newClient();
WebTarget target = client.target("http://server")
.path("/foo")
.queryParam("bar", "{bar}")
.resolveTemplate("bar", "{\"foo\":\"bar\"}");
assertThat(target.getUri().toString())
.isEqualTo("http://server/foo?bar=%7B%22foo%22%3A%22bar%22%7D");
您可以使用 URLEncoder.encode( "..." , "UTF-8") 方法解决此问题
String java.net.URLEncoder.encode(String s, String enc) throws UnsupportedEncodingException
Translates a string into application/x-www-form-urlencoded format using a specific encoding scheme. This method uses the supplied encoding scheme to obtain the bytes for unsafe characters.
使用 URLEncoder.encode 更新您的代码
try {
map.put("paramWithCurly", URLEncoder.encode(" {with a space}", "UTF-8"));
map.put("paramWithOutCurly", URLEncoder.encode("with a space", "UTF-8"));
map.put("paramWithBracket", URLEncoder.encode("[with a space]", "UTF-8"));
} catch (UnsupportedEncodingException e1) {
System.err.println("........");
}
这是输出:
JerseyWebTarget { http://foo.com/path?paramWithBracket=%5Bwith%2Ba%2Bspace%5D¶mWithOutCurly=with%2Ba%2Bspace¶mWithCurly=%2B%7Bwith%2Ba%2Bspace%7D }
提示:-
using UTF-8 as the encoding scheme the string "The string ü@foo-bar" would get converted to "The+string+%C3%BC%40foo-bar"
参考:
所以,首先,Jersey 默认执行模板是很疯狂的。其次,这里的所有解决方案都是错误的...执行 URLEncoder.encode(..., "UTF-8")
将不适用于包含 space 的查询参数。由于 URLEncoder 会将 space 编码为 +
,Jersey 会将其解释为加号,因此 Jersey 最终将其编码为 %2B
。请参阅 https://docs.oracle.com/javase/7/docs/api/java/net/URLEncoder.html 以供参考。
我提出的解决方案(我对 Java 一直不太满意)是用 %7B
和 [ 替换所有 {
和 }
=17=]分别如下:
Map<String, String> map = new HashMap<>();
map.put("paramWithCurly", " {with a space}".replaceAll("\{", "%7B").replaceAll("\}", "%7D"));
map.put("paramWithOutCurly", "with a space");
map.put("paramWithBracket", "[with a space]");
WebTarget target = client.target(url);
for (Map.Entry<String, String> entry : map.entrySet()) {
target = target.queryParam(entry.getKey(), entry.getValue());
}
看来 Karim 上面的解决方案行不通,正如 Tapped 预测的那样。 URLEncoder.encode 将空格编码为加号,然后 Jersey 将其编码为 %2B 个不正确的字符。