WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

transient – ein Feld bei der Standardserialisierung ausschließen

Das Schlüsselwort transient schließt ein Feld aus der impliziten Liste serialisierbarer Felder in Java aus. Wird das Feld ausgelassen, hat es nach dem Einlesen eines gewöhnlichen Serializable-Objekts seinen Standardwert, sofern Wiederherstellungscode keinen anderen Wert zuweist.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

transient Type fieldName;

transient ist ein reserviertes Schlüsselwort und ein Feldmodifizierer, kein Modifizierer für Methoden, Parameter oder lokale Variablen. Es kennzeichnet ein Feld als nicht zum dauerhaften Zustand eines Objekts gehörend. Der Modifizierer allein macht eine Klasse nicht serialisierbar; die standardmäßige Objektserialisierung erfordert Serializable.

Die implizite Liste serialisierbarer Felder umfasst Instanzfelder, die weder static noch transient sind. Ein private-Feld wird nicht automatisch ausgelassen. Mit static markierte Felder gehören zur Klasse und müssen daher nicht als transient markiert werden, um sie aus dieser Liste auszuschließen. Eine Klasse kann die implizite Liste durch eine gültige Deklaration von serialPersistentFields ersetzen. ObjectOutputStream verwendet beim standardmäßigen Schreiben des Zustands die deklarierte Liste, auch wenn die Klasse keine eigene Methode writeObject definiert.

Beim Deserialisieren einer gewöhnlichen Serializable-Klasse werden ihr Konstruktor und die Initialisierer ihrer Instanzfelder nicht ausgeführt. Ohne zusätzlichen Wiederherstellungscode behält ein ausgelassenes Feld den Standardwert seines Typs, zum Beispiel null, 0 oder false. Im Beispiel ist cache nach dem Einlesen also null und nicht "ready", während score den Wert 42 behält. Bei Bedarf kann ein Cache in readObject neu aufgebaut werden.

transient verschlüsselt keine Daten und stellt keine Sicherheitsgrenze dar. Eine benutzerdefinierte Methode writeObject kann den Wert des Feldes ausdrücklich schreiben; mit Externalizable kann eine Klasse das Schreiben und Lesen steuern. Gehe auch nicht davon aus, dass andere Serialisierungsmechanismen dieselben Regeln befolgen. Das Beispiel liest nur Bytes ein, die es selbst erstellt hat; das Deserialisieren nicht vertrauenswürdiger Daten ist gefährlich.

Beispiele

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);
    }
}

Ergebnis

42 ready
42 null

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen