OpenJDK 1.23 · java.time.chrono.Ser · APIdia, the JavaDoc alternative

Implementation Note

This class wraps the object being serialized, and takes a byte representing the type of the class to be serialized. This byte can also be used for versioning the serialization format. In this case another byte flag would be used in order to specify an alternative version of the type format. For example CHRONO_TYPE_VERSION_2 = 21

In order to serialize the object it writes its byte and then calls back to the appropriate class where the serialization is performed. In order to deserialize the object it read in the type byte, switching in order to select which class to call back into.

The serialization format is determined on a per class basis. In the case of field based classes each of the fields is written out with an appropriate size format in descending order of the field's size. For example in the case of LocalDate year is written before month. Composite classes, such as LocalDateTime are serialized as one object. Enum classes are serialized using the index of their element.

This class is mutable and should be created once per serialization.

Field Summary

Modifier and Type	Field and Description
pack-priv static final byte	CHRONO_LOCAL_DATE_TIME_TYPE
pack-priv static final byte	CHRONO_PERIOD_TYPE
pack-priv static final byte	CHRONO_TYPE
pack-priv static final byte	CHRONO_ZONE_DATE_TIME_TYPE
pack-priv static final byte	HIJRAH_DATE_TYPE
pack-priv static final byte	JAPANESE_DATE_TYPE
pack-priv static final byte	JAPANESE_ERA_TYPE
pack-priv static final byte	MINGUO_DATE_TYPE
private Serializable	object The object being serialized.
private static final long	serialVersionUID Serialization version.
pack-priv static final byte	THAIBUDDHIST_DATE_TYPE
private byte	type The type being serialized.

Constructor Summary

Access	Constructor and Description
public	Ser() Constructor for deserialization.
pack-priv	Ser(byte the type type, Serializable the object object) Creates an instance for serialization.

Method Summary

Modifier and Type	Method and Description
pack-priv static Serializable	read(ObjectInput in)
public void	readExternal(ObjectInput the data stream to read from, not null in) Implements java.io.Externalizable.readExternal. Implements the `Externalizable` interface to read the object.
private static Serializable	readInternal(byte type, ObjectInput in)
private Object	Returns: the read object, should never be null readResolve() Returns the object that will replace this one.
public void	writeExternal(ObjectOutput the data stream to write to, not null out) Implements java.io.Externalizable.writeExternal. Implements the `Externalizable` interface to write the object.
private static void	writeInternal(byte type, Object object, ObjectOutput out)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

CHRONO_LOCAL_DATE_TIME_TYPE	back to summary
pack-priv static final byte CHRONO_LOCAL_DATE_TIME_TYPE

CHRONO_PERIOD_TYPE	back to summary
pack-priv static final byte CHRONO_PERIOD_TYPE

CHRONO_TYPE	back to summary
pack-priv static final byte CHRONO_TYPE

CHRONO_ZONE_DATE_TIME_TYPE	back to summary
pack-priv static final byte CHRONO_ZONE_DATE_TIME_TYPE

HIJRAH_DATE_TYPE	back to summary
pack-priv static final byte HIJRAH_DATE_TYPE

JAPANESE_DATE_TYPE	back to summary
pack-priv static final byte JAPANESE_DATE_TYPE

JAPANESE_ERA_TYPE	back to summary
pack-priv static final byte JAPANESE_ERA_TYPE

MINGUO_DATE_TYPE	back to summary
pack-priv static final byte MINGUO_DATE_TYPE

object	back to summary
private Serializable object The object being serialized.

serialVersionUID	back to summary
private static final long serialVersionUID Serialization version. Annotations @Serial

THAIBUDDHIST_DATE_TYPE	back to summary
pack-priv static final byte THAIBUDDHIST_DATE_TYPE

type	back to summary
private byte type The type being serialized.

Constructor Detail

Ser	back to summary
public Ser() Constructor for deserialization.

Ser	back to summary
pack-priv Ser(byte type, Serializable object) Creates an instance for serialization. Parameters type:byte the type object:Serializable the object

Ser

back to summary

pack-priv Ser(byte type, Serializable object)

Creates an instance for serialization.

Parameters

type:byte: the type
object:Serializable: the object

Method Detail

read	back to summary
pack-priv static Serializable read(ObjectInput in) throws IOException, ClassNotFoundException

readExternal back to summary

