-
public interface ExtensionInstallerService
ExtensionInstallerService
は、JNLPクライアントと通信を行うために拡張インストーラにより使用されます。 また、次のような種類の機能を提供します。- 推奨インストール場所およびその他JNLPクライアントに関する情報へのアクセス
- JNLPクライアントのダウンロード画面の操作
- インストールされたコードを使ってJNLPクライアントを更新するためのメソッド
インストーラのイベントの通常のシーケンスは次のとおりです。
ServiceManager.lookup("javax.jnlp.ExtensionInstallerService")
を使ってサービスを取得する。- インストールの進行に応じて、状態、見出し、進捗を更新する(
setStatus
、setHeading
およびupdateProgress
)。 - JREがインストールされているか、ライブラリがインストールされているかに応じて、
setJREInfo
またはsetNativeLibraryInfo
を呼び出す。 - 成功であれば
installSucceeded
を呼び出し、そうでない場合はinstallFailed
を呼び出す。
- 導入されたバージョン:
- 1.4.2
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 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クライアントに通知します。これがJREのインストーラの場合、このJREが実装するプラットフォーム・バージョンについて通知します。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)
進行状況ウィンドウの見出しテキストを更新します。- パラメータ:
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
- ネイティブ・ライブラリの検索パス
-
-