javax.jnlp
インタフェース ExtensionInstallerService


public interface ExtensionInstallerService

ExtensionInstallerService は、拡張インストーラが JNLP クライアントとの通信に使用します。次の機能を備えています。

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

  1. ServiceManager.lookup("javax.jnlp.ExtensionInstallerService") を使用してサービスを開始する
  2. インストールの進行に伴ってステータス、ヘッダ、および進捗状況 (setStatussetHeadingupdateProgress) を更新する
  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 用のインストーラが使用されている場合は、JRE の実行可能ファイルへのパス、およびこの JRE によって実装されるプラットフォームのバージョン情報を JNLP クライアントに通知します。
 void setNativeLibraryInfo(java.lang.String path)
          ネイティブライブラリの検索対象となるディレクトリを JNLP クライアントに通知します。
 void setStatus(java.lang.String status)
          インストーラプロセスのステータスを更新します。
 void updateProgress(int value)
          進捗状況バーを更新します。
 

メソッドの詳細

getInstallPath

public java.lang.String getInstallPath()
インストーラが拡張機能をインストールするのに適したディレクトリを返します。インストーラは必ずしもこのディレクトリにインストールする必要はありません。これは推奨パスにすぎません。

getExtensionVersion

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

getExtensionLocation

public java.net.URL getExtensionLocation()
インストールされる拡張機能の場所を返します。

hideProgressBar

public void hideProgressBar()
進捗状況バーを非表示にします。その後で updateProgress を呼び出すと、進捗状況バーが強制的に表示されます。

hideStatusWindow

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

setHeading

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

setStatus

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

updateProgress

public void updateProgress(int value)
進捗状況バーを更新します。
パラメータ:
value - 進捗状況バーの値 - 0 〜 100 でなければなりません。

installSucceeded

public void installSucceeded(boolean needsReboot)
インストーラは、拡張機能のインストールが正常に行われた場合にこのメソッドを呼び出す必要があります。これによって、JNLP クライアントに制御が戻り、通常の操作が続行されます。
パラメータ:
needsReboot - true の場合は、リブートが必要

installFailed

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

setJREInfo

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

setNativeLibraryInfo

public void setNativeLibraryInfo(java.lang.String path)
ネイティブライブラリの検索対象となるディレクトリを JNLP クライアントに通知します。

getInstalledJRE

public java.lang.String getInstalledJRE(java.net.URL url,
                                        java.lang.String version)
指定された JRE の実行可能ファイルへのパスを返します。このメソッドは、特定の JRE の情報を検索するか、特定の JRE を強化する必要がある拡張機能によって使用されます。
パラメータ:
url - JRE の製品の場所
version - JRE の製品バージョン
戻り値:
指定された JRE の実行可能ファイルへのパス。JRE がインストールされていない場合は null


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