Как создать URL-адрес или URI в Java? Есть ли идиоматический способ или библиотеки, которые легко это делают?

Мне нужно разрешить запуск со строки запроса, анализировать / изменять различные части URL-адреса (схема, хост, путь, строка запроса) и поддерживать добавление и автоматическое кодирование параметров запроса.

Что касается HTTP-компонента Apache HttpClient 4.1.3, из официального руководства :

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=
}
}

Изменить: начиная URIUtils.createURI()с версии 4.2 устарел в пользу 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());

Как автор, я, вероятно, не лучший человек, чтобы судить о том, хорош ли мой построитель URL / URI , но, тем не менее, вот он: https://github.com/mikaelhg/urlbuilder

Мне нужно было как можно более простое полное решение с нулевыми зависимостями вне JDK, поэтому мне пришлось применить собственное.

Apache HTTPClient ?

Использование 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();

}

Существует множество библиотек, которые могут помочь вам в создании 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: весна-страница: 4.2.5.RELEASE

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

См. Также: GIST> Тесты построителя URI

Используйте OkHttp

Это 2020 и есть очень популярная библиотека имени OkHttp которая помечено 35k раз на GitHub. С помощью этой библиотеки вы можете создать URL-адрес, как показано ниже:

import okhttp3.HttpUrl;

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

После критики за предложение класса URL. Я воспользуюсь советом комментатора и предложу вместо этого класс URI . Я предлагаю вам внимательно изучить конструкторы 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.