RFR: 8351565: Implement JEP 502: Stable Values (Preview) [v74]

[Per Minborg]

On Wed, 23 Apr 2025 12:04:45 GMT, Viktor Klang <vklang at openjdk.org> wrote:

>> Per Minborg has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 365 commits:
>> 
>>  - Replace 'content' with 'contents' and doc updates
>>  - Merge branch 'master' into implement-jep502
>>  - Remove section on fun/coll sync
>>  - Reformat docs
>>  - Fix failing test (exception message)
>>  - Rework relayed to rethrown
>>  - Fix copyright related issues
>>  - Fix rawtype problem
>>  - Fix build problem
>>  - Resolve merge problem
>>  - ... and 355 more: https://git.openjdk.org/jdk/compare/27faf454...ac6accd8
>
> src/java.base/share/classes/java/lang/StableValue.java line 119:
> 
>> 117:  * The {@code getLogger()} method calls {@code logger.orElseSet()} on the stable value to
>> 118:  * retrieve its contents. If the stable value is <em>unset</em>, then {@code orElseSet()}
>> 119:  * evaluates the given supplier, and sets the contents to the result; the contents is then
> 
> @minborg Technically, isn't the *result* returned to the client (after setting it as the contents).

Yeah. I will update that, even though it might be an academic question.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23972#discussion_r2055905141