- java.lang.Object
-
- javafx.application.Application
-
- javafx.application.Preloader
-
public abstract class Preloader extends Application
Класс, который расширяется для определения необязательного предварительного загрузчика для приложения JavaFX. Приложение может содержать предварительный загрузчик, который используется для улучшения опыта загрузки приложения.Предварительный загрузчик — это небольшое приложение, которое запускается перед основным приложением для настройки процесса запуска. Предварительный загрузчик:
- получает уведомления о прогрессе загрузки ресурсов приложения
- получает уведомления об ошибках
- получает уведомления об инициализации и запуске приложения
- решает, когда приложение должно стать видимым
По умолчанию предварительный загрузчик отображается поверх стадии приложения Stage, которая не видна до тех пор, пока предварительный загрузчик не станет видимым. Предварительный загрузчик должен скрыть себя, чтобы сделать приложение видимым. Хорошей практикой является выполнение этого не ранее, чем непосредственно перед вызовом application.start(), так как в противном случае само приложение не будет видно.
Предварительный загрузчик также может взаимодействовать с приложением для достижения расширенных визуальных эффектов или обмена данными (например, для реализации экрана входа в систему). Предварительный загрузчик получает ссылку на приложение и может извлечь необходимые данные для взаимодействия из приложения, если приложение реализует интерфейс, о котором знает предварительный загрузчик и на который он полагается. Как правило, не рекомендуется разрабатывать предварительные загрузчики таким образом, чтобы приложение вызывало их напрямую, так как это приведет к плохому пользовательскому опыту, если приложение подписано, а предварительный загрузчик нет.
Если приложение не указывает предварительный загрузчик, используется предварительный загрузчик по умолчанию. Внешний вид предварительного загрузчика по умолчанию можно настроить (набор параметров пока не определен).
Реализации пользовательских предварительных загрузчиков должны соответствовать следующим правилам:
- класс пользовательского предварительного загрузчика должен расширять Preloader
- классы, необходимые для предварительного загрузчика, должны быть упакованы в отдельном JAR-файле.
Приложения также могут отправлять пользовательские уведомления в предварительный загрузчик, используя метод
notifyPreloader. Таким образом, предварительный загрузчик также может отображать прогресс инициализации приложения.Обратите внимание, что предварительные загрузчики подчиняются тем же правилам, что и другие приложения JavaFX, включая правила потоков FX. В частности, конструктор класса и метод init() будут вызваны в потоке, не связанном с FX, а метод start() будет выполнен в потоке приложения FX. Это также означает, что конструктор/метод init() приложения будут выполняться параллельно с запуском предварительного загрузчика.
Обработчики уведомлений о предварительном загрузчике будут переданы в поток приложения FX.
Выключение (включая тот случай, когда вызывается stop()) пока не определено.
- С:
- JavaFX 2.0
-
Краткое описание вложенных классов
Вложенные классы Модификатор и тип Класс Описание static classPreloader.ErrorNotificationУведомление предварительного загрузчика, сообщающее об ошибке.static interfacePreloader.PreloaderNotificationИнтерфейс-маркер для всех уведомлений предварительного загрузчика.static classPreloader.ProgressNotificationУведомление предварительного загрузчика, сообщающее о прогрессе.static classPreloader.StateChangeNotificationУведомление, сигнализирующее об изменении состояния приложения.-
Вложенные классы/интерфейсы, унаследованные от класса javafx.application.Application
Application.Parameters
-
-
Краткое описание полей
-
Поля, унаследованные от класса javafx.application.Application
STYLESHEET_CASPIAN, STYLESHEET_MODENA
-
-
Краткое описание конструкторов
Конструкторы Конструктор Описание Preloader()
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание voidhandleApplicationNotification(Preloader.PreloaderNotification info)Указывает уведомление, сгенерированное приложением.booleanhandleErrorNotification(Preloader.ErrorNotification info)Вызывается при возникновении ошибки.voidhandleProgressNotification(Preloader.ProgressNotification info)Указывает прогресс загрузки.voidhandleStateChangeNotification(Preloader.StateChangeNotification info)Указывает изменение состояния приложения.-
Методы, унаследованные от класса javafx.application.Application
getHostServices, getParameters, getUserAgentStylesheet, init, launch, launch, notifyPreloader, setUserAgentStylesheet, start, stop
-
-
Подробное описание конструкторов
-
Preloader
public Preloader()
-
-
Подробное описание методов
-
handleProgressNotification
public void handleProgressNotification(Preloader.ProgressNotification info)
Указывает прогресс загрузки. Этот метод вызывается средой FX для указания прогресса во время загрузки ресурсов приложения. Он не будет вызван для доставки ProgressNotification, отправленной вnotifyPreloader.Реализация этого метода, предоставленная классом Preloader, ничего не делает.
- Параметры:
-
info- уведомление о прогрессе
-
handleStateChangeNotification
public void handleStateChangeNotification(Preloader.StateChangeNotification info)
Указывает изменение состояния приложения. Этот метод вызывается средой FX как часть жизненного цикла приложения.Реализация этого метода, предоставленная классом Preloader, ничего не делает.
- Параметры:
-
info- уведомление об изменении состояния
-
handleApplicationNotification
public void handleApplicationNotification(Preloader.PreloaderNotification info)
Указывает уведомление, сгенерированное приложением. Этот метод вызывается средой FX для доставки уведомления, отправленного черезnotifyPreloader.Приложения не должны вызывать этот метод напрямую, а вместо этого должны использовать
notifyPreloaderдля предотвращения проблем с диалогом смешанного кода.Реализация этого метода, предоставленная классом Preloader, ничего не делает.
- Параметры:
-
info- уведомление, сгенерированное приложением
-
handleErrorNotification
public boolean handleErrorNotification(Preloader.ErrorNotification info)
Вызывается при возникновении ошибки.Реализация этого метода, предоставленная классом Preloader, возвращает false, указывая, что обработчик ошибок по умолчанию должен отобразить сообщение пользователю.
- Параметры:
-
info- уведомление об ошибке, описывающее причину ошибки - Возвращает:
- true, если ошибка была показана пользователю предварительным загрузчиком и дополнительное отображение не требуется; в противном случае false.
-
© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.