Класс Application

Жизненный цикл

Точка входа для JavaFX-приложений — класс Application. При запуске приложения среда выполнения JavaFX выполняет следующие действия в указанном порядке:

1. Запускает среду выполнения JavaFX, если она еще не запущена (см. Platform.startup(Runnable) для получения дополнительной информации)
2. Создаёт экземпляр указанного класса Application
3. Вызывает метод init()
4. Вызывает метод start(javafx.stage.Stage)
5. Ожидает завершения работы приложения, что происходит при наступлении одного из следующих условий:
   • приложение вызывает Platform.exit()
   • последнее окно закрыто и атрибут implicitExit объекта Platform имеет значение true
6. Вызывает метод stop()

Обратите внимание, что метод start является абстрактным и должен быть переопределён. Методы init и stop имеют конкретные реализации, которые ничего не делают.

Подкласс Application должен быть объявлен public и иметь public конструктор без аргументов.

Вызов Platform.exit() — предпочтительный способ явного завершения JavaFX-приложения. Прямой вызов System.exit(int) является допустимой альтернативой, но не позволяет методу Application stop() выполниться.

JavaFX-приложение не должно пытаться использовать JavaFX после завершения инструментария FX или из ShutdownHook, то есть после возвращения метода stop() или вызова System.exit(int).

Примечание: Классы JavaFX должны загружаться из набора модулей с именами javafx.* в пути модуля. Загрузка классов JavaFX из пути класса не поддерживается. См. Platform.startup для получения дополнительной информации.

Развёртывание приложения как модуля

Если подкласс Application находится в именованном модуле, то этот класс должен быть доступен модулю javafx.graphics. В противном случае при запуске приложения будет выброшено исключение. Это означает, что помимо объявления самого класса public, модуль должен export (или open) содержащий пакет по крайней мере модулю javafx.graphics.

Например, если com.foo.MyApplication находится в модуле foo.app, то модуль module-info.java может выглядеть так:

module foo.app {
    exports com.foo to javafx.graphics;
}

Параметры

Параметры приложения доступны, вызвав метод getParameters() из метода init() или в любое время после вызова метода init.

Потоки

JavaFX создаёт поток приложения для выполнения метода запуска приложения, обработки событий ввода и выполнения анимационных временных линий. Создание объектов JavaFX Scene и Stage, а также изменения операций с деревом сцены для живых объектов (объектов, уже присоединённых к сцене) должны выполняться в потоке JavaFX приложения.

Загрузчик Java загружает и инициализирует указанный класс Application в потоке JavaFX приложения. Если в классе Application нет метода main или если метод main вызывает Application.launch(), то экземпляр Application создаётся в потоке JavaFX приложения.

Метод init вызывается в потоке загрузчика, а не в потоке JavaFX приложения. Это означает, что приложение не должно создавать объект Scene или Stage в методе init. Приложение может создавать другие объекты JavaFX в методе init.

Все необработанные исключения в потоке JavaFX приложения, возникающие во время обработки событий, выполнения анимационных временных линий или любого другого кода, пересылаются обработчику необработанных исключений потока uncaught exception handler.

Пример

Следующий пример продемонстрирует простое JavaFX-приложение.

import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.shape.Circle;
import javafx.stage.Stage;

public class MyApp extends Application {
    public void start(Stage stage) {
        Circle circ = new Circle(40, 40, 30);
        Group root = new Group(circ);
        Scene scene = new Scene(root, 400, 300);

        stage.setTitle("My JavaFX Application");
        stage.setScene(scene);
        stage.show();
    }
}
 

Вышеприведённый пример произведёт следующее: