javax.jnlp
インタフェース ExtensionInstallerService

public interface ExtensionInstallerService

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

• 推奨インストール場所およびその他 JNLP クライアントに関する情報へのアクセス
• JNLP クライアントのダウンロード画面の操作
• インストールされたコードを使って JNLP クライアントを更新するためのメソッド

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

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

導入されたバージョン:

1.0

メソッドの概要

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

メソッドの詳細

getInstallPath

String getInstallPath()

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

getExtensionVersion

String getExtensionVersion()

インストールされる拡張のバージョンを返します。

getExtensionLocation

URL getExtensionLocation()

インストールされる拡張の位置を返します。

hideProgressBar

void hideProgressBar()

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

hideStatusWindow

void hideStatusWindow()

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

setHeading

void setHeading(String heading)

インストーラプロセスの状態を更新します。

setStatus

void setStatus(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(String platformVersion,
                String jrePath)

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

setNativeLibraryInfo

void setNativeLibraryInfo(String path)

ネイティブライブラリを検索する必要があるディレクトリを JNLP クライアントに通知します。

getInstalledJRE

String getInstalledJRE(URL url,
                       String version)

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

パラメータ:

url - JRE の製品の位置

version - JRE の製品バージョン

戻り値:

指定された JRE の実行可能ファイルへのパス、JRE がインストールされていない場合は null