Java Academy · Lección

Gestión de respuestas

BodyHandlers y códigos de estado

Gestión de respuestas es una lección gratuita de Java Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Java Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Java Academy incluye 4 lecciones en total.

Gestión de respuestas

Cada llamada al cliente HTTP devuelve un HttpResponse<T>. El tipo genérico T lo determina el BodyHandler que proporcione. En esta lección se exploran los handlers disponibles y cómo interpretar los códigos de estado.

La API de HttpResponse

Métodos principales de HttpResponse:

statusCode() — el estado de tipo int.
body() — el cuerpo descodificado de tipo T.
headers() — los encabezados de la respuesta.
uri() — el URI final, después de las redirecciones.
version() — HTTP/1.1 o HTTP/2.

BodyHandlers.ofString

El handler más habitual descodifica el cuerpo en un String usando el juego de caracteres de la respuesta y, si no se especifica, UTF-8. El tipo de respuesta es HttpResponse<String>.

import java.net.URI;
import java.net.http.*;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest req = HttpRequest.newBuilder()
            .uri(URI.create("https://example.com")).build();
        HttpResponse<String> res =
            client.send(req, HttpResponse.BodyHandlers.ofString());
        System.out.println(res.body().length());
    }
}

BodyHandlers.ofByteArray

Para contenido binario, como imágenes, use ofByteArray(). El tipo del cuerpo pasa a ser byte[], que puede escribir en disco o descodificar por su cuenta.

public class Main {
    public static void main(String[] args) {
        // ofByteArray() yields HttpResponse<byte[]>
        byte[] simulated = { 1, 2, 3, 4 };
        System.out.println("Bytes received: " + simulated.length);
    }
}

BodyHandlers.ofFile

ofFile(path) transmite la respuesta directamente al disco y le proporciona un HttpResponse<Path>. Esto evita almacenar una descarga grande en memoria.

import java.net.URI;
import java.net.http.*;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest req = HttpRequest.newBuilder()
            .uri(URI.create("https://example.com/file.zip")).build();
        HttpResponse<Path> res = client.send(req,
            HttpResponse.BodyHandlers.ofFile(Path.of("out.zip")));
        System.out.println("Saved to: " + res.body());
    }
}

BodyHandlers.discarding

Cuando solo le interesan el estado y los encabezados, discarding() descarta el cuerpo y produce un HttpResponse<Void>. Así evita el coste de almacenarlo temporalmente.

Comprobación del éxito

Una función auxiliar habitual comprueba si el estado se encuentra en el intervalo 2xx antes de confiar en el cuerpo.

public class Main {
    static boolean isSuccess(int code) {
        return code >= 200 && code < 300;
    }
    public static void main(String[] args) {
        System.out.println(isSuccess(204));
        System.out.println(isSuccess(404));
    }
}

Respuesta a las categorías de estado

Use la primera cifra para elegir una rama de la lógica según se trate de un éxito, una redirección o un error.

public class Main {
    static String classify(int code) {
        return switch (code / 100) {
            case 2 -> "Success";
            case 3 -> "Redirect";
            case 4 -> "Client error";
            case 5 -> "Server error";
            default -> "Unknown";
        };
    }
    public static void main(String[] args) {
        System.out.println(classify(503));
        System.out.println(classify(200));
    }
}

Asignación de cuerpos con mapping

BodyHandlers.mapping(upstream, fn) envuelve otro handler y transforma su resultado. Por ejemplo, puede analizar un cuerpo de tipo cadena y convertirlo en una longitud entera, todo dentro del handler.

Lectura de un encabezado específico

Para leer el valor de un encabezado de respuesta, use headers().firstValue(name), que devuelve un Optional<String>. Para obtener todos los valores de un encabezado repetido, use allValues(name).

import java.util.Optional;

public class Main {
    public static void main(String[] args) {
        Optional<String> len = Optional.of("1024");
        int contentLength = len.map(Integer::parseInt).orElse(0);
        System.out.println("Content-Length: " + contentLength);
    }
}

Elección de un handler

ofString — texto y API de JSON.
ofByteArray — cargas binarias pequeñas almacenadas en memoria.
ofFile — descargas grandes transmitidas al disco.
ofInputStream — procesamiento del cuerpo como un stream.
discarding — solicitudes en las que solo interesa el estado.

Comprobación rápida

Compruebe su comprensión del manejo de respuestas.

Repaso

Ha aprendido a interpretar respuestas HTTP:

HttpResponse expone statusCode(), body() y headers().
BodyHandler determina el tipo del cuerpo: String, byte[], Path, Void o stream.
Use ofFile para descargas grandes y evitar ejercer presión sobre la memoria.
Clasifique los códigos de estado por su primer dígito y compruebe el rango 2xx para confirmar el éxito.
Lea las cabeceras con firstValue / allValues.

Preguntas frecuentes

¿La lección «Gestión de respuestas» es gratis?

Sí — el texto completo de «Gestión de respuestas» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Java Academy, actualiza a CoddyKit PRO. El curso de Java Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Gestión de respuestas»?

BodyHandlers y códigos de estado Practicas Java Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Java Academy?

No se requiere experiencia previa. Java Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.

¿Cuánto tiempo toma la lección «Gestión de respuestas»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Java Academy?

Sí. Cada lección de Java Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Java Academy