Як створити URL або URI на Java? Чи є ідіоматичний спосіб чи бібліотеки, які легко це роблять?

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

Станом на Apache HTTP Component 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=
}
}

Редагувати: станом на 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());

Як автор, я, мабуть, не найкраща людина, щоб оцінити, чи хороший мій конструктор 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: spring-web: 4.2.5

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.