On Mon, 29 Apr 2024 21:17:24 GMT, Brent Christian <bchri...@openjdk.org> wrote:

>> Classes in the `java.lang.ref` package would benefit from an update to bring 
>> the spec in line with how the VM already behaves. The changes would focus on 
>> _happens-before_ edges at some key points during reference processing.
>> 
>> A couple key things we want to be able to say are:
>> - `Reference.reachabilityFence(x)` _happens-before_ reference processing 
>> occurs for 'x'.
>> - `Cleaner.register()` _happens-before_ the Cleaner thread runs the 
>> registered cleaning action.
>> 
>> This will bring Cleaner in line (or close) with the memory visibility 
>> guarantees made for finalizers in [JLS 
>> 17.4.5](https://docs.oracle.com/javase/specs/jls/se18/html/jls-17.html#jls-17.4.5):
>> _"There is a happens-before edge from the end of a constructor of an object 
>> to the start of a finalizer (ยง12.6) for that object."_
>
> Brent Christian has updated the pull request incrementally with one 
> additional commit since the last revision:
> 
>   small grammar fixes

src/java.base/share/classes/java/lang/ref/Cleaner.java line 224:

> 222:      * Actions in a thread prior to calling {@code Cleaner.register()}
> 223:      * <a 
> href="{@docRoot}/java.base/java/util/concurrent/package-summary.html#MemoryVisibility"><i>happen-before</i></a>
> 224:      * the cleaning action is run by the Cleaner's thread.

In passing, you could reduces the html refs to 
"package-summary.html#MemoryConsistency" and 
"package-summary.html#MemoryVisibility" as it's the same package/directory.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/16644#discussion_r1593641111

Reply via email to