基于JNativeHook：如何实现点击按钮后监听按键并自动更新热键标签？

问题说明 #

使用JNativeHook监听系统原生按键，想要实现：点击按钮后等待用户按下一个原生按键，将该按键设为新热键并更新对应标签。但当前实现存在问题：点击按钮后按下按键，还需再次点击按钮才能更新标签，不符合预期。

原代码实现：

import com.github.kwhat.jnativehook.GlobalScreen;
import com.github.kwhat.jnativehook.NativeHookException;
import com.github.kwhat.jnativehook.keyboard.NativeKeyEvent;
import com.github.kwhat.jnativehook.keyboard.NativeKeyListener;
import com.github.kwhat.jnativehook.mouse.NativeMouseInputListener;
import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.animation.AnimationTimer;

public class HotKeyWindowController implements NativeKeyListener {
    @FXML
    private Label stopHotKeyLabel;
    @FXML
    private Label startHotKeyLabel;
    @FXML
    private Button stopHotKeyButton;
    @FXML
    private Button startHotKeyButton;
    private static String startKey = "F1";
    private static String stopKey = "F3";
    private static String key;


    public void nativeKeyPressed(NativeKeyEvent e) {
        key = NativeKeyEvent.getKeyText(e.getKeyCode());
    }

    public void stopHotKeyButtonClicked(ActionEvent actionEvent) {
        GlobalScreen.removeNativeKeyListener(new HelloApplication());
        GlobalScreen.addNativeKeyListener(new HotKeyWindowController());
        stopKey = key;
        stopHotKeyLabel.setText("Stop HotKey: " + stopKey);
        GlobalScreen.addNativeKeyListener(new HelloApplication());
        GlobalScreen.removeNativeKeyListener(new HotKeyWindowController());
    }

    public void startHotKeyButtonClicked(ActionEvent actionEvent) {

    }
}

问题分析 #

1. 实例不统一：点击按钮时创建了新的HotKeyWindowController实例作为监听器，这个新实例捕获的按键值不会同步到当前控制器的key变量，导致当前控制器的key还是旧值。
2. 逻辑顺序错误：按钮点击时直接给stopKey赋值，此时用户还未按下按键，key并未更新；后续添加的监听器捕获按键后，当前控制器也无法获取到新值，必须再次点击按钮才会用上一次的key。
3. 监听器操作混乱：反复添加/移除不同实例的监听器，不仅没用，还会导致监听逻辑混乱。

修复后的代码 #

import com.github.kwhat.jnativehook.GlobalScreen;
import com.github.kwhat.jnativehook.NativeHookException;
import com.github.kwhat.jnativehook.keyboard.NativeKeyEvent;
import com.github.kwhat.jnativehook.keyboard.NativeKeyListener;
import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.scene.control.Button;
import javafx.scene.control.Label;

public class HotKeyWindowController implements NativeKeyListener {
    @FXML
    private Label stopHotKeyLabel;
    @FXML
    private Label startHotKeyLabel;
    @FXML
    private Button stopHotKeyButton;
    @FXML
    private Button startHotKeyButton;

    private String startKey = "F1";
    private String stopKey = "F3";
    // 标记当前是否处于等待设置热键的状态
    private boolean isWaitingForStartHotKey = false;
    private boolean isWaitingForStopHotKey = false;

    // 初始化方法，注册当前实例为全局按键监听器
    public void initialize() {
        try {
            GlobalScreen.registerNativeHook();
            GlobalScreen.addNativeKeyListener(this);
        } catch (NativeHookException ex) {
            System.err.println("注册全局钩子失败: " + ex.getMessage());
            ex.printStackTrace();
        }
    }

    @Override
    public void nativeKeyPressed(NativeKeyEvent e) {
        String pressedKey = NativeKeyEvent.getKeyText(e.getKeyCode());
        
        // 如果正在等待设置start热键
        if (isWaitingForStartHotKey) {
            startKey = pressedKey;
            startHotKeyLabel.setText("Start HotKey: " + startKey);
            isWaitingForStartHotKey = false;
            startHotKeyButton.setText("设置Start热键");
        } 
        // 如果正在等待设置stop热键
        else if (isWaitingForStopHotKey) {
            stopKey = pressedKey;
            stopHotKeyLabel.setText("Stop HotKey: " + stopKey);
            isWaitingForStopHotKey = false;
            stopHotKeyButton.setText("设置Stop热键");
        }
    }

    @Override
    public void nativeKeyReleased(NativeKeyEvent e) {
        // 不需要处理释放事件，可留空
    }

    @Override
    public void nativeKeyTyped(NativeKeyEvent e) {
        // 不需要处理输入事件，可留空
    }

    public void stopHotKeyButtonClicked(ActionEvent actionEvent) {
        // 切换等待状态，更新按钮提示
        isWaitingForStopHotKey = !isWaitingForStopHotKey;
        if (isWaitingForStopHotKey) {
            stopHotKeyButton.setText("请按下要设置的按键...");
            // 确保不同时等待两个热键设置
            isWaitingForStartHotKey = false;
            startHotKeyButton.setText("设置Start热键");
        } else {
            stopHotKeyButton.setText("设置Stop热键");
        }
    }

    public void startHotKeyButtonClicked(ActionEvent actionEvent) {
        // 切换等待状态，更新按钮提示
        isWaitingForStartHotKey = !isWaitingForStartHotKey;
        if (isWaitingForStartHotKey) {
            startHotKeyButton.setText("请按下要设置的按键...");
            // 确保不同时等待两个热键设置
            isWaitingForStopHotKey = false;
            stopHotKeyButton.setText("设置Stop热键");
        } else {
            startHotKeyButton.setText("设置Start热键");
        }
    }

    // 销毁时注销钩子，避免内存泄漏
    public void shutdown() {
        try {
            GlobalScreen.unregisterNativeHook();
        } catch (NativeHookException ex) {
            System.err.println("注销全局钩子失败: " + ex.getMessage());
            ex.printStackTrace();
        }
    }
}

关键改动说明 #

1. 状态标记变量：添加isWaitingForStartHotKey和isWaitingForStopHotKey，标记当前是否处于等待用户按键设置热键的状态。
2. 统一监听器实例：初始化时注册当前控制器实例为全局按键监听器，不再创建新实例，确保按键事件能直接传递到当前控制器。
3. 按钮逻辑简化：点击按钮仅切换等待状态，并更新按钮文本提示用户操作，无需反复添加/移除监听器。
4. 按键事件处理：在nativeKeyPressed中根据当前等待状态，直接更新对应热键和标签，完成后重置状态。
5. 完善生命周期：添加shutdown方法，在控制器销毁时注销全局钩子，避免内存泄漏。

内容的提问来源于stack exchange，提问作者Leo