-
Bug
-
Resolution: Unresolved
-
P4
-
6, 7, 8
-
None
The java.util.EnumSet class is serializable. It uses the serialization proxy pattern, so if an EnumSet instance is serialized, a serialized instance of EnumSet.SerializationProxy is emitted to the serialized bytestream. Serialized instances of actual EnumSets never occur in a normal serialized bytestream, and if someone were to concoct one and deserialize it, EnumSet prevents it from being deserialized.
EnumSet has "@serial exclude" in its javadoc, so no link to the Serialized Form html page exists. However, there is an "orphan" entry for EnumSet.SerializationProxy on the serialized form page, and it describes reasonably accurately what is actually serialized. Unfortunately there is no connection between the EnumSet javadoc specification and the EnumSet.SerializationProxy serialized form.
This needs to be fixed, and a convention established for how a logical linkage ought to be established between a class and its serialization proxy. Enhancements to javadoc in support of this should also be considered.
EnumSet has "@serial exclude" in its javadoc, so no link to the Serialized Form html page exists. However, there is an "orphan" entry for EnumSet.SerializationProxy on the serialized form page, and it describes reasonably accurately what is actually serialized. Unfortunately there is no connection between the EnumSet javadoc specification and the EnumSet.SerializationProxy serialized form.
This needs to be fixed, and a convention established for how a logical linkage ought to be established between a class and its serialization proxy. Enhancements to javadoc in support of this should also be considered.
- relates to
-
JDK-5075463 (enum) Serialized Form javadoc for java.lang.Enum is misleading
-
- Closed
-