[crac] Integrated: Backout new API to sync with Reference Handler

[Anton Kozlov]

On Thu, 10 Nov 2022 15:34:23 GMT, Anton Kozlov <akozlov at openjdk.org> wrote:

> This reverts commit 9cf1995693eead85d3807fb4c83ab38c14e27042 and makes #22 obsolete. 
> 
> The API introduced in 9cf1995693eead85d3807fb4c83ab38c14e27042 (waitForWaiters) and changed in #22 waits for the state when all discovered references are processed. So WaitForWaiters is used to implement predictable Reference Handling, ensuring that clean-up actions have fired for an object after it becomes unreachable.
> 
> I think that API was a mistake and should be reverted.
> 
> In general, the problem of predictable Reference Handling is independent of CRaC. So I thought about extracting that out of CRaC and found a few issues with the approach. A user needs to know what RefQueue gets References after an object becomes unreachable, to call waitForWaiters on that queue. The queue is not necessarily evident, so a deep understanding of refs and queues in an application is required to select the proper queue to wait on, and to build the right order of them to wait on. Also, it's required somehow to know the number of threads servicing a queue. And there are situations when waitForWaiters may report that all refs are processed, but some of them are not -- consider a thread that is polling a queue and gets refs to be processed but then buffers them in another queue for later, in this example waitForWaiters does not provide the guarantee that corresponding clean-up actions were performed.
> 
> The common and more straightforward way to have predictable clean-up is to call an explicit method like close()/release()/cleanup() that performs object-specific clean-up actions predictably.

This pull request has now been integrated.

Changeset: ccf33231
Author:    Anton Kozlov <akozlov at openjdk.org>
URL:       https://git.openjdk.org/crac/commit/ccf33231110c8e8dd3c47bae0a079d25a34ac8b5
Stats:     53 lines in 2 files changed: 19 ins; 32 del; 2 mod

Backout new API to sync with Reference Handler

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

PR: https://git.openjdk.org/crac/pull/34