CKTIS / Java
transient — exclure un champ de la sérialisation par défaut
Le mot-clé transient exclut un champ de la liste implicite des champs sérialisables en Java. Si le champ est omis, il conserve sa valeur par défaut après la lecture d’un objet Serializable ordinaire, sauf si du code de restauration lui en attribue une autre.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
transient Type fieldName;transient est un mot-clé réservé et un modificateur de champ, et non un modificateur de méthode, de paramètre ou de variable locale. Il indique qu’un champ ne fait pas partie de l’état persistant d’un objet. Ce modificateur ne rend pas, à lui seul, une classe sérialisable ; la sérialisation standard des objets nécessite Serializable.
La liste implicite des champs sérialisables comprend les champs d’instance qui ne sont ni static ni transient. Un champ private n’est pas automatiquement omis. Les champs marqués static appartiennent à la classe ; il n’est donc pas nécessaire de les marquer transient pour les exclure de cette liste. Une classe peut remplacer la liste implicite par une déclaration valide de serialPersistentFields. ObjectOutputStream utilise la liste déclarée pour l’écriture par défaut de l’état, même si la classe ne définit pas de méthode personnalisée writeObject.
Lors de la désérialisation d’une classe Serializable ordinaire, son constructeur et les initialiseurs de ses champs d’instance ne sont pas exécutés. En l’absence de code de restauration supplémentaire, un champ omis conserve la valeur par défaut de son type, par exemple null, 0 ou false. Ainsi, dans l’exemple, cache vaut null après la lecture, et non "ready", tandis que score conserve 42. Si nécessaire, un cache peut être reconstruit dans readObject.
transient ne chiffre pas les données et ne constitue pas une frontière de sécurité. Une méthode personnalisée writeObject peut écrire explicitement la valeur du champ, et Externalizable permet à une classe de contrôler l’écriture et la lecture. Ne supposez pas non plus que les autres mécanismes de sérialisation suivent les mêmes règles. L’exemple ne lit que des octets qu’il a lui-même créés ; désérialiser des données non fiables est dangereux.
Exemples
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);
}
}Résultat
42 ready 42 null
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.