Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Serializar um objeto Java num array de bytes

Escreve um objeto num `byte[]` e reconstrói-o a partir de bytes de confiança gerados pelo mesmo programa. Vê por que motivo a serialização predefinida omite os campos `transient`.

Versão: Java SE 21

Sintaxe

Java SE 21 — java.io
ByteArrayOutputStream()
ObjectOutputStream(OutputStream out) throws IOException
void ObjectOutputStream.writeObject(Object obj) throws IOException
void ObjectOutputStream.flush() throws IOException
byte[] ByteArrayOutputStream.toByteArray()
ByteArrayInputStream(byte[] buf)
ObjectInputStream(InputStream in) throws IOException
Object ObjectInputStream.readObject() throws IOException, ClassNotFoundException

Em Java SE 21, as classes de java.io permitem escrever e reconstruir um objeto inteiramente em memória. O construtor de ObjectOutputStream escreve o cabeçalho do fluxo. writeObject(Object) serializa o objeto e o grafo alcançável através das referências que são serializadas. O parâmetro do tipo Object não garante que a operação seja bem-sucedida: um objeto a serializar que não implemente Serializable pode causar uma NotSerializableException.

Depois de writeObject(Object), chama flush() para enviar os bytes em espera para o fluxo subjacente sem o fechar. Em seguida, ByteArrayOutputStream.toByteArray() devolve um novo byte[] que contém uma cópia apenas dos bytes escritos. A chamada não expõe o buffer interno nem esvazia o buffer do fluxo de objetos. ByteArrayInputStream(byte[]) usa esse array sem o copiar.

O construtor de ObjectInputStream lê o cabeçalho. readObject() reconstrói o objeto e devolve-o como Object; a conversão explícita para Profile só verifica o tipo esperado depois da desserialização. Lê os valores sucessivos na ordem em que foram escritos e com os tipos correspondentes. As operações sobre fluxos podem lançar IOException; a leitura pode também lançar ClassNotFoundException se uma classe necessária não estiver disponível. Os blocos try com recursos fecham os fluxos de objetos.

A serialização predefinida omite os campos static e transient. Ao reconstruir uma classe serializável comum, o seu construtor e os inicializadores dos seus campos não são executados, por isso cache fica com o valor predefinido null, em vez de warm. Quando se exige que os valores de serialVersionUID coincidam, uma diferença causa InvalidClassException. Este requisito não se aplica às classes de arrays nem às classes record. Um identificador igual não torna compatível qualquer alteração à classe. Não se trata de um formato de intercâmbio independente da linguagem. Não desserializes dados não fiáveis: o exemplo só lê bytes gerados localmente pelo mesmo programa.

Exemplos

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

public class SerializationRoundTrip {
    private static final class Profile implements Serializable {
        @Serial
        private static final long serialVersionUID = 1L;

        private final String name;
        private transient String cache = "warm";

        private Profile(String name) {
            this.name = name;
        }
    }

    public static void main(String[] args)
            throws IOException, ClassNotFoundException {
        Profile original = new Profile("Ada");
        ByteArrayOutputStream buffer = new ByteArrayOutputStream();
        byte[] bytes;
        try (ObjectOutputStream out = new ObjectOutputStream(buffer)) {
            out.writeObject(original);
            out.flush();
            bytes = buffer.toByteArray();
        }

        Profile restored;
        try (ObjectInputStream in = new ObjectInputStream(new ByteArrayInputStream(bytes))) {
            restored = (Profile) in.readObject();
        }

        System.out.println("before: " + original.name + ", cache=" + original.cache);
        System.out.println("after: " + restored.name + ", cache=" + restored.cache);
    }
}

Resultado

before: Ada, cache=warm
after: Ada, cache=null

Compara `before` e `after`: `name` continua a ser `Ada`, mas `cache` tem o valor `warm` no original e `null` no objeto reconstruído.

Lições relacionadas

  • Java · Lição 52 · Avançado · Versão: 2

Fontes