如何在同一Java程序中实现MouseListener、MouseMotionListener与KeyListener？

我有一个可响应鼠标点击和移动的Java Swing程序，运行正常，代码如下：

import javax.swing.*;
import java.awt.event.*;
public class Z_MouseAndMotionListener extends JPanel  {
  public Z_MouseAndMotionListener() {
     Mouse m = new Mouse();
     addMouseListener(m);
     addMouseMotionListener(m);
  }
  class Mouse implements  MouseListener, MouseMotionListener{
     public void mousePressed(MouseEvent e) {
        System.out.println("Pressed");
 }
 public void mouseMoved(MouseEvent e) {
    System.out.println("Moved");
 }
 public void mouseDragged(MouseEvent e) {}
 public void mouseClicked(MouseEvent e) {}
 public void mouseEntered(MouseEvent e) {}
 public void mouseExited(MouseEvent e) {}
 public void mouseReleased(MouseEvent e) {}
 }
 public static void main(String[] args) {
 JFrame frame = new JFrame();
 frame.setSize(500, 500);
 frame.setLocationRelativeTo(null);
 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
 frame.setContentPane(new Z_MouseAndMotionListener());
 frame.setVisible(true);
 }
 } 

尝试添加键盘监听功能后，修改代码如下：

import javax.swing.*;
import java.awt.event.*;
public class Z_MouseAndMotionListener1 extends JPanel {
public Z_MouseAndMotionListener1() {
 Mouse m = new Mouse();
 addMouseListener(m);
 addMouseMotionListener(m);
 }
 class Mouse implements MouseListener, MouseMotionListener{
 public void mousePressed(MouseEvent e) {
    System.out.println("Pressed");
 }
 public void mouseMoved(MouseEvent e) {
    System.out.println("Moved");       
 }
 public void mouseDragged(MouseEvent e) {}
 public void mouseClicked(MouseEvent e) {}
 public void mouseEntered(MouseEvent e) {}
 public void mouseExited(MouseEvent e) {}
 public void mouseReleased(MouseEvent e) {}
 }
 public class KeyEvents extends JPanel implements KeyListener{
 //addKeyListener;

 @override
 public void keyPressed(KeyEvent ke) {
 } 
 }
 public static void main(String[] args) {
 JFrame frame = new JFrame();
 frame.setSize(500, 500);
 frame.setLocationRelativeTo(null);
 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
 frame.setContentPane(new Z_MouseAndMotionListener1());
 frame.setVisible(true);
 }
 }

编译时出现错误：

Z_MouseAndMotionListener1.java:22: error: Z_MouseAndMotionListener1.KeyEvents is not abstract and does not override abstract method keyReleased(KeyEvent) in KeyListener
public class KeyEvents extends JPanel implements KeyListener{
^

问题原因 #

KeyListener是抽象接口，要求实现类必须重写它的所有抽象方法：keyPressed(KeyEvent)、keyReleased(KeyEvent)、keyTyped(KeyEvent)，仅实现其中一个会导致编译失败。此外，原代码的实现逻辑存在冗余：无需单独创建继承JPanel的KeyEvents类，且组件未设置焦点，即使实现了方法也无法接收键盘事件。

正确实现方案 #

下面提供两种简洁的实现方式，同时解决键盘事件接收问题：

方式1：单一内部类实现所有监听器接口

import javax.swing.*;
import java.awt.event.*;

public class Z_MouseAndMotionListener1 extends JPanel {
    public Z_MouseAndMotionListener1() {
        // 必须设置面板可获得焦点，否则无法接收键盘事件
        setFocusable(true);
        // 请求面板获得焦点
        requestFocusInWindow();
        
        MouseAndKeyListener listener = new MouseAndKeyListener();
        addMouseListener(listener);
        addMouseMotionListener(listener);
        addKeyListener(listener);
    }

    // 内部类同时实现鼠标和键盘监听器接口
    class MouseAndKeyListener implements MouseListener, MouseMotionListener, KeyListener {
        // 鼠标点击事件
        @Override
        public void mousePressed(MouseEvent e) {
            System.out.println("鼠标按下");
        }

        // 鼠标移动事件
        @Override
        public void mouseMoved(MouseEvent e) {
            System.out.println("鼠标移动");
        }

        // 鼠标监听器其他默认空实现
        @Override
        public void mouseDragged(MouseEvent e) {}
        @Override
        public void mouseClicked(MouseEvent e) {}
        @Override
        public void mouseEntered(MouseEvent e) {}
        @Override
        public void mouseExited(MouseEvent e) {}
        @Override
        public void mouseReleased(MouseEvent e) {}

        // 键盘按下事件
        @Override
        public void keyPressed(KeyEvent ke) {
            System.out.println("键盘按下：" + KeyEvent.getKeyText(ke.getKeyCode()));
        }

        // 键盘释放事件
        @Override
        public void keyReleased(KeyEvent ke) {
            System.out.println("键盘释放：" + KeyEvent.getKeyText(ke.getKeyCode()));
        }

        // 键盘输入事件
        @Override
        public void keyTyped(KeyEvent ke) {
            System.out.println("键盘输入：" + ke.getKeyChar());
        }
    }

    public static void main(String[] args) {
        JFrame frame = new JFrame();
        frame.setSize(500, 500);
        frame.setLocationRelativeTo(null);
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setContentPane(new Z_MouseAndMotionListener1());
        frame.setVisible(true);
    }
}

方式2：使用适配器类简化空方法

Swing提供了MouseAdapter、KeyAdapter等适配器类，默认实现了对应监听器的所有方法，只需重写需要的方法即可，减少冗余代码：

import javax.swing.*;
import java.awt.event.*;

public class Z_MouseAndMotionListener1 extends JPanel {
    public Z_MouseAndMotionListener1() {
        setFocusable(true);
        requestFocusInWindow();
        
        MouseAndKeyAdapter adapter = new MouseAndKeyAdapter();
        addMouseListener(adapter);
        addMouseMotionListener(adapter);
        addKeyListener(adapter);
    }

    // 继承MouseAdapter，实现KeyListener
    class MouseAndKeyAdapter extends MouseAdapter implements KeyListener {
        @Override
        public void mousePressed(MouseEvent e) {
            System.out.println("鼠标按下");
        }

        @Override
        public void mouseMoved(MouseEvent e) {
            System.out.println("鼠标移动");
        }

        @Override
        public void keyPressed(KeyEvent ke) {
            System.out.println("键盘按下：" + KeyEvent.getKeyText(ke.getKeyCode()));
        }

        // 仅保留需要的方法，其他方法由适配器默认实现
        @Override
        public void keyReleased(KeyEvent ke) {}
        @Override
        public void keyTyped(KeyEvent ke) {}
    }

    public static void main(String[] args) {
        JFrame frame = new JFrame();
        frame.setSize(500, 500);
        frame.setLocationRelativeTo(null);
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setContentPane(new Z_MouseAndMotionListener1());
        frame.setVisible(true);
    }
}

关键注意点 #

• 必须实现KeyListener的三个抽象方法，或使用KeyAdapter适配器类
• 调用setFocusable(true)和requestFocusInWindow()确保组件能接收键盘事件
• 可将多个监听器逻辑合并到一个内部类中，简化代码结构

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