14 ロード動作のカスタマイズ

14.3.1 スプラッシュ画面の追加

RIAのロード動作をカスタマイズするもっとも単純な方法は、スプラッシュ画面を提供することです。スプラッシュ画面に表示すべきイメージを指定します。RIA自体への変更は一切不要です。RIAソフトウェアは、RIAのロード中はスプラッシュ画面を表示し、RIAのリソースのダウンロードと検証が完了するとその画面を隠します。詳細は、次のトピックを参照してください。

14.3.2 カスタマイズされたロード進捗インジケータの実装

デフォルトのロード進捗インジケータを、RIAのロード状況に関する定期的なフィードバックを提供するカスタム実装で置き換えることができます。矩形のボックスやSwing JProgressBarコンポーネントの使用にこだわらないでください。RIAやWebサイトにとって意味のある、カスタマイズされたロード進捗インジケータを開発できます。ロード進捗インジケータでは、RIAのバックグラウンドでのロード中にエンド・ユーザーの興味や注意を持続させるため、視覚的な方法や視覚的でない方法を使用できます。

14.3.3 javax.jnlp.DownloadServiceListenerインタフェース

14.3.4 ロード進捗インジケータ・クラスのコンストラクタ

ロード進捗インジケータ・クラス内で次のコンストラクタを指定します。RIAソフトウェアは、クライアント・マシン上のJREソフトウェアの機能に応じて適切なコンストラクタを呼び出します。すべてのリソースが最新であれば、RIAソフトウェアはロード進捗インジケータ・クラスをインスタンス化しない場合もあります。

• パラメータを1つも持たないコンストラクタ - Java Web Startアプリケーションのロード進捗インジケータ・クラスではこのコンストラクタを指定すべきです。アプレットのロード進捗インジケータ・クラス内でもこのコンストラクタを指定できます。RIAソフトウェアがこのコンストラクタを呼び出すと、javax.swing.JFrameオブジェクトなどのトップレベル・ウィンドウ内に、ロード進捗インジケータのUIが表示されます。

• 1つのパラメータを持つコンストラクタ - このコンストラクタはjava.lang.Object型のパラメータを1つ持ちます。このObject引数はjava.awt.Containerクラスのインスタンスに型キャストできます。このコンストラクタはアプレットのロード進捗インジケータに関連しています。RIAソフトウェア(この場合はJava Plug-inソフトウェア)がこのコンストラクタを呼び出すと、ロード進捗インジケータのUIがアプレットのコンテナに表示されます。

• 2つのパラメータを持つコンストラクタ - このコンストラクタはjava.lang.Object型のパラメータを2つ持ちます。最初のObject引数はjava.awt.Containerクラスのインスタンスに型キャストできます。2番目のObject引数はjava.applet.AppletStubクラスのインスタンスに型キャストできます。RIAソフトウェア(この場合はJava Plug-inソフトウェア)がこのコンストラクタを呼び出すと、ロード進捗インジケータのUIがアプレットのコンテナに表示されます。ロード進捗インジケータは、java.applet.AppletContextオブジェクトにアクセスして自身をさらにカスタマイズできます。このコンストラクタはアプレットのロード進捗インジケータに関連しています。

  2つのパラメータを持つコンストラクタを指定するときは、古いバージョンのクライアントJREソフトウェアに対応できるように、単一パラメータのコンストラクタも指定することをお薦めします。2つのパラメータを持つコンストラクタが呼び出されるのは、クライアントJREソフトウェアのバージョンがJava SE 6 update 21以上の場合だけです。

14.3.5 javax.jnlp.DownloadServiceListenerインタフェースのメソッド

ロード進捗インジケータ・クラスは、インタフェースの次の各メソッドを実装することで、最新の進捗情報の受信と伝達を行えるようにすべきです。

• progress(URL url, String version, long readSoFar, long total, int overallPercent)

• upgradingArchive(java.net.URL url, java.lang.String version, int patchPercent, int overallPercent)

• validating(java.net.URL url, java.lang.String version, long entry, long total, int overallPercent) - ロード進捗インジケータ・クラスがインスタンス化される際には常に、値100がoverallPercentに指定されてこのメソッドが呼び出されます。

これらのメソッドで受け取ったoverallPercentの値に基づいて、ロード進捗インジケータ内の進捗情報を更新します。

14.3.6 JNLPファイル内でのカスタム進捗インジケータの指定

ロード進捗インジケータを指定するには、RIAのJava Network Launch Protocol (JNLP)ファイル内に次の情報を含めます。

• ロード進捗インジケータ・クラスがどのJARファイルに含まれているかを示すdownload="progress"属性

• ロード進捗インジケータ・クラスの完全修飾名を含むprogress-class属性。この属性は、RIAやロード進捗インジケータの配備方法に応じて<applet-desc>、<application-desc>、<component-desc>のいずれかの一部として定義できます。

アプレットのサンプルJNLPファイルを次に示します。

<jnlp spec="1.0+" codebase="" href="">
...
 <resources>
 ...
 <jar href="MyApplet.jar" main="true" /> 
<jar href="CustomProgressIndicator.jar" download="progress" />
 </resources>

 <applet-desc
 name="MyFavoriteApplet"
 main-class="myAppletPackage.MyFavoriteApplet"
 progress-class="myCustomProgressPackage.MyCustomProgressIndicator"
 width="600"
 height="200">
 </applet-desc>
...
</jnlp>

14.3.7 RIAソフトウェアが進捗を伝える方法

RIAソフトウェアは次のようにして進捗情報を伝えます。

• RIAソフトウェアは必要に応じてロード進捗インジケータをインスタンス化します。すべてのリソースがキャッシュ済みで最新の状態になっている場合、ロード進捗インジケータがまったくインスタンス化されないことがあります。

• RIAソフトウェアはprogress、upgradingArchive、validatingメソッドを何回か呼び出しますが、その際、overallPercentには前回よりも大きな値が指定されます。

• リソースがすでにキャッシュ済みかつ検証済みの場合、RIAソフトウェアは、単純にコンストラクタを呼び出したあとで100%完了メッセージを送信することがあります。

• RIAソフトウェアは常に100%完了メッセージをロード進捗インジケータに送信します。