Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

transient — pomijanie pola w domyślnej serializacji

Słowo kluczowe transient wyklucza pole z niejawnej listy pól serializowanych w Javie. Jeśli pole zostanie pominięte, po odczycie zwykłego obiektu Serializable zachowuje wartość domyślną, o ile kod odtwarzający nie przypisze mu innej.

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

Składnia

transient Type fieldName;

transient jest zastrzeżonym słowem kluczowym i modyfikatorem pola, a nie metody, parametru ani zmiennej lokalnej. Oznacza, że pole nie należy do trwałego stanu obiektu. Sam modyfikator nie sprawia, że klasa staje się serializowalna; standardowy mechanizm serializacji obiektów wymaga Serializable.

Niejawna lista pól serializowanych obejmuje pola instancji, które nie są static ani transient. Pole private nie jest automatycznie pomijane. Pola static należą do klasy, więc nie trzeba oznaczać ich jako transient, aby wyłączyć je z tej listy. Klasa może zastąpić tę listę poprawną deklaracją serialPersistentFields. ObjectOutputStream używa wtedy zadeklarowanej listy przy domyślnym zapisie stanu, nawet jeśli klasa nie definiuje własnej metody writeObject.

Podczas deserializacji zwykłej klasy Serializable jej konstruktor i inicjalizatory pól instancji nie są wykonywane. Bez dodatkowego kodu odtwarzającego pominięte pole pozostaje z wartością domyślną typu, np. null, 0 lub false. Dlatego w przykładzie cache po odczycie ma wartość null, a nie "ready"; score zachowuje 42. W razie potrzeby można odtworzyć pamięć podręczną w readObject.

transient nie szyfruje danych i nie jest granicą bezpieczeństwa. Własna metoda writeObject może jawnie zapisać wartość takiego pola, a Externalizable pozwala klasie sterować zapisem i odczytem. Nie zakładaj też, że inne mechanizmy serializacji stosują te same reguły. Przykład odczytuje wyłącznie bajty utworzone przez siebie; deserializacja niezaufanych danych jest niebezpieczna.

Przykłady

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

Wynik

42 ready
42 null

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła