如何在NetBeans现有Java 20 Maven项目中集成JavaFX 20实现场景切换？

一、可行性确认 #

JavaFX完全可以和现有Java代码兼容，但由于JDK 11及以后JavaFX成为独立模块化库，需要正确配置依赖与模块声明，并非直接添加库文件即可。你有两种可行路径：直接在现有项目中集成JavaFX，或是新建JavaFX项目迁移现有代码。

二、直接集成到现有NetBeans项目的步骤 #

1. 配置JavaFX依赖 #

• Maven项目：打开项目pom.xml，添加JavaFX依赖与插件配置（替换版本号和主类路径）：

  <dependencies>
      <dependency>
          <groupId>org.openjfx</groupId>
          <artifactId>javafx-controls</artifactId>
          <version>21.0.1</version>
      </dependency>
      <dependency>
          <groupId>org.openjfx</groupId>
          <artifactId>javafx-fxml</artifactId>
          <version>21.0.1</version>
      </dependency>
  </dependencies>
  <build>
      <plugins>
          <plugin>
              <groupId>org.openjfx</groupId>
              <artifactId>javafx-maven-plugin</artifactId>
              <version>0.0.8</version>
              <executions>
                  <execution>
                      <id>default-cli</id>
                      <configuration>
                          <mainClass>你的主类全限定名</mainClass>
                      </configuration>
                  </execution>
              </executions>
          </plugin>
      </plugins>
  </build>
  

• 普通Java项目：右键项目→属性→库→添加JAR/文件夹，选中已安装JavaFX库的javafx-controls.jar、javafx-fxml.jar等核心包；再到运行→VM选项中添加：

  --module-path "你的JavaFX库路径/lib" --add-modules javafx.controls,javafx.fxml
  

2. 模块化项目的模块声明 #

若现有项目使用module-info.java，需添加JavaFX模块依赖：

module 你的模块名 {
    requires javafx.controls;
    requires javafx.fxml;
    exports 你的包名 to javafx.graphics, javafx.fxml;
}

三、替代方案：新建JavaFX项目导入现有代码 #

如果直接集成遇到配置障碍，这个方案更省心：

1. 在NetBeans中新建JavaFX Application项目。
2. 将现有Java类复制到新项目源码目录，调整包路径匹配。
3. 把原有项目的依赖库添加到新项目的库配置中。
4. 逐步替换Swing相关逻辑（如JPanel）为JavaFX的Scene、Pane，或用SwingNode临时嵌入JPanel做过渡。

四、场景切换实现示例 #

JavaFX的场景切换逻辑与Swing不同，以下是两种贴合你需求的实现：

1. 纯JavaFX场景切换 #

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class SceneSwitchDemo extends Application {
    private Stage primaryStage;

    @Override
    public void start(Stage primaryStage) {
        this.primaryStage = primaryStage;
        showFirstScene();
        primaryStage.show();
    }

    private void showFirstScene() {
        Button switchBtn = new Button("切换到第二个场景");
        switchBtn.setOnAction(e -> showSecondScene());
        
        StackPane firstPane = new StackPane(switchBtn);
        Scene firstScene = new Scene(firstPane, 400, 300);
        
        primaryStage.setScene(firstScene);
    }

    private void showSecondScene() {
        Button backBtn = new Button("返回第一个场景");
        backBtn.setOnAction(e -> showFirstScene());
        
        StackPane secondPane = new StackPane(backBtn);
        Scene secondScene = new Scene(secondPane, 400, 300);
        
        primaryStage.setScene(secondScene);
    }

    public static void main(String[] args) {
        launch(args);
    }
}

2. 嵌入JPanel并切换（兼容原有代码） #

用SwingNode将JPanel包装为JavaFX节点，实现混合切换：

import javafx.application.Application;
import javafx.embed.swing.SwingNode;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;
import javax.swing.JPanel;
import javax.swing.JLabel;
import java.awt.Color;

public class SwingJavaFXSwitchDemo extends Application {
    private Stage primaryStage;

    @Override
    public void start(Stage primaryStage) {
        this.primaryStage = primaryStage;
        showFirstJPanel();
        primaryStage.show();
    }

    private void showFirstJPanel() {
        JPanel firstPanel = new JPanel();
        firstPanel.setBackground(Color.LIGHT_GRAY);
        firstPanel.add(new JLabel("第一个JPanel"));
        
        Button switchBtn = new Button("切换到第二个JPanel");
        switchBtn.setOnAction(e -> showSecondJPanel());
        
        SwingNode swingNode = new SwingNode();
        swingNode.setContent(firstPanel);
        
        StackPane root = new StackPane(swingNode, switchBtn);
        Scene scene = new Scene(root, 400, 300);
        
        primaryStage.setScene(scene);
    }

    private void showSecondJPanel() {
        JPanel secondPanel = new JPanel();
        secondPanel.setBackground(Color.PINK);
        secondPanel.add(new JLabel("第二个JPanel"));
        
        Button backBtn = new Button("返回第一个JPanel");
        backBtn.setOnAction(e -> showFirstJPanel());
        
        SwingNode swingNode = new SwingNode();
        swingNode.setContent(secondPanel);
        
        StackPane root = new StackPane(swingNode, backBtn);
        Scene scene = new Scene(root, 400, 300);
        
        primaryStage.setScene(scene);
    }

    public static void main(String[] args) {
        launch(args);
    }
}

五、关键注意事项 #

• JDK 8内置JavaFX，无需额外依赖；JDK 11及以后必须手动添加JavaFX库。
• 混合Swing与JavaFX时，要注意线程安全：Swing组件需在AWT事件调度线程更新，JavaFX组件需在JavaFX应用线程更新。
• 长期来看，建议逐步迁移到纯JavaFX，其动画、场景切换能力更适配游戏开发需求。

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