On Fri, 26 Jun 2026 15:43:09 GMT, Alan Bateman <[email protected]> wrote:
> Updates to java.lang.Object API docs: > > - Improve preview-comment in class description that defines value class and > value object > - Update spec for the finalize method to make it clear when finalize method > of a value class is never invoked by the garbage collector > - Update the implSpec for the clone to specify behavior of Object.clone for > value objects. Also add paragraph to method description for value objects, > and add API note to advise using copy constructors or static factory methods > instead > - Improve preview-comment in wait/notify methods and drop confusing addition > to IMSE exception > > A sanity test is added, this depends on the fix to finalizer registration in > pull/2589. > > --------- > - [x] I confirm that I make this contribution in accordance with the [OpenJDK > Interim AI Policy](https://openjdk.org/legal/ai). src/java.base/share/classes/java/lang/Object.java line 40: > 38: * When preview features are enabled, subclasses of {@code > java.lang.Object} > 39: * are either {@linkplain Class#isValue value classes} or > identity classes. > 40: * A <em>value object</em> is an instance of a non-abstract > value class. All Hello Alan, in several other places in the other JDK, we seem to refer to such classes as concrete value class. Should we do the same here instead of saying non-abstract value class? ------------- PR Review Comment: https://git.openjdk.org/valhalla/pull/2588#discussion_r3496836489
