archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 06:45:07 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

4958969: ObjectOutputStream example leads to non-working code

Browse source 
Reviewed-by: lancea, naoto
This commit is contained in:
Roger Riggs 2022-12-19 23:10:30 +00:00
parent f07acfc166
commit d0a7679d2e
3 changed files with 58 additions and 60 deletions
Download patch file Download diff file Expand all files Collapse all files

46
src/java.base/share/classes/java/io/ObjectInputStream.java
View file

@ -116,18 +116,18 @@ import sun.security.action.GetIntegerAction;
* the object's most specific class.
*
* <p>For example to read from a stream as written by the example in
* ObjectOutputStream:
* {@link ObjectOutputStream}:
* <br>
* <pre>
* FileInputStream fis = new FileInputStream("t.tmp");
* ObjectInputStream ois = new ObjectInputStream(fis);
*
* int i = ois.readInt();
* String today = (String) ois.readObject();
* Date date = (Date) ois.readObject();
*
* ois.close();
* </pre>
* {@snippet lang="java" :
* try (FileInputStream fis = new FileInputStream("t.tmp");
* ObjectInputStream ois = new ObjectInputStream(fis)) {
* String label = (String) ois.readObject();
* LocalDateTime dateTime = (LocalDateTime) ois.readObject();
* // Use label and dateTime
* } catch (Exception ex) {
* // handle exception
* }
* }
*
* <p>Classes control how they are serialized by implementing either the
* java.io.Serializable or java.io.Externalizable interfaces.
@ -142,14 +142,14 @@ import sun.security.action.GetIntegerAction;
* serialization and deserialization process should implement methods
* with the following signatures:
*
* <pre>
* private void writeObject(java.io.ObjectOutputStream stream)
* throws IOException;
* private void readObject(java.io.ObjectInputStream stream)
* throws IOException, ClassNotFoundException;
* private void readObjectNoData()
* throws ObjectStreamException;
* </pre>
* {@snippet lang="java":
* private void writeObject(java.io.ObjectOutputStream stream)
* throws IOException;
* private void readObject(java.io.ObjectInputStream stream)
* throws IOException, ClassNotFoundException;
* private void readObjectNoData()
* throws ObjectStreamException;
* }
*
* <p>The method name, modifiers, return type, and number and type of
* parameters must match exactly for the method to be used by
@ -771,9 +771,9 @@ public class ObjectInputStream
*
* <p>The default implementation of this method in
* {@code ObjectInputStream} returns the result of calling
* <pre>
* {@snippet lang="java":
* Class.forName(desc.getName(), false, loader)
* </pre>
* }
* where {@code loader} is the first class loader on the current
* thread's stack (starting from the currently executing method) that is
* neither the {@linkplain ClassLoader#getPlatformClassLoader() platform
@ -833,9 +833,9 @@ public class ObjectInputStream
* objects for the interfaces that are named in the {@code interfaces}
* parameter. The {@code Class} object for each interface name
* {@code i} is the value returned by calling
* <pre>
* {@snippet lang="java":
* Class.forName(i, false, loader)
* </pre>
* }
* where {@code loader} is the first class loader on the current
* thread's stack (starting from the currently executing method) that is
* neither the {@linkplain ClassLoader#getPlatformClassLoader() platform