//NextPatch
Perfil

Java 11 a fondo · HTTP Client estándar

HttpClient en Java 11: una petición GET sin librerías externas

Cargando la lección…

Guarda tu racha: crea tu cuenta

Este reto se sumará a tu cuenta nueva: su XP y tu primer día de racha. Luego, uno nuevo cada día para preparar tu próxima entrevista.

Hasta Java 11, hacer una petición HTTP sin dependencias significaba pelearse con HttpURLConnection, una API de 1997 llena de streams que había que abrir, leer y cerrar a mano. Por eso casi todos los proyectos acababan trayendo OkHttp o Apache HttpClient.

El JEP 321 estandarizó en Java 11 un cliente moderno, con soporte de HTTP/2, en el paquete y módulo java.net.http. En Java 9 y 10 había estado en incubadora, en jdk.incubator.http, así que el código escrito contra aquella versión tiene que cambiar al menos los imports.

Las tres piezas

  • HttpClient: el cliente. Se crea una vez, con HttpClient.newHttpClient() o con su builder, y se reutiliza para todas las peticiones.
  • HttpRequest: la petición, inmutable, construida con un builder.
  • HttpResponse: la respuesta. Un BodyHandler decide cómo se lee el cuerpo: como String, como array de bytes, a un fichero…
java
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder(
        URI.create("https://api.example.com/datos")).build();
var response = client.send(request,
        HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());

Síncrono o asíncrono

send es la variante bloqueante: el hilo espera a que llegue la respuesta. El mismo cliente ofrece sendAsync, que devuelve un CompletableFuture y deja el hilo libre mientras tanto.

Un detalle que conviene recordar en una revisión de código: crear un HttpClient nuevo para cada petición desperdicia lo que el cliente puede reaprovechar entre llamadas. Lo normal es tener uno compartido y crear solo una HttpRequest por petición.