JavaFX：FXMLからイベント処理すると実行エラー！FXMLに書き忘れていたこと

2017/05/06 2017/05/09

前回、Sene Builderで作ったUI（FXML）をJavaFXで表示させました。

JavaFX: GUI作成ツールScene Builderは使いやすい！起動も速い！

前回、JavaFXをちょっと触ってみた雑感を書きました。ここで、FXML上の構文ミスがコンパイルではなく実行時に検出されることを書きました。よく読めばどこの行が間違っているかわかるのですが、コンパイルで引っ掛けられないという点がちょっと嫌だなーと思ってしまったんです。なので、FXMLを使う場合はGUI作成ツールのScene Builderを使わざるを得ないだろうな、と思ったので、そのScene Builderをちょっと使ってみました。ダウンロードはこちらからとなります。ただ、正直GUIツールってEclipseのイメージがあったので、...

実行するとこんな感じ↓になるやつです。ボタンを押してもイベントは発生せずただ表示するだけのプログラムでした。

で、次にやろうとしたことは、ボタンクリックで何かのイベントを発生させること。まあ、そこは楽勝と思ってやってみたのですが、結果、すげー難航しました。

意味不明の実行エラーばかりでプログラム動かず、ググっても解決できず。

で、結局動いたのですが、FXMLにあることを書き忘れた（Scene Builderで設定し忘れた）ために起きたエラーでした。その経緯含め書き留めておきます。

[ad#top-1]

1 まずはエラーまでの軌跡
2 で、実行したらエラー発生。なぜだ？
3 英語サイトで問題個所発見！
4 再度コンパイルして実行
5 Scene Builderのどこで設定するのか？
6 雑感とか反省とか

まずはエラーまでの軌跡

前回作ったScene Builderのボタンイベントを設定しました。

ボタンを選択して、On Actionの欄にコールバック関数名を記載（clickBtnとしました）して保存。

保存したFXMLの中身を見るとこんな感じです。

<?xml version="1.0" encoding="UTF-8"?>

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

<AnchorPane maxHeight="-Infinity" maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity"
  prefHeight="100.0" prefWidth="400.0" xmlns="http://javafx.com/javafx/8.0.111" xmlns:fx="http://javafx.com/fxml/1">
  <children>
    <Label layoutX="46.0" layoutY="26.0" text="Hello World">
      <font>
        <Font name="Meiryo UI" size="36.0" />
      </font>
    </Label>
    <Button layoutX="267.0" layoutY="31.0" mnemonicParsing="false" onAction="#clickBtn" prefHeight="19.0" prefWidth="95.0" text="OK">
      <font>
        <Font size="18.0" />
      </font>
    </Button>
  </children>
</AnchorPane>

Buttonタグ内に「onAction=”#clickBtn”」が追加されました。

JavaFX側は以下の通りです。//追加と書かれているところが前回から追加したところになります。

import javafx.application.Application;
import javafx.fxml.*;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;
import javafx.scene.layout.AnchorPane;
import javafx.event.ActionEvent; //追加

public class Hello extends Application {
  @Override
  public void start(Stage primaryStage) throws Exception{
    AnchorPane root = FXMLLoader.load(getClass().getResource("Hello.fxml"));
    primaryStage.setTitle("Hello World");
    primaryStage.setScene(new Scene(root, 400, 100));
    primaryStage.show();
  }

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

  //追加
  @FXML
  public void clickBtn(ActionEvent e) {
    System.out.println("OK");
  }
}

Scene Builder で設定したコールバック関数clickBtnを追記してボタンを押したら、コンソール上にOKと表示されるようになっています（・・・のつもりでした）。

で、実行したらエラー発生。なぜだ？

コンパイルして（コンパイルは普通に通りました）、実行したところ、以下のように実行エラーが発生して実行できず。

InvocationTargetExceptionという例外が発生しているみたいですが、調べても謎。なんとなくFXMLの呼び出しエラーっぽい感じに読み取れましたが、イベント処理させなかったときは普通に読み込めたし。

エラーの発生個所もFXMLファイルの19行目となっていましたが、その行は</Button>とタグを閉めている行。意味不明です。

ググってもググっても解決策が見つからず、もうこりゃダメか？？とあきらめかけていたところ・・・。

英語サイトで問題個所発見！

日本語サイトではもうダメだと思って（それこそQiita見てもわからず）、英語サイトに活路を見出しました。（英語苦手だけど）

そしたら、それらしき記述発見！

投稿者はまさに僕と同じ問題にぶち当たっていたようです。おぉ、これだ！と思って、回答を見てみると、※文字色の赤に注目

The error says it, the FXML is missing the fx:controller declaration. Add the controller declaration to BorderPane. declaration as shown :

…
<BorderPane maxHeight=”1.7976931348623157E308″
maxWidth=”1.7976931348623157E308″ prefHeight=”400.0″
prefWidth=”600.0″ xmlns=”http://javafx.com/javafx/8″
xmlns:fx=”http://javafx.com/fxml/1″
fx:controller=”Weert.Controller”>
…

fx:controllerではクラス名を明示させているようです。で、僕のFXMLを見ると、AchorPaneタグにfx:controllerがないではないですか。

早速、手書きで追記しました。