CKTIS / Java
ObjectOutputStream — Java-objecten schrijven
ObjectOutputStream schrijft objecten als een Java-serialisatiebyte stream. Lees hoe writeObject werkt, wat het verschil is tussen flush en close en hoe try-with-resources automatisch afsluit.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
ObjectOutputStream out = new ObjectOutputStream(outputStream);
out.writeObject(object);
out.flush();
out.close();ObjectOutputStream verpakt een OutputStream en schrijft het binaire Java-serialisatieformaat, geen tekst. De constructor schrijft een header. ObjectOutputStream.writeObject(obj) schrijft een objectgrafiek; gewone objecten moeten Serializable implementeren. Gedeelde verwijzingen en cycli blijven behouden via handles, in plaats van een object steeds opnieuw te kopiëren.
De standaardserialisatie omvat niet-statische velden die niet transient zijn. Als een niet-serialiseerbaar object moet worden geschreven, ontstaat een NotSerializableException. Lezen met ObjectInputStream vereist compatibele klassen. Expliciete leesbewerkingen moeten qua volgorde en soort overeenkomen met de expliciete bewerkingen waarmee de gegevens zijn geschreven. De velden hoeven niet identiek te zijn: bij standaarddeserialisatie kan het toevoegen van een veld een compatibele wijziging zijn. Het verwijderen van een veld is een incompatibele wijziging: zelfs als de deserialisatie slaagt, kan een oudere versie van de klasse voor dat veld de standaardwaarde krijgen en daardoor niet meer aan haar contract voldoen. Schrijf geen geheimen weg zonder de geserialiseerde toestand bewust te beheersen.
ObjectOutputStream.flush() stuurt gebufferde bytes door en leegt de onderliggende stream; het sluit de stream niet en garandeert geen fysieke opslag op schijf. ObjectOutputStream.close() sluit de stream en geeft resources vrij. Gebruik bij voorkeur try-with-resources, dat automatisch close() aanroept. Bewerkingen kunnen IOException veroorzaken; ga er na een fout bij writeObject niet van uit dat de stream nog bruikbaar is.
Voorbeelden
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());
}
}
}Resultaat
CKTIS
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.