public abstract class Preloader extends Application
プレローダーはメイン・アプリケーションの前に起動し、起動操作をカスタマイズする小さなアプリケーションです。プレローダーの処理内容は次のとおりです。
デフォルトのプレローダーは、アプリケーションのStageの上に表示され、アプリケーションのStageはプレローダーが表示されるまでは表示されません。プレローダーは、プレローダー自体を非表示にして、アプリケーションが表示されるようにする必要があります。これは、application.start()が呼び出される直前にのみ行うことをお薦めします。そうしないと、アプリケーション自体が表示されません。
また、プレローダーは、アプリケーションと連携して、高度な視覚効果を実現したり、データを共有できます(ログイン画面の実装など)。プレローダーが認識し、使用できるインタフェースをアプリケーションが実装している場合、プレローダーは、アプリケーションへの参照を取得し、連携のために必要なデータをアプリケーションから取得することができます。一般に、アプリケーションがプレローダーを直接呼び出すような方法でプレローダーを設計することは、アプリケーションが署名され、プレローダーが署名されていない場合にユーザーの操作性が低下するためお薦めしません。
アプリケーションでプレローダーが指定されていない場合は、デフォルトのプレローダーが使用されます。プレローダーのデフォルトの外観をカスタマイズできます(パラメータのセットは未定です)。
カスタム・プレローダーを実装する場合は次のルールに従ってください。
アプリケーションは、notifyPreloader
メソッドを使用してプレローダーにカスタム通知を送信することもできます。この方法で、プレローダーはアプリケーション初期化の進捗を表示することもできます。
プレローダーは、FXスレッド・ルールなど、他のJavaFXアプリケーションと同じルールに従う必要があることに注意してください。特に、クラス・コンストラクタおよびinit()メソッドは、FX以外のスレッドで呼び出され、start()はFXアプリケーション・スレッドで実行されます。これは、アプリケーション・コンストラクタとinit()が、プレローダーのstart()と同時に実行されることも意味します。
プレローダー通知のコールバックは、FXアプリケーション・スレッドで配信されます。
停止(stop()が呼び出されるタイミングを含む)については未定です。
修飾子と型 | クラスと説明 |
---|---|
static class |
Preloader.ErrorNotification
エラーをレポートするプレローダー通知。
|
static interface |
Preloader.PreloaderNotification
すべてのプレローダー通知のマーカー・インタフェース。
|
static class |
Preloader.ProgressNotification
進捗をレポートするプレローダー通知。
|
static class |
Preloader.StateChangeNotification
アプリケーション状態の変更を示す通知。
|
Application.Parameters
STYLESHEET_CASPIAN, STYLESHEET_MODENA
コンストラクタと説明 |
---|
Preloader() |
修飾子と型 | メソッドと説明 |
---|---|
void |
handleApplicationNotification(Preloader.PreloaderNotification info)
アプリケーション生成通知を示します。
|
boolean |
handleErrorNotification(Preloader.ErrorNotification info)
エラーが発生する場合に呼び出されます。
|
void |
handleProgressNotification(Preloader.ProgressNotification info)
ダウンロードの進捗を示します。
|
void |
handleStateChangeNotification(Preloader.StateChangeNotification info)
アプリケーション状態の変更を示します。
|
getHostServices, getParameters, getUserAgentStylesheet, init, launch, launch, notifyPreloader, setUserAgentStylesheet, start, stop
public void handleProgressNotification(Preloader.ProgressNotification info)
notifyPreloader
へ送信されるProgressNotificationを配信するために、呼び出されることはありません。
Preloaderクラスで提供されるこのメソッドの実装では何も行いません。
info
- 進捗の通知public void handleStateChangeNotification(Preloader.StateChangeNotification info)
Preloaderクラスで提供されるこのメソッドの実装では何も行いません。
info
- 状態変更の通知public void handleApplicationNotification(Preloader.PreloaderNotification info)
notifyPreloader
を介して送信される通知を配信します。
アプリケーションは、このメソッドを直接呼び出すのではなく、notifyPreloader
をかわりに使用して、混合コード・ダイアログの問題を回避する必要があります。
Preloaderクラスで提供されるこのメソッドの実装では何も行いません。
info
- アプリケーション生成通知public boolean handleErrorNotification(Preloader.ErrorNotification info)
Preloaderクラスによって提供されるこのメソッドの実装ではfalseが返され、デフォルトのエラー・ハンドラがメッセージをユーザーに表示する必要があることを示します。
info
- このエラーの原因を説明するエラー通知Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.