JavaFX 8 将多个 fxml 文件加载到边框窗格中

Question

给定以下代码：

公共类主扩展应用程序{

private BorderPane rootLayout;
private VBox toolbarLayout;

private URL path;

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

@Override
public void start(Stage stage) {                            

    FXMLLoader loader = new FXMLLoader();                

    // Root View

    path = getClass().getResource("mainLayout.fxml");
    try {
        loader.setLocation(path);            
        rootLayout = (BorderPane) loader.load();
    } catch (IOException e){
        System.out.println("Not found: " + path);
        e.printStackTrace();
    }        

    // Toolbar View
    path = getClass().getResource("toolbar/toolbarView.fxml");  
    try {                        
        toolbarLayout = (VBox) loader.load();
    } catch (IOException e){
        System.out.println("Not found: " + path);
        e.printStackTrace();
    }

    rootLayout.getChildren().add(toolbarLayout);

    Scene scene = new Scene(rootLayout);        
    stage.setScene(scene);
    stage.show();
}

如果我注释掉第二个 fxml 'try' rootLayout 加载正常。如果我注释掉边框并将工具栏视图设置为主视图，它也可以正常工作。 但是如果我尝试将toolbarView加载到rootLayout中，rootLayout加载正常，但是toolbarView会抛出异常：

javafx.fxml.LoadException: Root value already specified.

显然我不太了解 fxml 加载过程，所以有人可以解释一下吗？为什么它认为我在尝试再次设置根目录？

为了完整起见，这里是toolbarView.fxml：

<VBox fx:id="idToolbar" alignment="TOP_CENTER" maxHeight="-Infinity"
 maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity"
  prefHeight="400.0" prefWidth="100.0" spacing="20.0" 
xmlns="http://javafx.com/javafx/8" xmlns:fx="http://javafx.com/fxml/1">

<children>
  <Button mnemonicParsing="false" text="Button" />
  <Button mnemonicParsing="false" text="Button" />
  <Button mnemonicParsing="false" text="Button" />
</children>
  <opaqueInsets>
    <Insets />
  </opaqueInsets>
<padding>
  <Insets top="20.0" />
</padding>
</VBox>

Answer 1

root 属性包含对 FXML 文件指定的结构的引用；即由 FXML 文件的根元素创建的对象。假设您没有使用"dynamic root" (<fx:root>) pattern，根将作为load 进程的一部分设置为对应于FXML 根元素的对象。如果在这个阶段不是null（即如果它已经被设置），那么你会得到一个异常。 controller 属性也有类似的情况：如果 FXML 文件指定了 fx:controller 属性，控制器将被设置为 load() 进程的一部分；如果不是null，则抛出异常。

FXMLLoader 实际上只设计为使用一次，因为您有许多相互依赖的属性，这些属性通常设置为加载过程的一部分：root、location、controller、resources 和namespace 的元素。所以你真的应该为你想要加载的每个 FXML 文件创建一个新的FXMLLoader：

FXMLLoader loader = new FXMLLoader();                

// Root View

path = getClass().getResource("mainLayout.fxml");
try {
    loader.setLocation(path);            
    rootLayout = (BorderPane) loader.load();
} catch (IOException e){
    System.out.println("Not found: " + path);
    e.printStackTrace();
}        

// Toolbar View

loader = new FXMLLoader();

path = getClass().getResource("toolbar/toolbarView.fxml");  
try {                        

    // note you omitted this line:
    loader.setLocation(path);

    toolbarLayout = (VBox) loader.load();
} catch (IOException e){
    System.out.println("Not found: " + path);
    e.printStackTrace();
}

rootLayout.getChildren().add(toolbarLayout);

可以通过仔细取消设置之前加载过程中设置的任何内容来重用FXMLLoader：

FXMLLoader loader = new FXMLLoader();                

// Root View

path = getClass().getResource("mainLayout.fxml");
try {
    loader.setLocation(path);            
    rootLayout = (BorderPane) loader.load();
} catch (IOException e){
    System.out.println("Not found: " + path);
    e.printStackTrace();
}     

loader.setRoot(null);
loader.setController(null);
loader.setResources(null);
loader.getNamespace().clear();   

// Toolbar View
path = getClass().getResource("toolbar/toolbarView.fxml");  

try {                        

    // note you omitted this line:
    loader.setLocation(path);

    toolbarLayout = (VBox) loader.load();
} catch (IOException e){
    System.out.println("Not found: " + path);
    e.printStackTrace();
}

rootLayout.getChildren().add(toolbarLayout);

但这确实不是预期的用途，并且可能对FXMLLoader 实现的未来更改不可靠。