在 Java 中编写 URL 或 URI 的惯用方式是什么？

Question

如何在 Java 中构建 URL 或 URI？有没有一种惯用的方式或库可以轻松做到这一点？

我需要允许从请求字符串开始，解析/更改各种 URL 部分（方案、主机、路径、查询字符串）并支持添加和自动编码查询参数。

Answer 1

截至Apache HTTP Component HttpClient 4.1.3，来自官方tutorial：

public class HttpClientTest {
public static void main(String[] args) throws URISyntaxException {
    List<NameValuePair> qparams = new ArrayList<NameValuePair>();
    qparams.add(new BasicNameValuePair("q", "httpclient"));
    qparams.add(new BasicNameValuePair("btnG", "Google Search"));
    qparams.add(new BasicNameValuePair("aq", "f"));
    qparams.add(new BasicNameValuePair("oq", null));
    URI uri = URIUtils.createURI("http", "www.google.com", -1, "/search",
                                 URLEncodedUtils.format(qparams, "UTF-8"), null);
    HttpGet httpget = new HttpGet(uri);
    System.out.println(httpget.getURI());
    //http://www.google.com/search?q=httpclient&btnG=Google+Search&aq=f&oq=
}
}

编辑：从 v4.2 开始，URIUtils.createURI() 已被弃用，取而代之的是 URIBuilder：

URI uri = new URIBuilder()
        .setScheme("http")
        .setHost("www.google.com")
        .setPath("/search")
        .setParameter("q", "httpclient")
        .setParameter("btnG", "Google Search")
        .setParameter("aq", "f")
        .setParameter("oq", "")
        .build();
HttpGet httpget = new HttpGet(uri);
System.out.println(httpget.getURI());

Answer 2

作为作者，我可能不是判断我的 URL/URI 构建器是否好的最佳人选，但这里仍然是：https://github.com/mikaelhg/urlbuilder

我想要最简单的完整解决方案，在 JDK 之外零依赖，所以我不得不自己动手。

Answer 3

Apache HTTPClient?

Answer 4

使用 HTTPClient 效果很好。

protected static String createUrl(List<NameValuePair> pairs) throws URIException{

  HttpMethod method = new GetMethod("http://example.org");
  method.setQueryString(pairs.toArray(new NameValuePair[]{}));

  return method.getURI().getEscapedURI();

}

Answer 5

有很多库可以帮助您构建 URI（不要重新发明轮子）。以下三个可以帮助您入门：

---

Java EE 7

import javax.ws.rs.core.UriBuilder;
...
return UriBuilder.fromUri(url).queryParam(key, value).build();

---

org.apache.httpcomponents:httpclient:4.5.2

import org.apache.http.client.utils.URIBuilder;
...
return new URIBuilder(url).addParameter(key, value).build();

---

org.springframework:spring-web:4.2.5.RELEASE

import org.springframework.web.util.UriComponentsBuilder;
...
return UriComponentsBuilder.fromUriString(url).queryParam(key, value).build().toUri();

---

另请参阅： GIST > URI Builder Tests

Answer 6

使用 OkHttp

现在是 2021，有一个非常受欢迎的库，名为 OkHttp，它在 GitHub 上已被加星标 40K 次。使用这个库，您可以构建一个如下所示的 url：

import okhttp3.HttpUrl;

URL url = new HttpUrl.Builder()
    .scheme("http")
    .host("example.com")
    .port(4567)
    .addPathSegments("foldername/1234")
    .addQueryParameter("abc", "xyz")
    .build().url();

Answer 7

在因建议 URL 类而受到抨击之后。我会采纳评论者的建议并建议使用URI class。我建议您仔细查看 URI 的构造函数，因为该类一旦创建就非常不可变。
我认为此构造函数允许您在 URI 中设置您可能需要的所有内容。

URI(String scheme, String userInfo, String host, int port, String path, String query, String fragment)
          Constructs a hierarchical URI from the given components.