On Sun, 10 Oct 2021 20:25:43 GMT, Joe Darcy <da...@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 <da...@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