-
public interface ExtensionInstallerServiceExtensionInstallerServiceは、JNLPクライアントと通信を行うために拡張インストーラにより使用されます。 また、次のような種類の機能を提供します。- 推奨インストール場所およびその他JNLPクライアントに関する情報へのアクセス
- JNLPクライアントのダウンロード画面の操作
- インストールされたコードを使ってJNLPクライアントを更新するためのメソッド
インストーラのイベントの通常のシーケンスは次のとおりです。
ServiceManager.lookup("javax.jnlp.ExtensionInstallerService")を使ってサービスを取得する。- インストールの進行に応じて、状態、見出し、進捗を更新する(
setStatus、setHeadingおよびupdateProgress)。 - JREがインストールされているか、ライブラリがインストールされているかに応じて、
setJREInfoまたはsetNativeLibraryInfoを呼び出す。 - 成功であれば
installSucceededを呼び出し、そうでない場合はinstallFailedを呼び出す。
- 導入されたバージョン:
- 1.4.2
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 URLgetExtensionLocation()インストールされる拡張の位置を返します。StringgetExtensionVersion()インストールされる拡張のバージョンを返します。StringgetInstalledJRE(URL url, String version)指定されたJREの実行可能ファイルへのパスを返します。StringgetInstallPath()インストーラが拡張をインストールするように推奨されているディレクトリを返します。voidhideProgressBar()進捗バーを非表示にします。voidhideStatusWindow()状態ウィンドウを非表示にします。voidinstallFailed()インストールが失敗したときに、このメソッドを呼び出す必要があります。voidinstallSucceeded(boolean needsReboot)インストーラは、拡張機能が正常にインストールされたときにこれを呼び出す必要があります。voidsetHeading(String heading)進行状況ウィンドウの見出しテキストを更新します。voidsetJREInfo(String platformVersion, String jrePath)JREの実行可能ファイルへのパスをJNLPクライアントに通知します。これがJREのインストーラの場合、このJREが実装するプラットフォーム・バージョンについて通知します。voidsetNativeLibraryInfo(String path)ネイティブ・ライブラリを検索する必要があるディレクトリをJNLPクライアントに通知します。voidsetStatus(String status)進行状況ウィンドウのステータス・テキストを更新します。voidupdateProgress(int value)進捗バーを更新します。
-
-
-
メソッドの詳細
-
getInstallPath
String getInstallPath()
インストーラが拡張をインストールするように推奨されているディレクトリを返します。 このディレクトリへのインストーラによるインストールは必須ではなく、単に推奨パスです。- 戻り値:
- インストーラが拡張機能のインストールを推奨するディレクトリ
-
getExtensionVersion
String getExtensionVersion()
インストールされる拡張のバージョンを返します。- 戻り値:
- インストールされている拡張機能のバージョン
-
getExtensionLocation
URL getExtensionLocation()
インストールされる拡張の位置を返します。- 戻り値:
- 拡張機能がインストールされているロケーション
-
hideProgressBar
void hideProgressBar()
進捗バーを非表示にします。updateProgressへの以降の呼出しにより、進捗バーは強制的に可視になります。
-
hideStatusWindow
void hideStatusWindow()
状態ウィンドウを非表示にします。 インストールの進捗に関してユーザーに独自のフィード・バックを提供する場合だけ、このメソッドを呼び出す必要があります。
-
setHeading
void setHeading(String heading)
進行状況ウィンドウの見出しテキストを更新します。- パラメータ:
heading- 見出しテキスト
-
setStatus
void setStatus(String status)
進行状況ウィンドウのステータス・テキストを更新します。- パラメータ:
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が実装するプラットフォーム・バージョンについて通知します。- パラメータ:
platformVersion- このJRE実装のプラットフォーム・バージョンjrePath- JREの実行可能ファイルへのパス
-
setNativeLibraryInfo
void setNativeLibraryInfo(String path)
ネイティブ・ライブラリを検索する必要があるディレクトリをJNLPクライアントに通知します。- パラメータ:
path- ネイティブ・ライブラリの検索パス
-
-