Kad ir kad būtu jāmaina serialVersionUID lauka vērtība?

serialVersionUID vērtība jāmaina, ja nesaderīgas izmaiņas serializējamās klases struktūrā tiek veiktas. Tas nozīmē, ka izmaiņas bojā sērijveida datu formāta atbilstību:

Šādas izmaiņas ietver:

• lauku dzēšanu
• lauka tipa maiņu
• static vai transient modifikatoru maiņu laukiem
• klases hierarhijas maiņu (pievienojot vai noņemot vecāku klases)
• standarta serializācijas metožu (readObject, writeObject, readResolve, writeReplace) maiņu vai noņemšanu

serialVersionUID maiņa skaidri norāda JVM, ka ielādētie serializētie dati attiecas uz vecāku klases versiju un nav saderīgi ar pašreizējo, novēršot InvalidClassException. Ja serialVersionUID netiek mainīts, JVM uzskatīs klases versijas par saderīgām, kas var novest pie nepareizas uzvedības vai kļūdām deserializācijas laikā, jo struktūras nesakrīt:

Dažas izmaiņas parasti neprasa serialVersionUID maiņu (ja tās neietekmē standarta serializācijas metodes):

• jaunu lauku pievienošanu (ja tie nav final)
• metožu pievienošanu vai noņemšanu
• piekļuves modifikatoru maiņu lauciņiem (izņemot static un transient)

Ieteicams skaidri norādīt serialVersionUID serializējamās klasēs. Tas ļauj kontrolēt versiju saderību. Ja šī lauka nav, JVM to ģenerēs, balstoties uz klases īpašībām, kas var radīt saderības problēmas nelielu izmaiņu gadījumā, kas tomēr maina ID ģenerēšanas algoritmu:

Piemērs:

public class MySerializableClass implements java.io.Serializable {
    private static final long serialVersionUID = 1L; // sākotnējā vērtība
    private String someField;

    // ... citas lauki un metodes
}

Ja klases izmaiņas ir nesaderīgas, serialVersionUID vērtību vajadzētu mainīt, piemēram, izmantojot serialver rīku ģenerētu vērtību vai palielinot (2L).