Come si crea un URL o un URI in Java? C'è un modo idiomatico o biblioteche che lo fanno facilmente?

Devo consentire l'avvio da una stringa di richiesta, analizzare / modificare varie parti dell'URL (schema, host, percorso, stringa di query) e supportare l'aggiunta e la codifica automatica dei parametri di query.

A partire da Apache HTTP Component HttpClient 4.1.3, dal tutorial ufficiale :

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

Modifica: a partire dalla v4.2 URIUtils.createURI()è stato deprecato a favore di 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());

Come autore, probabilmente non sono la persona migliore per giudicare se il mio generatore di URL / URI è buono , ma qui è comunque: https://github.com/mikaelhg/urlbuilder

Volevo la soluzione completa più semplice possibile con zero dipendenze al di fuori del JDK, quindi ho dovuto eseguire il mio.

Apache HTTPClient ?

L'utilizzo di HTTPClient ha funzionato bene.

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();

}

Ci sono molte librerie che possono aiutarti con la costruzione di URI (non reinventare la ruota). Eccone tre per iniziare:

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();

Vedi anche: GIST> Test di URI Builder

Usa OkHttp

È il 2020 e c'è una libreria molto popolare chiamata OkHttp che è stata recitata 35K volte su GitHub. Con questa libreria, puoi creare un URL come di seguito:

import okhttp3.HttpUrl;

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

Dopo essere stato criticato per aver suggerito la classe URL. Accetterò il consiglio del commentatore e suggerirò invece la classe URI . Ti suggerisco di esaminare attentamente i costruttori di un URI poiché la classe è molto immutabile una volta creata.
Penso che questo costruttore ti permetta di impostare tutto nell'URI di cui potresti aver bisogno.

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