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

CKTIS / Java

ObjectInputStream — désérialiser des objets

ObjectInputStream reconstitue des objets à partir du flux binaire de sérialisation de Java. Découvrez readObject(), la gestion des exceptions et la fermeture avec close(), en gardant à l’esprit que désérialiser des données non fiables est dangereux.

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

Syntaxe

public ObjectInputStream(InputStream in) throws IOException
public final Object readObject() throws IOException, ClassNotFoundException
public void close() throws IOException

ObjectInputStream, dans java.io, lit les données écrites par ObjectOutputStream, et non du texte ou du JSON quelconque. Son constructeur prend un InputStream et vérifie l’en-tête de sérialisation ; il peut bloquer jusqu’à ce que cet en-tête arrive. Cette fiche concerne Java SE 21 ; les environnements d’exécution du dépôt et de production ne sont pas attestés.

ObjectInputStream.readObject() reconstitue un objet ainsi que les objets auxquels il fait référence, tout en préservant les références partagées. La méthode renvoie Object, y compris null : il faut donc vérifier ou convertir le type attendu. Lisez les valeurs dans le même ordre et avec les mêmes types que lors de l’écriture ; les données primitives se lisent avec des méthodes telles que readInt(). La méthode déclare IOException et ClassNotFoundException ; une classe incompatible peut provoquer InvalidClassException.

ObjectInputStream.close() ferme le flux et libère les ressources associées ; elle peut déclencher IOException. Utilisez try-with-resources afin que close() soit appelée même après une exception. L’exemple écrit en mémoire un String créé localement, puis le lit et affiche Hello, Java!.

Évitez de désérialiser des données non fiables : des méthodes de classe peuvent s’exécuter pendant la reconstitution. Convertir le résultat après readObject() n’est pas une mesure de sécurité. Si la désérialisation est nécessaire, configurez un ObjectInputFilter avant la lecture pour limiter les classes autorisées et la taille du graphe ; le filtrage ne remplace pas la validation des données.

Exemples

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

public class Main {
    public static void main(String[] args)
            throws IOException, ClassNotFoundException {
        ByteArrayOutputStream bytes = new ByteArrayOutputStream();
        try (ObjectOutputStream out = new ObjectOutputStream(bytes)) {
            out.writeObject("Hello, Java!");
        }

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

Résultat

Hello, Java!

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