javax.jnlp
インタフェース ExtensionInstallerService


public interface ExtensionInstallerService

ExtensionInstallerService は、JNLP クライアントと通信を行うために拡張インストーラにより使用されます。また、次のような種類の機能を提供します。

インストーラのイベントの通常のシーケンスは次のとおりです。

  1. サービスの取得。ServiceManager.lookup("javax.jnlp.ExtensionInstallerService") を使用
  2. インストールの進行に応じた、状態、見出し、進捗の更新 (setStatussetHeading および updateProgress)
  3. JRE がインストールされているか、ライブラリがインストールされているかに応じて、setJREInfo または setNativeLibraryInfo を呼び出す
  4. 成功であれば installSucceeded が呼び出され、そうでない場合は installFailed を呼び出す

導入されたバージョン:
1.0

メソッドの概要
 java.net.URL getExtensionLocation()
          インストールされる拡張の位置を返します。
 java.lang.String getExtensionVersion()
          インストールされる拡張のバージョンを返します。
 java.lang.String getInstalledJRE(java.net.URL url, java.lang.String version)
          指定された JRE の実行可能ファイルへのパスを返します。
 java.lang.String getInstallPath()
          インストーラが拡張をインストールするように推奨されているディレクトリを返します。
 void hideProgressBar()
          進捗バーを非表示にします。
 void hideStatusWindow()
          状態ウィンドウを非表示にします。
 void installFailed()
          インストールが失敗したときに、このメソッドを呼び出す必要があります。
 void installSucceeded(boolean needsReboot)
          拡張のインストールが正常に終了したときに、インストーラはこのメソッドを呼び出す必要があります。
 void setHeading(java.lang.String heading)
          インストーラプロセスの状態を更新します。
 void setJREInfo(java.lang.String platformVersion, java.lang.String jrePath)
          JRE の実行可能ファイルへのパスを JNLP クライアントに通知します。
 void setNativeLibraryInfo(java.lang.String path)
          ネイティブライブラリを検索する必要があるディレクトリを JNLP クライアントに通知します。
 void setStatus(java.lang.String status)
          インストーラプロセスの状態を更新します。
 void updateProgress(int value)
          進捗バーを更新します。
 

メソッドの詳細

getInstallPath

java.lang.String getInstallPath()
インストーラが拡張をインストールするように推奨されているディレクトリを返します。このディレクトリへのインストーラによるインストールは必須ではなく、単に推奨パスです。


getExtensionVersion

java.lang.String getExtensionVersion()
インストールされる拡張のバージョンを返します。


getExtensionLocation

java.net.URL getExtensionLocation()
インストールされる拡張の位置を返します。


hideProgressBar

void hideProgressBar()
進捗バーを非表示にします。updateProgress への以降の呼び出しにより、進捗バーは強制的に可視になります。


hideStatusWindow

void hideStatusWindow()
状態ウィンドウを非表示にします。インストールの進捗に関してユーザに独自のフィードバックを提供する場合だけ、このメソッドを呼び出す必要があります。


setHeading

void setHeading(java.lang.String heading)
インストーラプロセスの状態を更新します。


setStatus

void setStatus(java.lang.String status)
インストーラプロセスの状態を更新します。


updateProgress

void updateProgress(int value)
進捗バーを更新します。

パラメータ:
value - 進捗バーの値 (0 〜 100)

installSucceeded

void installSucceeded(boolean needsReboot)
拡張のインストールが正常に終了したときに、インストーラはこのメソッドを呼び出す必要があります。これにより、JNLP クライアントは再度制御を獲得し、通常どおり操作を続行します。

パラメータ:
needsReboot - true の場合、再起動が必要

installFailed

void installFailed()
インストールが失敗したときに、このメソッドを呼び出す必要があります。JNLP クライアントは操作を続行し、インストールが失敗したことをユーザに通知します。


setJREInfo

void setJREInfo(java.lang.String platformVersion,
                java.lang.String jrePath)
JRE の実行可能ファイルへのパスを JNLP クライアントに通知します。これが JRE のインストーラの場合、この JRE が実装するプラットフォームバージョンについて通知します。


setNativeLibraryInfo

void setNativeLibraryInfo(java.lang.String path)
ネイティブライブラリを検索する必要があるディレクトリを JNLP クライアントに通知します。


getInstalledJRE

java.lang.String getInstalledJRE(java.net.URL url,
                                 java.lang.String version)
指定された JRE の実行可能ファイルへのパスを返します。このメソッドは、指定された JRE に関して情報を検索したり、指定された JRE を強化する必要がある拡張で使用できます。

パラメータ:
url - JRE の製品の位置
version - JRE の製品バージョン
戻り値:
指定された JRE の実行可能ファイルへのパス、JRE がインストールされていない場合は null


Copyright (c) 2004 Sun Microsystems, Inc. All Rights Reserved