Java Swing如何实现不受控件焦点影响捕获全部键盘输入

需求说明 #

Java Swing开发场景下，需要在窗口处于激活状态时捕获所有类型的键盘输入，包括字母、数字、功能键等所有按键，且不受当前焦点控件的限制，无论哪个控件持有焦点，都能触发回调执行自定义输入处理逻辑。

初始实现与故障表现 #

最初尝试给面板绑定实现了java.awt.event.KeyListener接口的监听器，代码如下：

// MainApplicationWindow.java
// ...
mPanel.addKeyListener(
    new SwingKeyListener()
);

监听器实现代码：

// SwingKeyListener.java
public class SwingKeyListener implements KeyListener {

    @Override
    public void keyTyped(KeyEvent e) {/*...*/}

    @Override
    public void keyPressed(KeyEvent e) {/*...*/}

    @Override
    public void keyReleased(KeyEvent e) {/*...*/}
}

运行后GUI正常显示，无任何错误或异常输出，但KeyListener完全不触发，没有生效。
故障原因：KeyListener仅在绑定的组件本身持有焦点时才能接收键盘事件，当窗口内其他控件（如按钮、输入框）获得焦点后，面板的KeyListener就无法接收到事件，因此不能实现全局键盘捕获的需求。

最终解决方案 #

使用KeyEventPostProcessor轮询输入即可实现不受焦点限制的全局键盘捕获，实现代码如下：

KeyEventPostProcessor pp = e -> {
    SwingKeyListener.keyPressed(e);
    return true;
};
DefaultKeyboardFocusManager.getCurrentKeyboardFocusManager().addKeyEventPostProcessor(pp);

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