CKTIS / Java
transient — escludere un campo dalla serializzazione predefinita
La parola chiave transient esclude un campo dall’elenco implicito dei campi serializzabili in Java. Se il campo viene omesso, dopo la lettura di un normale oggetto Serializable conserva il valore predefinito, a meno che il codice di ripristino non gli assegni un altro valore.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
transient Type fieldName;transient è una parola chiave riservata e un modificatore di campo, non un modificatore per metodi, parametri o variabili locali. Indica che un campo non fa parte dello stato persistente di un oggetto. Il modificatore da solo non rende serializzabile una classe: la serializzazione standard degli oggetti richiede Serializable.
L’elenco implicito dei campi serializzabili include i campi di istanza che non sono né static né transient. Un campo private non viene omesso automaticamente. I campi contrassegnati come static appartengono alla classe, quindi non è necessario contrassegnarli come transient per escluderli da questo elenco. Una classe può sostituire l’elenco implicito con una dichiarazione valida di serialPersistentFields. ObjectOutputStream usa l’elenco dichiarato per la scrittura predefinita dello stato, anche se la classe non definisce un metodo personalizzato writeObject.
Quando si deserializza una normale classe Serializable, il suo costruttore e gli inizializzatori dei campi di istanza non vengono eseguiti. In assenza di codice di ripristino aggiuntivo, un campo omesso conserva il valore predefinito del proprio tipo, ad esempio null, 0 o false. Quindi, nell’esempio, dopo la lettura cache vale null, non "ready", mentre score conserva 42. Se necessario, una cache può essere ricreata in readObject.
transient non cifra i dati e non costituisce un confine di sicurezza. Un metodo personalizzato writeObject può scrivere esplicitamente il valore del campo, mentre Externalizable consente a una classe di controllare scrittura e lettura. Non dare per scontato che altri meccanismi di serializzazione seguano le stesse regole. L’esempio legge solo byte creati da sé; deserializzare dati non attendibili è pericoloso.
Esempi
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);
}
}Risultato
42 ready 42 null
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.