RFR: 8377950: Refactor ClassUnloader to provide explicit waiting API [v3]

[Albert Mingkun Yang]

On Tue, 17 Feb 2026 20:18:04 GMT, Albert Mingkun Yang <ayang at openjdk.org> wrote:

>> Separates GC triggering from class reclamation waiting in vmTestbase ClassUnloader.
>> 
>> The original implementation used an implicit wait loop regardless of caller needs. Because the necessity of waiting is caller-specific, this PR introduces an explicit `unloadClassAndWait(timeout)` API. This allows callers to document their specific reasons for waiting (e.g., race conditions with JDWP or background compilation) while keeping `unloadClass()` simple for those who don't need to wait.
>> 
>> - Introduced `unloadClassAndWait(timeout)` and simplified `unloadClass()`.
>> - Updated `compmethunload001` and `AbstractDebuggeeTest` to use the explicit waiting API with documented rationale.
>> 
>> Test: tier1-5, `vmTestbase/nsk`
>
> Albert Mingkun Yang has updated the pull request incrementally with two additional commits since the last revision:
> 
>  - Update test/hotspot/jtreg/vmTestbase/nsk/share/jpda/AbstractDebuggeeTest.java
>    
>    Co-authored-by: Chris Plummer <chris.plummer at oracle.com>
>  - Update test/hotspot/jtreg/vmTestbase/nsk/share/jpda/AbstractDebuggeeTest.java
>    
>    Co-authored-by: Chris Plummer <chris.plummer at oracle.com>

Thanks for review.

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

PR Comment: https://git.openjdk.org/jdk/pull/29735#issuecomment-3919978010