WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

ObjectOutputStream — Java-Objekte schreiben

ObjectOutputStream schreibt Objekte als Java-Serialisierungs-Bytestrom. Erfahre, wie writeObject funktioniert, worin sich flush und close unterscheiden und wie try-with-resources automatisch schließt.

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

Syntax

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

ObjectOutputStream umschließt einen OutputStream und schreibt das binäre Java-Serialisierungsformat, keinen Text. Sein Konstruktor schreibt einen Header. ObjectOutputStream.writeObject(obj) schreibt einen Objektgraphen; gewöhnliche Objekte müssen Serializable implementieren. Gemeinsam genutzte Referenzen und Zyklen werden mithilfe von Handles erhalten, statt ein Objekt wiederholt zu kopieren.

Die Standardserialisierung umfasst nicht-statische Felder, die nicht als transient markiert sind. Muss ein nicht serialisierbares Objekt geschrieben werden, wird NotSerializableException ausgelöst. Zum Lesen mit ObjectInputStream sind kompatible Klassen erforderlich. Explizite Leseoperationen müssen in Reihenfolge und Art den expliziten Datenschreibvorgängen entsprechen. Das setzt keine identische Feldstruktur voraus: Bei der Standarddeserialisierung kann das Hinzufügen eines Feldes eine kompatible Änderung sein. Das Entfernen eines Feldes ist eine inkompatible Änderung: Selbst wenn die Deserialisierung gelingt, kann eine ältere Version der Klasse für dieses Feld den Standardwert erhalten und dadurch ihren Vertrag nicht mehr erfüllen. Schreibe keine Geheimnisse, ohne den serialisierten Zustand bewusst zu kontrollieren.

ObjectOutputStream.flush() gibt gepufferte Bytes weiter und leert den zugrunde liegenden Stream; es schließt den Stream nicht und garantiert keine physische Speicherung auf dem Datenträger. ObjectOutputStream.close() schließt den Stream und gibt Ressourcen frei. Bevorzuge try-with-resources, das close() automatisch aufruft. Operationen können IOException auslösen; gehe nach einem Fehler bei writeObject nicht davon aus, dass der Stream weiterhin verwendbar ist.

Beispiele

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

Ergebnis

CKTIS

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen