FXML

Полным источником информации о том, как работает FXML, является документ Введение в FXML.

Существует также немало руководств по FXML. Один из них — Учебник по Oracle . Это руководство было написано для JavaFX 8, но с тех пор в FXML мало что изменилось, поэтому оно все еще применимо. Самое большое изменение — это то, что вам нужно сделать, если развертываете свое приложение в виде Java-модуля . Еще один хороший учебник — JavaFX Tutorials на jenkov.com, ссылка на который на самом деле есть на https://openjfx.io.

Проблема в вашем коде

Когда FXMLLoader видит элемент <LauncherPanel/> в файле FXML, он просто попытается создать экземпляр типа, рефлексивно вызывая один из его конструкторов; в данном случае это будет конструктор без аргументов. Но это все. Ничто в этом элементе или классе LauncherPanel не указывает на необходимость загрузки дополнительного FXML. Это означает, что класс не создается как контроллер FXML, не говоря уже о корне FXML, и, следовательно, метод initialize не вызывается.

Многоразовые компоненты FXML

Существует два способа создания повторно используемых компонентов FXML: fx:root и fx:include.

fx:root

Вы используете fx:root, когда хотите скрыть использование FXML. Вы создаете пользовательский класс, граф объектов которого определен в файле FXML, но код, использующий пользовательский класс, не знает об этом. При использовании этого подхода вы должны:

1. Используйте fx:root в качестве корневого элемента файла FXML.

2. Определите атрибут type в корневом элементе. Документ «Введение в FXML» устанавливает значение этого атрибута для класса, который расширяет пользовательский класс.

3. Вручную установите root из FXMLLoader. Если контроллер должен быть тем же экземпляром, что и root, то также вручную установите controller загрузчика; в этом случае не определяйте атрибут fx:controller. В противном случае, если корень и контроллер относятся к разным классам, вы можете использовать fx:controller. Какой подход вы используете, зависит от вас.

4. Загрузите FXML в конструктор пользовательского класса.

Затем вы используете пользовательский класс, как и любой другой.

Поскольку именно этот подход вы используете в своем вопросе, ниже приведен полный пример использования fx:root.

fx:include

Использовать fx:include проще. В включенном вами файле FXML нет ничего особенного. Он не использует fx:root, он может определять атрибут fx:controller как обычно, и вы не связываете его с пользовательским классом. Все что тебе нужно это:

<fx:include source = "<path to reusable FXML file>"/>

Всякий раз, когда вы хотите вложить один файл FXML в другой.

Обратите внимание, что этот подход предназначен не только для создания повторно используемых компонентов FXML. Иногда вам может просто потребоваться разделить монолитный файл FXML на несколько файлов FXML меньшего размера для удобства обслуживания.

Инициализация контроллера

Обратите внимание, что интерфейс Initializable, хотя и не является технически устаревшим, устарел. Из его документации:

ПРИМЕЧАНИЕ. Этот интерфейс был заменен автоматическим внедрением свойств location и resources в контроллер. FXMLLoader теперь будет автоматически вызывать любой соответствующим образом аннотированный метод без аргументов initialize(), определенный контроллером. По возможности рекомендуется использовать инъекционный подход.

Это означает, что предпочтительный подход выглядит так:

import javafx.fxml.FXML
import java.net.URL
import java.util.ResourceBundle

class Controller {

    @FXML private lateinit var location: URL
    @FXML private lateinit var resources: ResourceBundle

    @FXML
    private fun initialize() {
       // perform any needed initialization
    }
}

И свойства location и resources, и метод initialize являются необязательными по отдельности. Включайте их только тогда, когда они вам нужны.

Обратите внимание, что если ваш контроллер способен работать с ResourceBundle, но также может работать, когда пакет не указан, вам следует определить свойство следующим образом:

@FXML private var resources: ResourceBundle? = null

Пример - fx:root

Вот рабочий пример использования fx:root с классом Kotlin, где «корневой тип» используется в другом файле FXML (как в вашем вопросе).

Пример был разработан с использованием:

• Ява 22.0.1

• JavaFX 22.0.1

• Градл 8.8

• Windows 11

Макет каталога

<project-directory>
|   build.gradle.kts
|   gradlew
|   gradlew.bat
|   settings.gradle.kts
|
+---gradle 
|   \---wrapper
|           gradle-wrapper.jar
|           gradle-wrapper.properties
|           
\---src
    \---main
        +---kotlin
        |       LauncherPanel.kt
        |       Main.kt
        |       
        \---resources
                LauncherPanel.fxml
                Main.fxml

Исходники Котлина

Main.kt

package com.example.fxmlsample

import javafx.application.Application
import javafx.stage.Stage
import javafx.fxml.FXMLLoader
import javafx.scene.Scene
import javafx.scene.Parent

fun main(args: Array<out String>) {
  Application.launch(Main::class.java, *args)
}

class Main : Application() {

  override fun start(primaryStage: Stage) {
    val loader = FXMLLoader().apply {
      location = Main::class.java.getResource("/Main.fxml")!!
    }
    primaryStage.scene = Scene(loader.load<Parent>())
    primaryStage.title = "FXML Sample"
    primaryStage.show()
  }
}

LauncherPanel.kt

package com.example.fxmlsample

import javafx.scene.layout.StackPane
import javafx.scene.control.Label
import javafx.fxml.FXML
import javafx.fxml.FXMLLoader

class LauncherPanel : StackPane() {

  @FXML
  private lateinit var label: Label

  init {
    val loader = FXMLLoader().apply {
      location = LauncherPanel::class.java.getResource("/LauncherPanel.fxml")!!
      setRoot(this@LauncherPanel)
      setController(this@LauncherPanel)
    }
    loader.load<LauncherPanel>()
  }

  @FXML
  private fun initialize() {
    label.text = "Hello, from 'initialize'!"
  }
}

FXML-файлы

Main.fxml

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

<?import com.example.fxmlsample.LauncherPanel?>
<?import javafx.geometry.Insets?>
<?import javafx.scene.control.Label?>
<?import javafx.scene.control.Separator?>
<?import javafx.scene.layout.VBox?>

<VBox xmlns = "http://javafx.com/javafx" xmlns:fx = "http://javafx.com/fxml"
      spacing = "10" alignment = "TOP_CENTER" prefWidth = "500" prefHeight = "300">
  <padding>
    <Insets topRightBottomLeft = "10"/>
  </padding>
  <Label text = "FXML Sample"/>
  <Separator/>
  <LauncherPanel VBox.vgrow = "ALWAYS"/>
</VBox>

Панель запуска.fxml

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

<?import javafx.scene.control.Label?>

<fx:root type = "javafx.scene.layout.StackPane" xmlns = "http://javafx.com/javafx" 
    xmlns:fx = "http://javafx.com/fxml">
  <Label fx:id = "label"/>
</fx:root>

Gradle-файлы

settings.gradle.kts

rootProject.name = "fxml-sample"

build.gradle.kts

plugins {
  kotlin("jvm") version "2.0.0"
  id("org.openjfx.javafxplugin") version "0.1.0"
  application
}

group = "com.example"
version = "0.1.0"

repositories { 
  mavenCentral()
}

javafx {
  modules("javafx.controls", "javafx.fxml")
  version = "22.0.1"
}

application {
  mainClass = "com.example.fxmlsample.MainKt"
}