Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ObjectOutputStream — scrivere oggetti Java

ObjectOutputStream scrive oggetti in un flusso di byte di serializzazione Java. Scopri come funziona writeObject, la differenza tra flush e close e la chiusura automatica con try-with-resources.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

ObjectOutputStream out = new ObjectOutputStream(outputStream);
out.writeObject(object);
out.flush();
out.close();

ObjectOutputStream avvolge un OutputStream e scrive il formato binario di serializzazione Java, non testo. Il suo costruttore scrive un’intestazione. ObjectOutputStream.writeObject(obj) scrive un grafo di oggetti; gli oggetti comuni devono implementare Serializable. I riferimenti condivisi e i cicli vengono preservati tramite handle, invece di copiare più volte un oggetto.

La serializzazione predefinita include i campi non statici che non sono transient. Se è necessario scrivere un oggetto non serializzabile, viene generata NotSerializableException. La lettura con ObjectInputStream richiede classi compatibili. Le operazioni esplicite di lettura devono corrispondere per ordine e tipo alle operazioni esplicite di scrittura dei dati. Questo non richiede che i campi siano identici: l’aggiunta di un campo può essere una modifica compatibile con la deserializzazione predefinita. La rimozione di un campo è una modifica incompatibile: anche se la deserializzazione riesce, una versione precedente della classe può ricevere il valore predefinito di quel campo e non riuscire a rispettare il proprio contratto. Non scrivere segreti senza controllare consapevolmente lo stato serializzato.

ObjectOutputStream.flush() inoltra i byte nel buffer e svuota il flusso sottostante; non chiude il flusso né garantisce la scrittura fisica su disco. ObjectOutputStream.close() chiude il flusso e libera le risorse. Preferisci try-with-resources, che chiama automaticamente close(). Le operazioni possono generare IOException; dopo un errore di writeObject, non dare per scontato che il flusso sia ancora utilizzabile.

Esempi

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;

public class Main {
    public static void main(String[] args) throws Exception {
        ByteArrayOutputStream bytes = new ByteArrayOutputStream();
        try (ObjectOutputStream out = new ObjectOutputStream(bytes)) {
            out.writeObject("CKTIS");
            out.flush();
        }

        try (ObjectInputStream in = new ObjectInputStream(
                new ByteArrayInputStream(bytes.toByteArray()))) {
            System.out.println(in.readObject());
        }
    }
}

Risultato

CKTIS

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti