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

CKTIS / Java

transient — excluir um campo da serialização predefinida

A palavra-chave transient exclui um campo da lista implícita de campos serializáveis em Java. Se o campo for omitido, conserva o valor predefinido após a leitura de um objeto Serializable comum, a menos que o código de restauro lhe atribua outro valor.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

transient Type fieldName;

transient é uma palavra-chave reservada e um modificador de campo, não um modificador de métodos, parâmetros ou variáveis locais. Indica que um campo não faz parte do estado persistente de um objeto. O modificador, por si só, não torna uma classe serializável; a serialização padrão de objetos requer Serializable.

A lista implícita de campos serializáveis inclui os campos de instância que não são static nem transient. Um campo private não é omitido automaticamente. Os campos marcados como static pertencem à classe, pelo que não precisam de ser marcados como transient para serem excluídos desta lista. Uma classe pode substituir a lista implícita com uma declaração válida de serialPersistentFields. ObjectOutputStream usa a lista declarada para a escrita predefinida do estado, mesmo que a classe não defina um método personalizado writeObject.

Ao desserializar uma classe Serializable comum, o respetivo construtor e os inicializadores dos campos de instância não são executados. Sem código de restauro adicional, um campo omitido conserva o valor predefinido do seu tipo, como null, 0 ou false. Assim, no exemplo, cache fica com o valor null após a leitura, e não "ready", enquanto score conserva 42. Se necessário, pode reconstruir-se uma cache em readObject.

transient não cifra dados nem constitui uma fronteira de segurança. Um método personalizado writeObject pode escrever explicitamente o valor do campo, e Externalizable permite que uma classe controle a escrita e a leitura. Também não se deve presumir que outros mecanismos de serialização seguem as mesmas regras. O exemplo lê apenas bytes que ele próprio criou; desserializar dados não fidedignos é perigoso.

Exemplos

import java.io.*;

public class TransientDemo {
    private static class State implements Serializable {
        private static final long serialVersionUID = 1L;
        int score = 42;
        transient String cache = "ready";
    }

    public static void main(String[] args) throws IOException, ClassNotFoundException {
        State original = new State();
        ByteArrayOutputStream bytes = new ByteArrayOutputStream();
        try (ObjectOutputStream out = new ObjectOutputStream(bytes)) {
            out.writeObject(original);
        }
        State restored;
        try (ObjectInputStream in = new ObjectInputStream(
                new ByteArrayInputStream(bytes.toByteArray()))) {
            restored = (State) in.readObject();
        }
        System.out.println(original.score + " " + original.cache);
        System.out.println(restored.score + " " + restored.cache);
    }
}

Resultado

42 ready
42 null

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