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

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.

Fontes