JBR-9713 add a manual test for mouse back and forth buttons

test/jdk/jb/java/awt/mouse/MouseBackForwardButtonsTest.java

@@ -0,0 +1,137 @@
+/*
+ * Copyright 2025 JetBrains s.r.o.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+
+/*
+ * @test
+ * @summary Verifies that if the machine is equipped with mouse then all the buttons were pressed and released
+ * @key headful
+ * @run main/othervm/manual MouseBackForwardButtonsTest
+ */
+
+
+import javax.swing.*;
+import java.awt.*;
+import java.awt.event.MouseAdapter;
+import java.awt.event.MouseEvent;
+import java.awt.event.WindowAdapter;
+import java.awt.event.WindowEvent;
+import java.lang.reflect.InvocationTargetException;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ExecutionException;
+
+
+public class MouseBackForwardButtonsTest extends JFrame {
+    static final CompletableFuture<RuntimeException> swingError = new CompletableFuture<>();
+
+    public static void main(String[] args) throws InterruptedException, InvocationTargetException, ExecutionException {
+        final MouseBackForwardButtonsTest frame;
+        {
+            final CompletableFuture<MouseBackForwardButtonsTest> frameFuture = new CompletableFuture<>();
+            SwingUtilities.invokeAndWait(() -> {
+                try {
+                    final var result = new MouseBackForwardButtonsTest();
+                    result.setVisible(true);
+                    frameFuture.complete(result);
+                } catch (Throwable err) {
+                    frameFuture.completeExceptionally(err);
+                }
+            });
+            frame = frameFuture.get();
+        }
+
+        try {
+            final var err = swingError.get();
+            if (err != null) {
+                throw err;
+            }
+        } finally {
+            if (frame != null) {
+                SwingUtilities.invokeAndWait(frame::dispose);
+            }
+        }
+    }
+
+
+    public MouseBackForwardButtonsTest() {
+        super("Test mouse buttons");
+        setDefaultCloseOperation(HIDE_ON_CLOSE);
+
+        mouseButtonsTextArea = new JTextArea();
+        mouseButtonsTextArea.setLineWrap(true);
+        mouseButtonsTextArea.setWrapStyleWord(true);
+        mouseButtonsTextArea.setText(
+                """
+                INSTRUCTION:
+                  1. Hover mouse cursor over this text area
+                  2. Press each mouse button one by one
+                  3. Verify the accuracy of the displayed information regarding the button pressed.
+                """
+        );
+        mouseButtonsTextArea.addMouseListener(new MouseAdapter() {
+            @Override
+            public void mousePressed(MouseEvent e) {
+                int button = e.getButton();
+                if (button == MouseEvent.BUTTON1) {
+                    mouseButtonsTextArea.append("-->Left mouse button pressed.\n");
+                } else if (button == MouseEvent.BUTTON2) {
+                    mouseButtonsTextArea.append("-->Middle mouse button pressed.\n");
+                } else if (button == MouseEvent.BUTTON3) {
+                    mouseButtonsTextArea.append("-->Right mouse button pressed.\n");
+                } else if (button == 4) { // Check for button 4
+                    mouseButtonsTextArea.append("-->Mouse button 4 (Back) pressed.\n");
+                } else if (button == 5) { // Check for button 5
+                    mouseButtonsTextArea.append("-->Mouse button 5 (Forward) pressed.\n");
+                } else {
+                    mouseButtonsTextArea.append("Other mouse button pressed: " + button + "\n");
+                }
+            }
+        });
+        mouseButtonsTextArea.setEditable(false);
+        add(mouseButtonsTextArea, BorderLayout.CENTER);
+
+        final JPanel southContainer = new JPanel(new BorderLayout());
+        JButton failTestButton = new JButton("FAIL");
+        JButton passTestButton = new JButton("PASS");
+        southContainer.add(failTestButton, BorderLayout.LINE_START);
+        southContainer.add(passTestButton, BorderLayout.LINE_END);
+        add(southContainer, BorderLayout.SOUTH);
+
+        pack();
+        setSize(400, 250);
+        setLocationRelativeTo(null);
+
+        failTestButton.addActionListener(ignored -> swingError.completeExceptionally(new RuntimeException("The tester has pressed FAILED")));
+        passTestButton.addActionListener(ignored -> swingError.complete(null));
+
+        addWindowListener(new WindowAdapter() {
+            @Override
+            public void windowClosing(WindowEvent e) {
+                swingError.completeExceptionally(new RuntimeException("The window was closed not through the \"PASS\"/\"FAIL\" buttons"));
+            }
+        });
+    }
+
+
+    private final JTextArea mouseButtonsTextArea;
+}