On Fri, 29 Aug 2025 00:24:01 GMT, Damon Nguyen <[email protected]> wrote:

>> Some useful methods (click, glide, waitForIdle, type) in ExtendedRobot 
>> should be migrated into Robot itself so that ExtendedRobot can be removed in 
>> the future. The tests using these ExtendedRobot methods will be handled 
>> separately.
>
> Damon Nguyen has updated the pull request incrementally with one additional 
> commit since the last revision:
> 
>   Add finally block

src/java.desktop/share/classes/java/awt/Robot.java line 792:

> 790:     /**
> 791:      * A convenience method that simulates clicking a mouse button by 
> calling {@code mousePress}, {@code mouseRelease},
> 792:      * and {@code waitForIdle}. Invokes {@code waitForIdle} with a 
> default delay of 20 milliseconds after

Suggestion:

     * and {@code waitForIdle}. Invokes {@code waitForIdle} with a default 
delay of {@value #DEFAULT_STEP_DELAY} milliseconds after

This renders `20` as a link that links to the constant that users can use.

src/java.desktop/share/classes/java/awt/Robot.java line 855:

> 853:      *
> 854:      * @implSpec Invokes {@link #mouseMove(int, int) mouseMove} with a 
> default
> 855:      * {@link #DEFAULT_STEP_LENGTH step-length} and {@link 
> #DEFAULT_STEP_DELAY step-delay}.

You can use:

     * @implSpec Invokes {@link #mouseMove(int, int) mouseMove} with a 
step-length
     * of {@value #DEFAULT_STEP_LENGTH} and a step-delay of {@value 
#DEFAULT_STEP_DELAY}.


Renders like:

> Invokes [`mouseMove`]() with a step-length of [`2`]() and a a step-delay of 
> [`20`]().

Same for other sites.

src/java.desktop/share/classes/java/awt/Robot.java line 977:

> 975:     public synchronized void type(int keycode) {
> 976:         keyPress(keycode);
> 977:         waitForIdle(20);

Should this use `DEFAULT_STEP_DELAY` too?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/26969#discussion_r2320487184
PR Review Comment: https://git.openjdk.org/jdk/pull/26969#discussion_r2320510533
PR Review Comment: https://git.openjdk.org/jdk/pull/26969#discussion_r2320511282

Reply via email to