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, ClassNotFoundExceptionEm 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
- ObjectOutputStream (Java SE 21 & JDK 21)
- ByteArrayOutputStream (Java SE 21 & JDK 21)
- ByteArrayInputStream (Java SE 21 & JDK 21)
- ObjectInputStream (Java SE 21 & JDK 21)
- Serializable (Java SE 21 & JDK 21)
- Java Object Serialization Specification: 3 - Object Input Classes
- Java Object Serialization Specification: 5 - Versioning of Serializable Objects