如何实例化对应FXML与控制器的可显示JavaFX对象？

这个问题我之前也碰到过，其实核心是没理清JavaFX里FXML加载时视图节点和控制器的关系，给你两种解决方案，看哪种更适配你的场景：

方案一：让控制器继承自Node类（适合视图与控制器绑定紧密的场景） #

如果你的控制器本身需要作为一个可显示的节点，直接让它继承JavaFX的容器类（比如AnchorPane、VBox等），然后在控制器的构造方法里完成FXML的加载，把自身同时作为根节点和控制器：

控制器代码示例 #

public class Ctr extends AnchorPane {
    public Ctr() {
        FXMLLoader loader = new FXMLLoader(getClass().getResource("file.fxml"));
        // 将当前控制器实例设为FXML的根节点和控制器
        loader.setRoot(this);
        loader.setController(this);
        
        try {
            loader.load();
        } catch (IOException e) {
            // 异常处理，这里直接转成运行时异常简化代码
            throw new RuntimeException("加载FXML失败", e);
        }
    }

    // 这里可以添加控制器的业务方法
    public void doSomeOperation() {
        // 业务逻辑代码
    }
}

对应的FXML配置 #

确保FXML的根节点类型和控制器继承的容器类一致，并且指定控制器：

<AnchorPane xmlns="http://javafx.com/javafx"
            xmlns:fx="http://javafx.com/fxml"
            fx:controller="你的包路径.Ctr">
    <!-- 这里添加你的UI控件 -->
</AnchorPane>

在类A中使用 #

这样你就可以直接实例化Ctr，它既是控制器又是可添加到容器的节点：

// 类A中
StackPane stackPane = new StackPane();
Ctr myCtr = new Ctr();
stackPane.getChildren().add(myCtr); // 直接添加，没问题
myCtr.doSomeOperation(); // 同时可以调用控制器的方法

方案二：分离视图与控制器（更符合MVC设计，推荐） #

如果更倾向于视图和控制器职责分离，我们可以通过FXMLLoader分别获取视图根节点和控制器实例，这样既可以把视图添加到容器，又能持有控制器的引用进行业务操作：

在类A中的代码示例 #

// 类A中
StackPane stackPane = new StackPane();

try {
    FXMLLoader loader = new FXMLLoader(getClass().getResource("file.fxml"));
    // 加载FXML，返回视图的根节点（Parent是所有JavaFX节点的父类）
    Parent viewRoot = loader.load();
    // 获取对应的控制器实例
    Ctr controller = loader.getController();

    // 将视图添加到StackPane
    stackPane.getChildren().add(viewRoot);
    // 通过控制器实例调用业务方法
    controller.initData(); // 假设控制器有初始化数据的方法
} catch (IOException e) {
    throw new RuntimeException("加载FXML失败", e);
}

对应的FXML配置 #

只需要在FXML中指定控制器即可，根节点用常规的容器类：

<AnchorPane xmlns="http://javafx.com/javafx"
            xmlns:fx="http://javafx.com/fxml"
            fx:controller="你的包路径.Ctr">
    <!-- UI控件内容 -->
</AnchorPane>

为什么之前会出现问题？ #

• 如果只声明Ctr类型但它不是Node的子类，自然无法添加到StackPane这类容器（容器只接受Node及其子类）；
• 直接用FXMLLoader.load()返回的是视图根节点（Node类型），但通过loader.getController()就能拿到强类型的Ctr实例，完美解决“类型未知”的问题。

内容的提问来源于stack exchange，提问作者T0u4at1-05ema