Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

ObjectOutputStream — écrire des objets Java

ObjectOutputStream écrit des objets dans un flux d’octets de sérialisation Java. Découvrez writeObject, la différence entre flush et close, ainsi que la fermeture automatique avec try-with-resources.

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

Syntaxe

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

ObjectOutputStream enveloppe un OutputStream et écrit le format binaire de sérialisation Java, et non du texte. Son constructeur écrit un en-tête. ObjectOutputStream.writeObject(obj) écrit un graphe d’objets ; les objets ordinaires doivent implémenter Serializable. Les références partagées et les cycles sont préservés au moyen de poignées, au lieu de copier plusieurs fois un objet.

La sérialisation par défaut inclut les champs non statiques qui ne sont pas transient. Si un objet non sérialisable doit être écrit, une NotSerializableException est levée. La lecture avec ObjectInputStream exige des classes compatibles. Les opérations de lecture explicites doivent correspondre, par leur ordre et leur nature, aux opérations explicites d’écriture des données. Les champs n’ont pas à être identiques : l’ajout d’un champ peut être une modification compatible avec la désérialisation par défaut. La suppression d’un champ est une modification incompatible : même si la désérialisation réussit, une version antérieure de la classe peut recevoir la valeur par défaut de ce champ et ne plus pouvoir respecter son contrat. N’écrivez pas de secrets sans contrôler délibérément l’état sérialisé.

ObjectOutputStream.flush() transmet les octets mis en tampon et vide le flux sous-jacent ; il ne ferme pas le flux et ne garantit pas l’écriture physique sur le disque. ObjectOutputStream.close() ferme le flux et libère les ressources. Préférez try-with-resources, qui appelle close() automatiquement. Les opérations peuvent lever IOException ; après un échec de writeObject, ne supposez pas que le flux reste utilisable.

Exemples

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

Résultat

CKTIS

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources