Java Academy · Lezione

Corpi e intestazioni delle richieste

Inviare dati POST e impostare le intestazioni

Corpi e intestazioni delle richieste è una lezione Java Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Java Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Java Academy include 4 lezioni in totale.

Corpi e intestazioni delle richieste

Le richieste GET raramente richiedono un corpo, mentre POST, PUT e PATCH sì. Il client HTTP del JDK usa oggetti BodyPublisher per fornire i corpi delle richieste e metodi del builder per impostare le intestazioni.

Questa lezione illustra come inviare dati e controllare intestazioni come Content-Type.

BodyPublishers.ofString

Il publisher più semplice invia un corpo sotto forma di stringa. Passatelo al metodo POST(...) del builder della richiesta.

BodyPublishers.noBody() è disponibile per le richieste senza corpo.

import java.net.URI;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;

public class Main {
    public static void main(String[] args) {
        String json = "{\"name\":\"Ada\"}";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://example.com/users"))
            .POST(BodyPublishers.ofString(json))
            .build();
        System.out.println("Method: " + request.method());
    }
}

Impostazione di una singola intestazione

Usate header(name, value) per aggiungere una singola intestazione. Per inviare JSON, quasi sempre è necessario impostare Content-Type.

import java.net.URI;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;

public class Main {
    public static void main(String[] args) {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://example.com/users"))
            .header("Content-Type", "application/json")
            .POST(BodyPublishers.ofString("{}"))
            .build();
        System.out.println("Has Content-Type: " +
            request.headers().firstValue("Content-Type").isPresent());
    }
}

Impostazione di più intestazioni

headers(name1, value1, name2, value2, ...) imposta più intestazioni con una sola chiamata. Il numero di argomenti deve essere pari, altrimenti viene generata una IllegalArgumentException.

import java.net.URI;
import java.net.http.HttpRequest;

public class Main {
    public static void main(String[] args) {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://example.com"))
            .headers(
                "Accept", "application/json",
                "Accept-Language", "en-US")
            .GET()
            .build();
        System.out.println(request.headers().map().keySet());
    }
}

Intestazioni di autorizzazione

I token Bearer vengono inviati tramite l'intestazione Authorization. Create il valore come stringa; non registrate mai il token in chiaro nei log.

public class Main {
    public static void main(String[] args) {
        String token = "abc123";
        String headerValue = "Bearer " + token;
        System.out.println("Authorization: Bearer ***");
        System.out.println("Length: " + headerValue.length());
    }
}

PUT e DELETE

Il builder dispone di metodi dedicati: PUT(publisher), DELETE() e il metodo generico method(name, publisher) per qualsiasi altro verbo, ad esempio PATCH.

import java.net.URI;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;

public class Main {
    public static void main(String[] args) {
        HttpRequest patch = HttpRequest.newBuilder()
            .uri(URI.create("https://example.com/users/1"))
            .method("PATCH", BodyPublishers.ofString("{\"active\":true}"))
            .build();
        System.out.println("Method: " + patch.method());
    }
}

Corpi codificati come form

Per i dati in formato application/x-www-form-urlencoded, create manualmente la stringa del corpo, codificando ogni valore in formato URL, quindi pubblicatela come stringa.

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) {
        String body = "name=" + URLEncoder.encode("Ada Lovelace", StandardCharsets.UTF_8)
            + "&role=" + URLEncoder.encode("engineer", StandardCharsets.UTF_8);
        System.out.println(body);
    }
}

Invio del corpo di un file

BodyPublishers.ofFile(path) trasmette un file come corpo della richiesta senza caricarlo interamente in memoria: è ideale per i caricamenti.

import java.net.URI;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://example.com/upload"))
            .header("Content-Type", "application/octet-stream")
            .POST(BodyPublishers.ofFile(Path.of("data.bin")))
            .build();
        System.out.println("Upload request built");
    }
}

Corpi come array di byte

Quando disponete già dei byte in memoria, BodyPublishers.ofByteArray(byte[]) li invia direttamente. È utile per payload binari creati durante l'esecuzione.

import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) {
        byte[] payload = "raw-bytes".getBytes(StandardCharsets.UTF_8);
        // BodyPublishers.ofByteArray(payload) would wrap these bytes
        System.out.println("Payload size: " + payload.length + " bytes");
    }
}

Intestazioni soggette a restrizioni

Per motivi di sicurezza, il client non consente di impostare alcune intestazioni, come Host, Content-Length, Connection e Upgrade. Il tentativo di impostarle genera una IllegalArgumentException: il client le gestisce autonomamente.

Composizione della richiesta

Una tipica richiesta POST con JSON combina un publisher del corpo e un'intestazione del tipo di contenuto:

.POST(BodyPublishers.ofString(json))
.header("Content-Type", "application/json")
aggiungete .header("Authorization", "Bearer ...") se necessario

Verifica rapida

Verificate la vostra comprensione dei corpi e delle intestazioni delle richieste.

Riepilogo

Avete imparato a inviare dati e controllare le intestazioni:

BodyPublishers.ofString / ofByteArray / ofFile forniscono i corpi delle richieste.
POST / PUT / DELETE / method(...) scelgono il verbo HTTP.
header(...) e headers(...) impostano le intestazioni delle richieste.
Impostate Content-Type per JSON e dati dei form; usate Authorization per i token.
Alcune intestazioni, come Host e Content-Length, sono soggette a restrizioni e vengono gestite dal client.

Domande Frequenti

La lezione «Corpi e intestazioni delle richieste» è gratuita?

Sì — il testo completo di «Corpi e intestazioni delle richieste» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Java Academy, passa a CoddyKit PRO. Il corso Java Academy include 4 lezioni in totale.

Cosa imparerò in «Corpi e intestazioni delle richieste»?

Inviare dati POST e impostare le intestazioni Eserciti Java Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Java Academy?

Non è richiesta alcuna esperienza precedente. Java Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «Corpi e intestazioni delle richieste»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Java Academy?

Sì. Ogni lezione Java Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Java Academy