CKTIS / Java
ObjectOutputStream — escrever objetos Java
ObjectOutputStream escreve objetos num fluxo de bytes de serialização Java. Saiba como funciona writeObject, qual a diferença entre flush e close e como try-with-resources fecha automaticamente.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
ObjectOutputStream out = new ObjectOutputStream(outputStream);
out.writeObject(object);
out.flush();
out.close();ObjectOutputStream envolve um OutputStream e escreve o formato binário de serialização Java, não texto. O seu construtor escreve um cabeçalho. ObjectOutputStream.writeObject(obj) escreve um grafo de objetos; os objetos comuns têm de implementar Serializable. As referências partilhadas e os ciclos são preservados através de identificadores, em vez de copiar repetidamente um objeto.
A serialização predefinida inclui os campos não estáticos que não sejam transient. Se for necessário escrever um objeto não serializável, é lançada NotSerializableException. A leitura com ObjectInputStream requer classes compatíveis. As operações explícitas de leitura têm de corresponder, em ordem e tipo, às operações explícitas de escrita de dados. Isto não exige campos idênticos: adicionar um campo pode ser uma alteração compatível com a desserialização predefinida. Remover um campo é uma alteração incompatível: mesmo que a desserialização seja bem-sucedida, uma versão anterior da classe pode receber o valor predefinido desse campo e ficar impossibilitada de cumprir o seu contrato. Não escreva segredos sem controlar deliberadamente o estado serializado.
ObjectOutputStream.flush() encaminha os bytes em buffer e descarrega o fluxo subjacente; não fecha o fluxo nem garante a gravação física em disco. ObjectOutputStream.close() fecha o fluxo e liberta recursos. Prefira try-with-resources, que chama close() automaticamente. As operações podem lançar IOException; após uma falha de writeObject, não parta do princípio de que o fluxo continua utilizável.
Exemplos
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());
}
}
}Resultado
CKTIS
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.