readExternal	back to summary
public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException Implements java.io.Externalizable.readExternal. Implements the `Externalizable` interface to read the object. Parameters in:ObjectInput the data stream to read from, not null Annotations @Override Exceptions IOException: Doc from java.io.Externalizable.readExternal. if I/O errors occur ClassNotFoundException: Doc from java.io.Externalizable.readExternal. If the class for an object being restored cannot be found. Serial data The streamed type and parameters defined by the type's `writeReplace` method are read and passed to the corresponding static factory for the type to create a new instance. That instance is returned as the de-serialized `Ser` object. HijrahChronology - Chronology.of(id) IsoChronology - Chronology.of(id) JapaneseChronology - Chronology.of(id) MinguoChronology - Chronology.of(id) ThaiBuddhistChronology - Chronology.of(id) ChronoLocalDateTime - date.atTime(time) ChronoZonedDateTime - dateTime.atZone(offset).withZoneSameLocal(zone) JapaneseDate - JapaneseChronology.INSTANCE.date(year, month, dayOfMonth) JapaneseEra - JapaneseEra.of(eraValue) HijrahDate - HijrahChronology chrono.date(year, month, dayOfMonth) MinguoDate - MinguoChronology.INSTANCE.date(year, month, dayOfMonth) ThaiBuddhistDate - ThaiBuddhistChronology.INSTANCE.date(year, month, dayOfMonth)

public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException

Implements java.io.Externalizable.readExternal.

Implements the Externalizable interface to read the object.

Parameters

in:ObjectInput: the data stream to read from, not null

Annotations

@Override

Exceptions

IOException:

Doc from java.io.Externalizable.readExternal.

if I/O errors occur

ClassNotFoundException:

Doc from java.io.Externalizable.readExternal.

If the class for an object being restored cannot be found.

Serial data

The streamed type and parameters defined by the type's writeReplace method are read and passed to the corresponding static factory for the type to create a new instance. That instance is returned as the de-serialized Ser object.

HijrahChronology - Chronology.of(id)
IsoChronology - Chronology.of(id)
JapaneseChronology - Chronology.of(id)
MinguoChronology - Chronology.of(id)
ThaiBuddhistChronology - Chronology.of(id)
ChronoLocalDateTime - date.atTime(time)
ChronoZonedDateTime - dateTime.atZone(offset).withZoneSameLocal(zone)
JapaneseDate - JapaneseChronology.INSTANCE.date(year, month, dayOfMonth)
JapaneseEra - JapaneseEra.of(eraValue)
HijrahDate - HijrahChronology chrono.date(year, month, dayOfMonth)
MinguoDate - MinguoChronology.INSTANCE.date(year, month, dayOfMonth)
ThaiBuddhistDate - ThaiBuddhistChronology.INSTANCE.date(year, month, dayOfMonth)

readInternal	back to summary
private static Serializable readInternal(byte type, ObjectInput in) throws IOException, ClassNotFoundException

readResolve	back to summary
private Object readResolve() Returns the object that will replace this one. Returns:Object the read object, should never be null Annotations @Serial

readResolve

back to summary

private Object readResolve()

Returns the object that will replace this one.

Returns:Object

the read object, should never be null

Annotations

@Serial

writeExternal back to summary

writeExternal	back to summary
public void writeExternal(ObjectOutput out) throws IOException Implements java.io.Externalizable.writeExternal. Implements the `Externalizable` interface to write the object. Parameters out:ObjectOutput the data stream to write to, not null Annotations @Override Exceptions IOException: Doc from java.io.Externalizable.writeExternal. Includes any I/O exceptions that may occur Serial data Each serializable class is mapped to a type that is the first byte in the stream. Refer to each class `writeReplace` serialized form for the value of the type and sequence of values for the type. HijrahChronology.writeReplace IsoChronology.writeReplace JapaneseChronology.writeReplace MinguoChronology.writeReplace ThaiBuddhistChronology.writeReplace ChronoLocalDateTime.writeReplace ChronoZonedDateTime.writeReplace JapaneseDate.writeReplace JapaneseEra.writeReplace HijrahDate.writeReplace MinguoDate.writeReplace ThaiBuddhistDate.writeReplace

public void writeExternal(ObjectOutput out) throws IOException

Implements java.io.Externalizable.writeExternal.

Implements the Externalizable interface to write the object.

Parameters

out:ObjectOutput: the data stream to write to, not null

Annotations

@Override

Exceptions

IOException:

Doc from java.io.Externalizable.writeExternal.

Includes any I/O exceptions that may occur

Serial data

Each serializable class is mapped to a type that is the first byte in the stream. Refer to each class writeReplace serialized form for the value of the type and sequence of values for the type.

writeInternal	back to summary
private static void writeInternal(byte type, Object object, ObjectOutput out) throws IOException

pack-priv final Class Ser

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail