Integrated: 8275013: Improve discussion of serialization method declarations in java.io.Object{Input, Output}Stream

[Joe Darcy]

On Sun, 10 Oct 2021 20:25:43 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> The java.io.ObjectInputStream and java.io.ObjectOuputStream classes are part of the serialization feature. These classes contain brief descriptions of some of the methods serializable classes can define to interact with the serialization mechanism, readObject, readObjectNoData, and writeObject. These descriptions are not entirely consistent with one another and at least one is arguably misleading.
> 
> This PR makes the brief discussion the same in both classes and addresses the misleading point: the throws clauses of the methods will not effect whether or not the methods are found by serialization, but throwing unchecked exceptions not declared in the standard signatures is ill-advised. (The current implementation looks up the methods by name using core reflection; the method modifiers are checked to match but the throws information is not.)
> 
> Please also review the corresponding CSR : https://bugs.openjdk.java.net/browse/JDK-8275014

This pull request has now been integrated.

Changeset: 8c4da9c1
Author:    Joe Darcy <darcy at openjdk.org>
URL:       https://git.openjdk.java.net/jdk/commit/8c4da9c15fec7bd27e243e9a6c9ebcad63109506
Stats:     18 lines in 2 files changed: 13 ins; 0 del; 5 mod

8275013: Improve discussion of serialization method declarations in java.io.Object{Input, Output}Stream

Reviewed-by: smarks, rriggs

-------------

PR: https://git.openjdk.java.net/jdk/pull/5883