jmx-dev RFR: 8369736 - Add management interface for AOT cache creation

[Mat Carter]

On Tue, 28 Oct 2025 09:51:18 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> Add jdk.management.AOTCacheMXBean. The interface provides a single action that when called will cause any hosted JVM currently recording AOT information will stop recording. Existing functionality is preserved: when stopped the JVM will create the required artifacts based on the execution mode. Conveniently as the application running on the JVM has not stopped (as was previously the only way to stop recording), the application will resume execution after the artifacts have been generated.
>> 
>> The interface will return TRUE if a recording was successfully stopped, in all other cases (not recording etc.) will return FALSE
>> 
>> It follows that invoking the action on a JVM that is recording, twice in succession, should (baring internal errors) produce the following two responses:
>> 
>> TRUE
>> FALSE
>> 
>> Passes tier1 on linux (x64) and windows (x64)
>
> src/jdk.management/share/classes/jdk/management/HotSpotAOTCacheMXBean.java line 107:
> 
>> 105:        *
>> 106:        * @return {@code true} if a recording was in progress and has been ended successfully; {@code false} otherwise.
>> 107:        */
> 
> There are issues in the javadoc that will cause the docs target to fail, e.g. mismatched blockquote.  Can you fix these up so that we can generate the docs from the changes in the PR?

Is there an easy way to test the correctness of the javadoc parts (I couldn't find an option for javadoc).  The </blockquote \>above is matched to a <blockquote\> on line 88, but there is a <pre\></pre\> pair in between, is that the issue you are referring to?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/28010#discussion_r2470535787