CKTIS / Java
transient — een veld uitsluiten van standaardserialisatie
Het sleutelwoord transient sluit een veld uit van de impliciete lijst met serialiseerbare velden in Java. Als het veld wordt overgeslagen, heeft het na het teruglezen van een gewoon Serializable-object zijn standaardwaarde, tenzij herstelcode een andere waarde toekent.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
transient Type fieldName;transient is een gereserveerd sleutelwoord en een veldmodifier, geen modifier voor methoden, parameters of lokale variabelen. Het geeft aan dat een veld geen deel uitmaakt van de blijvende toestand van een object. De modifier alleen maakt een klasse niet serialiseerbaar; voor standaardobjectserialisatie is Serializable vereist.
De impliciete lijst met serialiseerbare velden bevat instantievelden die niet static en ook niet transient zijn. Een private-veld wordt niet automatisch overgeslagen. Met static gemarkeerde velden horen bij de klasse en hoeven daarom niet als transient te worden gemarkeerd om ze uit deze lijst te houden. Een klasse kan de impliciete lijst vervangen met een geldige declaratie van serialPersistentFields. ObjectOutputStream gebruikt de gedeclareerde lijst bij het standaard wegschrijven van de toestand, ook als de klasse geen eigen writeObject-methode definieert.
Bij het deserialiseren van een gewone Serializable-klasse worden de constructor en de initialisatoren van instantievelden niet uitgevoerd. Zonder aanvullende herstelcode behoudt een overgeslagen veld de standaardwaarde van zijn type, zoals null, 0 of false. In het voorbeeld is cache na het lezen dus null, niet "ready", terwijl score de waarde 42 behoudt. Indien nodig kan een cache in readObject opnieuw worden opgebouwd.
transient versleutelt geen gegevens en vormt geen beveiligingsgrens. Een aangepaste methode writeObject kan de waarde van het veld expliciet wegschrijven, en Externalizable laat een klasse het schrijven en lezen regelen. Ga er ook niet van uit dat andere serialisatiemechanismen dezelfde regels volgen. Het voorbeeld leest alleen bytes die het zelf heeft gemaakt; niet-vertrouwde gegevens deserialiseren is gevaarlijk.
Voorbeelden
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);
}
}Resultaat
42 ready 42 null
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.