为什么 Jersey 的 UriBuilder.build 方法编码 #'s 和 %'s，而不是 /'s？

Question

我有一个相当典型的 REST API，只是资源的 id 不是整数，而是字符串，通常包含 / 字符。因此，如果客户的 ID 为 string/with/slashes，则该客户的 URI 应为 http://localhost/customers/string%2Fwith%2Fslashes。返回客户列表时，我想使用 UriBuilder 这样我就可以将它放在 ATOM 样式链接元素的 href 中。但这并不完全有效；这是一个小测试类，它显示了我的意思：

@Path("/customers")
public class JerseyTest {

  @Path("{id}")
  public Customer getCustomer(@PathParam("{id}") String id) {
    return null;
  }

  public static void main(String[] args) {
    buildURI("string#with#hashes"); // => http://localhost/customers/string%23with%23hashes
    buildURI("string/with/slashes"); // => http://localhost/customers/string/with/slashes
  }

  public static void buildURI(String id) {
    UriBuilder builder = UriBuilder.fromUri("http://localhost");
    builder.path(JerseyTest.class).path(JerseyTest.class, "getCustomer");
    URI uri = builder.build(id);
    System.out.println(uri);
  }
}

# 的编码按照我的预期进行，但 / 的编码却没有。我尝试使用 builder.build(URLEncoder.encode(id)) 代替，但随后 UriBuilder 对 % 进行编码，因此您会得到 .../string %252Fwith%252Fslashes！

对我来说，它编码 # 和 % 但不是 / 似乎不一致，但我怀疑它有一个很好的理由，但我不是看到。所以我的问题是：

1. 如何让 UriBuilder 给我 .../string%2Fwith%2Fslashes，这是导致 Jersey 使用 调用 getCustomer 的 URI >id 等于字符串/带/斜杠？ 编辑：我发现了一种解决此问题的方法：builder.buildFromEncoded(URLEncoder.encode(id))。不过，让这个问题悬而未决，希望得到第二部分的答案......
2. 更一般地说，为什么 UriBuilder.build 编码一些特殊字符，而不是其他字符？

我发现 如何对 URI 参数值进行编码？，其中接受的答案是“使用 UriBuilder”。嗯，我正在使用它，但显然我使用方式不正确。

Answer 1

这似乎是一个已确认的问题：

http://java.net/jira/browse/JAX_RS_SPEC-70

你的解决方法听起来不错。