JavaFX中如何实现集中式MouseEvent处理以复用逻辑？

我有两个MouseEvent处理方法，希望将它们“集中化”，因为还有其他节点需要执行相同操作。我知道可以创建多个MouseEvent处理方法，但觉得肯定有更简洁的方式。

原代码如下：

public class scMain implements Initializable {

@FXML
private Button btnView, btnView2;
@FXML
private HBox hboxView, hboxView2;

public void translateTransition(Node node) {
    TranslateTransition translate = new TranslateTransition();
    translate.setNode(node);
    // ...animation stuff   
    translate.play();
}

public void fadeOffTransition(Node node) {
    FadeTransition fade = new FadeTransition();
    fade.setNode(node);
    // ...animation stuff  
    fade.play();
}

public void fadeInTransition(Node node) {
    FadeTransition fade = new FadeTransition();
    fade.setNode(node);
    // ...animation stuff  
    fade.play();
}

@FXML
void btnMouseEnter(MouseEvent event) {
    fadeOffTransition(btnView);
    hboxView.setVisible(true);
    translateTransition(hboxView);
}

@FXML
void btnMouseExit(MouseEvent event) {
    fadeInTransition(btnView);
    hboxView.setVisible(false);
}}

我尝试了以下方法，但显然无效：

@FXML
void btnMouseEnter(MouseEvent event, Node first, Node second) {
    fadeOffTransition(first);
    second.setVisible(true);
    translateTransition(second);
}

@FXML
void btnMouseExit(MouseEvent event, Node first, Node second) {
    fadeInTransition(first);
    second.setVisible(false);
}

@Override
public void initialize(URL url, ResourceBundle rb) {
   btnMouseEnter(event, btnView2, hboxView2); //error cannot find symbol
   btnMouseExit(event, btnView2, hboxView2); //error cannot find symbol
}

问题核心 #

FXML注解的事件处理方法只能有固定参数形式：要么无参数，要么仅接收对应的事件对象（比如MouseEvent），无法自定义额外参数，这是你代码报错的根本原因。

可行解决方案 #

方案1：利用userData绑定关联节点

给按钮绑定对应的HBox，在通用事件方法中通过事件源获取关联节点：

public class scMain implements Initializable {

    @FXML
    private Button btnView, btnView2;
    @FXML
    private HBox hboxView, hboxView2;

    // 动画方法保持不变
    public void translateTransition(Node node) {
        TranslateTransition translate = new TranslateTransition();
        translate.setNode(node);
        // ...animation stuff   
        translate.play();
    }

    public void fadeOffTransition(Node node) {
        FadeTransition fade = new FadeTransition();
        fade.setNode(node);
        // ...animation stuff  
        fade.play();
    }

    public void fadeInTransition(Node node) {
        FadeTransition fade = new FadeTransition();
        fade.setNode(node);
        // ...animation stuff  
        fade.play();
    }

    // 通用鼠标进入事件处理
    @FXML
    void btnMouseEnter(MouseEvent event) {
        Button sourceBtn = (Button) event.getSource();
        // 获取绑定的HBox
        HBox targetHbox = (HBox) sourceBtn.getUserData();
        
        fadeOffTransition(sourceBtn);
        targetHbox.setVisible(true);
        translateTransition(targetHbox);
    }

    // 通用鼠标离开事件处理
    @FXML
    void btnMouseExit(MouseEvent event) {
        Button sourceBtn = (Button) event.getSource();
        HBox targetHbox = (HBox) sourceBtn.getUserData();
        
        fadeInTransition(sourceBtn);
        targetHbox.setVisible(false);
    }

    @Override
    public void initialize(URL url, ResourceBundle rb) {
        // 给按钮绑定对应的HBox
        btnView.setUserData(hboxView);
        btnView2.setUserData(hboxView2);
    }
}

然后在FXML文件中，将两个按钮的onMouseEntered绑定到btnMouseEnter，onMouseExited绑定到btnMouseExit即可。

方案2：自定义事件处理器类

封装按钮与HBox的关联逻辑，创建独立的处理器类：

// 自定义事件处理器
public class ButtonHoverHandler implements EventHandler<MouseEvent> {
    private final Button btn;
    private final HBox hbox;
    private final scMain controller;

    public ButtonHoverHandler(Button btn, HBox hbox, scMain controller) {
        this.btn = btn;
        this.hbox = hbox;
        this.controller = controller;
    }

    @Override
    public void handle(MouseEvent event) {
        if (event.getEventType() == MouseEvent.MOUSE_ENTERED) {
            controller.fadeOffTransition(btn);
            hbox.setVisible(true);
            controller.translateTransition(hbox);
        } else if (event.getEventType() == MouseEvent.MOUSE_EXITED) {
            controller.fadeInTransition(btn);
            hbox.setVisible(false);
        }
    }
}

在控制器的initialize方法中绑定事件：

@Override
public void initialize(URL url, ResourceBundle rb) {
    ButtonHoverHandler handler1 = new ButtonHoverHandler(btnView, hboxView, this);
    btnView.setOnMouseEntered(handler1);
    btnView.setOnMouseExited(handler1);

    ButtonHoverHandler handler2 = new ButtonHoverHandler(btnView2, hboxView2, this);
    btnView2.setOnMouseEntered(handler2);
    btnView2.setOnMouseExited(handler2);
}

这种方式无需在FXML中绑定事件，适合动态创建的节点场景。

方案3：基于命名规则关联（不推荐）

如果按钮和HBox的fx:id有严格统一的命名规则（如btnView对应hboxView），可以通过ID查找关联节点，但这种方式不够健壮，依赖命名规范：

@FXML
void btnMouseEnter(MouseEvent event) {
    Button sourceBtn = (Button) event.getSource();
    String btnId = sourceBtn.getId();
    // 替换前缀获取HBox的ID
    String hboxId = btnId.replace("btn", "hbox");
    HBox targetHbox = (HBox) sourceBtn.getScene().lookup("#" + hboxId);
    
    fadeOffTransition(sourceBtn);
    targetHbox.setVisible(true);
    translateTransition(targetHbox);
}

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