JavaFX FXML 載入異常的解決方法

1. 導致 JavaFX FXML 載入異常的原因
2. JavaFX FXML 載入異常的解決方法

本教程介紹導致 JavaFX FXML 載入異常的原因並提供快速解決方案。

導致 JavaFX FXML 載入異常的原因

獲得 JavaFX FXML 載入異常的第一個原因是 FXML 檔案的路徑未正確指定給載入程式。路徑 /fxml/view.fxml 指的是一個名為 fxml 的資料夾中的檔案 view.fxml，該資料夾位於 resources 資料夾中，即在 classpath 上。

getClass().getResource() 呼叫在執行時呼叫物件 classloader，它在 classpath 中搜尋傳遞給它的資源。這樣，它將在該資料夾中找到 fxml 資料夾和 view.fxml 檔案。

第二個原因可能是元件 ID 不匹配，這意味著我們可能已經更新了 Controller 檔案中的元件 ID，但忘記在 FXML 檔案中更改該 ID（反之亦然）。在這種情況下，Controller 將無法在 view.fxml 檔案中連結該元件。

看下面的塊有一個清晰的理解。

在控制器檔案上：

@FXML
Button btnName1

在 FXML 檢視 檔案中：

fx:id="btnName_1"

以下是這兩個原因的解決方案。

JavaFX FXML 載入異常的解決方法

要執行此應用程式，我們使用 Java 18、JavaFX 13 和 NetBeans IDE 版本 13。你可以根據自己的選擇使用所有這些。

示例程式碼（view.fxml 檔案，檢視檔案）：

<!--Step1: XML declaration-->
<?xml version="1.0" encoding="UTF-8"?>

<!--Step 2: import necessary java types in FXML-->

<?import javafx.scene.control.Button?>
<?import javafx.scene.control.Label?>
<?import javafx.scene.layout.AnchorPane?>

<!--Step 3: specify the FXML namespace-->

<AnchorPane prefHeight="300.0" prefWidth="400.0"
xmlns="http://javafx.com/javafx/11.0.1"
xmlns:fx="http://javafx.com/fxml/1" fx:controller="com.mycompany.javafx_fxml_loadexception.viewController">

    <!--Step 4: layout pane have children-->
    <children>
        <Button fx:id="btTest" layoutX="170.0"
        layoutY="208.0" mnemonicParsing="false"
        onAction="#onBtTestAction" text="Button" />

        <Label layoutX="167.0" layoutY="126.0" text="Cick here!" />
   </children>

</AnchorPane>

以下是上述程式碼的分步說明。

示例程式碼（viewController.java 類，控制器類）：

// Step 1: replace this package name with your package name
package com.mycompany.javafx_fxml_loadexception;

// Step 2: import necessary libraries
import javafx.fxml.FXML;
import javafx.scene.control.Button;

// Step 3: viewController class
public class viewController {
  // define button
  @FXML private Button btTest;

  // define the action when the button is clicked
  @FXML
  public void onBtTestAction() {
    System.out.println("CLICK");
  } // end onBtTestAction method

} // end viewController class

viewController.java 類是一個控制器類，它在某些成員上使用 @FXML 註釋。請記住，此註解可用於建構函式和類。

使用此註釋，我們指定 FXML 載入器可以輕鬆訪問此成員，即使該成員是 private。如果 FXML 載入器使用 public 成員，我們不需要使用 @FXML 註釋。

但是，對 public 成員使用 @FXML 不會引發任何錯誤。因此，最好對每個成員進行註釋。

以下 FXML 將控制器類的 onBtTestAction() 函式設定為 Button 的事件處理程式：

<Button fx:id="btTest" layoutX="170.0" layoutY="208.0" mnemonicParsing="false"         onAction="#onBtTestAction" text="Button" />

示例程式碼（App.java 類，主類）：

// Step 1: replace the package name with your package name
package com.mycompany.javafx_fxml_loadexception;

// Step 2: import necessary libraries
import java.io.IOException;
import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;

// Step 3: primary launch class extending the Application class
public class App extends Application {
  /**
   *
   * @param stage
   */
  @Override
  public void start(Stage stage) {
    // load the view.fxml file, add it to the scene and show it
    try {
      Parent parent = FXMLLoader.load(getClass().getResource("/fxml/view.fxml"));
      // create a scene
      Scene scene = new Scene(parent);
      // set scene to a stage
      stage.setScene(scene);
      // show the stage
      stage.show();
    } // end try
    catch (IOException e) {
      e.printStackTrace();
    } // end catch
  } // end start method

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

} // end App class

主檔案擴充套件了 Application 類並覆蓋了它的抽象方法 start()。在 start() 方法中，我們載入 view.fxml 檔案，建立場景，將此場景設定為舞臺，並顯示該舞臺。

輸出（當我們點選按鈕時，在 IDE 的控制檯上列印單詞 CLICK）：

檢查以下螢幕截圖以將每個檔案放置在正確的位置：