Car<\/code> and Engine<\/code> classes both implement Serializable.<\/p>\n\n\n\nThe Serializable interface is a marker interface. That means it’s an interface without any method.<\/p>\n\n\n\n
Your classes only need to implement that interface to be serialized.<\/p>\n\n\n\n
Java Serialization principles<\/h2>\n\n\n\n- An object is serializable if
- It implements Serializable<\/li>
- Its non-primitive fields’ types must also implement Serializable or marked as
transient<\/code><\/li><\/ul><\/li><\/ul>\n\n\n\n- An array is serializable if all elements are serializable<\/li>
- To ignore a field, mark it as
transient<\/code><\/li>- static fields are not serialized<\/li><\/ul>\n\n\n\n
Now, let’s examine these principles with some examples<\/p>\n\n\n\n
Common methods<\/h2>\n\n\n\n
I’m going to reuse the serializeObject<\/code> and deserializeObject<\/code> in the previous post. Here they are for your convenience:<\/p>\n\n\n\n private static void serializeObject(Object object, String name) throws IOException {\n\n try (FileOutputStream outputStream = new FileOutputStream("C:\\\\Users\\\\myn\\\\Downloads\\\\" + name);\n ObjectOutputStream objectOutputStream = new ObjectOutputStream(outputStream);) {\n\n objectOutputStream.writeObject(object);\n }\n }\n\n private static Object deserializeObject(String name) throws IOException, ClassNotFoundException {\n try (FileInputStream fileInputStream = new FileInputStream("C:\\\\Users\\\\myn\\\\Downloads\\\\" + name);\n ObjectInputStream objectInputStream = new ObjectInputStream(fileInputStream);) {\n\n return objectInputStream.readObject();\n }\n }\n<\/pre><\/div>\n\n\n\nTransient<\/h2>\n\n\n\n
Let’s consider a Phone class that has Battery as a field. Phone is serializable but Battery isn’t.<\/p>\n\n\n\n
The Battery class<\/p>\n\n\n\n
class Battery {\n private int capacity;\n\n public int getCapacity() {\n return capacity;\n }\n\n public void setCapacity(int capacity) {\n this.capacity = capacity;\n }\n}<\/pre><\/div>\n\n\n\n<\/p>\n\n\n\n
The Phone class:<\/p>\n\n\n\n
class Phone implements Serializable {\n private Battery battery;\n private String model;\n private String manufacturer;\n\n public Phone(Battery battery, String model, String manufacturer) {\n this.battery = battery;\n this.model = model;\n this.manufacturer = manufacturer;\n }\n\n @Override\n public String toString() {\n return "Phone{" +\n "battery=" + battery +\n ", model='" + model + '\\'' +\n ", manufacturer='" + manufacturer + '\\'' +\n '}';\n }\n}\n<\/pre><\/div>\n\n\n\nLet’s create a phone object and serialize it and store in a file using serializeObject<\/code>:<\/p>\n\n\n\n public static void main(String[] args) throws IOException {\n \n Battery battery = new Battery();\n battery.setCapacity(300);\n \n Phone phone = new Phone(battery, "iFruit 14", "Fruit");\n \n serializeObject(phone, "fruit");\n\n }\n<\/pre><\/div>\n\n\n\nWhat is the result of this operation?<\/p>\n\n\n\n
Exception in thread "main" java.io.NotSerializableException: com.datmt.java_core.serialization.Battery\n\tat java.base\/java.io.ObjectOutputStream.writeObject0(ObjectOutputStream.java:1197)\n\tat java.base\/java.io.ObjectOutputStream.defaultWriteFields(ObjectOutputStream.java:1582)\n\tat java.base\/java.io.ObjectOutputStream.writeSerialData(ObjectOutputStream.java:1539)\n\tat java.base\/java.io.ObjectOutputStream.writeOrdinaryObject(ObjectOutputStream.java:1448)\n\tat java.base\/java.io.ObjectOutputStream.writeObject0(ObjectOutputStream.java:1191)\n\tat java.base\/java.io.ObjectOutputStream.writeObject(ObjectOutputStream.java:354)\n\tat com.datmt.java_core.serialization.TransientExample.serializeObject(TransientExample.java:28)\n\tat com.datmt.java_core.serialization.TransientExample.main(TransientExample.java:19)<\/pre><\/div>\n\n\n\nFrom the log, you can see that basically, it says the class Battery is not serializable. <\/p>\n\n\n\n
If you mark the battery field as transient, the serialize process will work just fine.<\/p>\n\n\n\n
Let’s add transient<\/code> to the battery field and try to serialize and deserialize the phone object again.<\/p>\n\n\n\n<\/p>\n\n\n\n
public static void main(String[] args) throws IOException, ClassNotFoundException {\n\n Battery battery = new Battery();\n battery.setCapacity(300);\n\n Phone phone = new Phone(battery, "iFruit 14", "Fruit");\n\n serializeObject(phone, "fruit");\n\n var phone2 = (Phone) deserializeObject("fruit");\n\n System.out.println(phone2);\n }\n<\/pre><\/div>\n\n\n\nThis is the output:<\/p>\n\n\n\n![\"Serialize](\"https:\/\/datmt.com\/wp-content\/uploads\/2022\/08\/image-41-1024x374.png\")
Serialize and deserialize transient fields<\/figcaption><\/figure>\n\n\n\nAs you can see, the battery field is null. This is expected since it wasn’t serialized in the serialization process. <\/p>\n\n\n\n
Static field serialization<\/h2>\n\n\n\n
As mentioned above, static fields are not serialized. It is because static fields do not belong to any object instance. Instead, the fields belong to the class.<\/p>\n\n\n\n
Enum serialization<\/h2>\n\n\n\n
The enum class implements Serializable. Thus, you don’t need to implement Serializable again for your enums.<\/p>\n\n\n\n
Let’s declare some enums and add them as fields in the Phone class:<\/p>\n\n\n\n
New enums and type:<\/p>\n\n\n\n
\nenum PhoneType {\n FLIP, TOUCH, FOLD;\n\n}\n\nenum ScreenType {\n NOTCH(new Screen("NOTCH")),\n DOT(new Screen("DOT"));\n\n private final Screen type;\n private ScreenType(Screen type) {\n this.type = type;\n }\n\n public Screen getType() {\n return type;\n }\n}\n\nclass Screen {\n private String type;\n public Screen(String type) {\n this.type = type;\n }\n}\n<\/pre><\/div>\n\n\n\nThe Phone class<\/p>\n\n\n\n
class Phone implements Serializable {\n\n private transient Battery battery;\n private String model;\n private String manufacturer;\n\n private PhoneType engineType;\n\n private ScreenType screenType;\n public Phone(Battery battery, String model, String manufacturer) {\n this.battery = battery;\n this.model = model;\n this.manufacturer = manufacturer;\n }\n\n public PhoneType getPhoneType() {\n return engineType;\n }\n\n public void setPhoneType(PhoneType engineType) {\n this.engineType = engineType;\n }\n\n public ScreenType getScreenType() {\n return screenType;\n }\n\n public void setScreenType(ScreenType screenType) {\n this.screenType = screenType;\n }\n\n @Override\n public String toString() {\n return "Phone{" +\n "battery=" + battery +\n ", model='" + model + '\\'' +\n ", manufacturer='" + manufacturer + '\\'' +\n '}';\n }\n}\n<\/pre><\/div>\n\n\n\nAs you can see, PhoneType is a simple enum and ScreenType is a bit more complex with a constructor. <\/p>\n\n\n\n
Let’s create some phones and see how enum serialization\/deserialization works:<\/p>\n\n\n\n
public static void main(String[] args) throws IOException, ClassNotFoundException, NoSuchFieldException {\n\n Battery battery = new Battery();\n\n Phone phone14 = new Phone(battery, "iFruit 14", "Fruit");\n Phone phone13 = new Phone(battery, "iFruit 13", "Fruit");\n\n phone14.setPhoneType(PhoneType.FLIP);\n phone14.setScreenType(ScreenType.DOT);\n\n phone13.setScreenType(ScreenType.DOT);\n\n System.out.println(phone13.getScreenType() == phone14.getScreenType());\n serializeObject(phone14, "phone14");\n serializeObject(phone13, "phone13");\n\n var phone14_restored = (Phone) deserializeObject("phone14");\n var phone13_restored = (Phone) deserializeObject("phone13");\n\n System.out.println(phone14_restored.getPhoneType());\n System.out.println(phone14_restored.getScreenType() == phone13_restored.getScreenType());\n }\n<\/pre><\/div>\n\n\n\nLet’s pay attention to lines 13 and 21. What do you think the results would be?<\/p>\n\n\n\n
You may think line 13 produces true<\/code> and line 21 produces false<\/code>.<\/p>\n\n\n\nThis is the result:<\/p>\n\n\n\n![\"Enum](\"https:\/\/datmt.com\/wp-content\/uploads\/2022\/08\/image-42.png\")
Enum fields serialization<\/figcaption><\/figure>\n\n\n\nAs you can see, after serialization and deserialization, enum fields comparison works as expected. <\/p>\n\n\n\n![\"All](\"https:\/\/datmt.com\/wp-content\/uploads\/2022\/08\/image-43-1024x656.png\")
All enums refer to the same object<\/figcaption><\/figure>\n\n\n\nAs you can see, the ScreenType object of every phone (before and after deserialization) points to the same object. <\/p>\n\n\n\n
Serialization with changes<\/h2>\n\n\n\n
Your programs evolve, and so do your classes. Consider a ComputerMouse class that has the following fields and methods:<\/p>\n\n\n\n
class ComputerMouse implements Serializable {\n private String manufacturer; \n public ComputerMouse(String manufacturer) {\n this.manufacturer = manufacturer;\n }\n\n public String getManufacturer() {\n return manufacturer;\n }\n}<\/pre><\/div>\n\n\n\nLet’s create an instance of this class and save it in a file called old_mouse:<\/p>\n\n\n\n
public static void main(String[] args) throws IOException, ClassNotFoundException, NoSuchFieldException {\n ComputerMouse mouse = new ComputerMouse("Genius");\n\n serializeObject(mouse, "old_mouse");\n }\n<\/pre><\/div>\n\n\n\nLet’s say the class evolves and it now has some new fields and methods:<\/p>\n\n\n\n
class ComputerMouse implements Serializable {\n private String manufacturer;\n private String model;\n public ComputerMouse(String manufacturer, String model) {\n this.manufacturer = manufacturer;\n this.model = model;\n }\n\n public String getModel() {\n return model;\n }\n\n public String getManufacturer() {\n return manufacturer;\n }\n}\n<\/pre><\/div>\n\n\n\nWhat will happen if I deserialize the “old_mouse” and cast to this new class?<\/p>\n\n\n\n
public static void main(String[] args) throws IOException, ClassNotFoundException, NoSuchFieldException {\n\n var mouseRestored = (ComputerMouse) deserializeObject("old_mouse");\n }\n<\/pre><\/div>\n\n\n\nThe deserialization fails and you will see an error message similar to this:<\/p>\n\n\n\n
Exception in thread "main" java.io.InvalidClassException: com.datmt.java_core.serialization.ComputerMouse; local class incompatible: stream classdesc serialVersionUID = -1599228600573436250, local class serialVersionUID = 8005313661126509844\n\tat java.base\/java.io.ObjectStreamClass.initNonProxy(ObjectStreamClass.java:728)\n\tat java.base\/java.io.ObjectInputStream.readNonProxyDesc(ObjectInputStream.java:2062)\n\tat java.base\/java.io.ObjectInputStream.readClassDesc(ObjectInputStream.java:1909)\n\tat java.base\/java.io.ObjectInputStream.readOrdinaryObject(ObjectInputStream.java:2235)\n\tat java.base\/java.io.ObjectInputStream.readObject0(ObjectInputStream.java:1744)\n\tat java.base\/java.io.ObjectInputStream.readObject(ObjectInputStream.java:514)\n\tat java.base\/java.io.ObjectInputStream.readObject(ObjectInputStream.java:472)\n\tat com.datmt.java_core.serialization.TransientExample.deserializeObject(TransientExample.java:31)\n\tat com.datmt.java_core.serialization.TransientExample.main(TransientExample.java:15)\n\nProcess finished with exit code 1<\/pre><\/div>\n\n\n\nIt basically means the serialized object was from a class with a different serial number. <\/p>\n\n\n\n
If you want to make this work, you must get the fingerprint of the old class and set it in the new class or, if you just get started, just set the static, final long variable named serialVersionUID<\/code> to the class.<\/p>\n\n\n\nLet’s switch the class to the old one (without the new fields) then create an instance and serialize it again:<\/p>\n\n\n\n
class ComputerMouse implements Serializable {\n\n public static final long serialVersionUID = 10000L;\n private String manufacturer;\n public ComputerMouse(String manufacturer) {\n this.manufacturer = manufacturer;\n }\n\n\n public String getManufacturer() {\n return manufacturer;\n }\n}\n\npublic static void main(String[] args) throws IOException, ClassNotFoundException, NoSuchFieldException {\n ComputerMouse mouse = new ComputerMouse("Genius");\n serializeObject(mouse, "old_mouse");\n}\n<\/pre><\/div>\n\n\n\nNow, let’s add new fields and methods to the ComputerMouse<\/code> class and deserialize “old_mouse”:<\/p>\n\n\n\nclass ComputerMouse implements Serializable {\n\n public static final long serialVersionUID = 10000L;\n private String manufacturer;\n private String model;\n public ComputerMouse(String manufacturer, String model) {\n this.manufacturer = manufacturer;\n this.model = model;\n }\n\n public String getModel() {\n return model;\n }\n\n public String getManufacturer() {\n return manufacturer;\n }\n}\n\npublic static void main(String[] args) throws IOException, ClassNotFoundException, NoSuchFieldException {\n var mouseRestored = deserializeObject("old_mouse");\n\n assert mouseRestored != null;\n\n}\n<\/pre><\/div>\n\n\n\nThe code ran successfully without any exception.<\/p>\n\n\n\n
![\"Deserialization](\"https:\/\/datmt.com\/wp-content\/uploads\/2022\/08\/image-44-1024x356.png\")