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.