Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

transient — vyloučení pole z výchozí serializace

Klíčové slovo transient vylučuje pole z implicitního seznamu serializovatelných polí v Javě. Pokud je pole vynecháno, po načtení běžného objektu Serializable si zachová výchozí hodnotu, pokud mu obnovovací kód nepřiřadí jinou.

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

Syntaxe

transient Type fieldName;

transient je vyhrazené klíčové slovo a modifikátor pole, nikoli modifikátor metod, parametrů nebo lokálních proměnných. Označuje, že pole není součástí trvalého stavu objektu. Samotný modifikátor nezajišťuje serializovatelnost třídy; standardní serializace objektů vyžaduje Serializable.

Implicitní seznam serializovatelných polí zahrnuje instanční pole, která nejsou static ani transient. Pole private se automaticky nevynechává. Pole označená jako static patří třídě, takže je není třeba označovat jako transient, aby byla z tohoto seznamu vyloučena. Třída může implicitní seznam nahradit platnou deklarací serialPersistentFields. ObjectOutputStream použije při výchozím zápisu stavu deklarovaný seznam, i když třída nedefinuje vlastní metodu writeObject.

Při deserializaci běžné třídy Serializable se nespustí její konstruktor ani inicializátory instančních polí. Bez dalšího obnovovacího kódu si vynechané pole zachová výchozí hodnotu svého typu, například null, 0 nebo false. V příkladu má tedy cache po načtení hodnotu null, nikoli "ready", zatímco score si zachová 42. V případě potřeby lze mezipaměť znovu vytvořit v readObject.

transient data nešifruje a nepředstavuje bezpečnostní hranici. Vlastní metoda writeObject může hodnotu pole výslovně zapsat a Externalizable umožňuje třídě řídit zápis i čtení. Nepředpokládejte také, že jiné mechanismy serializace dodržují stejná pravidla. Příklad čte pouze bajty, které sám vytvořil; deserializace nedůvěryhodných dat je nebezpečná.

Příklady

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

Výsledek

42 ready
42 null

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje