javax.jnlp
インタフェース DownloadServiceListener


public interface DownloadServiceListener

DownloadServiceListener は、DownloadService の実装で使用されるコールバックオブジェクトを実装するためのインタフェースを提供します。DownloadService の実装では、ダウンロードのさまざまな段階で DownloadServiceListener のメソッドを呼び出す必要があります。これらのメソッドによって、DownloadService のダウンロード時に、JNLP API を使用するアプリケーションで進捗状況バーを表示することができます。

バージョン:
1.0
関連項目:
DownloadService

メソッドの概要
 void downloadFailed(java.net.URL url, java.lang.String version)
          JNLP クライアントの DownloadService の実装では、ダウンロードが失敗したり、途中で異常終了した場合に、このメソッドを呼び出す必要があります。
 void progress(java.net.URL url, java.lang.String version, long readSoFar, long total, int overallPercent)
          JNLP クライアントの DownloadService の実装では、ダウンロード時にこのメソッドを数回呼び出す必要があります。
 void upgradingArchive(java.net.URL url, java.lang.String version, int patchPercent, int overallPercent)
          JNLP クライアントの DownloadService の実装では、キャッシュ内のリソースに追加更新を適用するときに、このメソッドを最低でも数回呼び出す必要があります。
 void validating(java.net.URL url, java.lang.String version, long entry, long total, int overallPercent)
          JNLP クライアントの DownloadService の実装では、ダウンロードの妥当性検査時にこのメソッドを最低でも数回呼び出す必要があります。
 

メソッドの詳細

progress

public void progress(java.net.URL url,
                     java.lang.String version,
                     long readSoFar,
                     long total,
                     int overallPercent)
JNLP クライアントの DownloadService の実装では、ダウンロード時にこのメソッドを数回呼び出す必要があります。DownloadServiceListener の実装では、パラメータに基づいて進捗状況バーや更新情報を表示できます。
パラメータ:
url - ダウンロードされるリソースを表す URL
version - ダウンロードされるリソースのバージョン
readSoFar - これまでにダウンロードされたバイト数
total - ダウンロードされる合計バイト数。バイト数が不明の場合は -1
overallPercent - 完了した更新操作全体のパーセンテージ。パーセンテージが不明の場合は -1

validating

public void validating(java.net.URL url,
                       java.lang.String version,
                       long entry,
                       long total,
                       int overallPercent)
JNLP クライアントの DownloadService の実装では、ダウンロードの妥当性検査時にこのメソッドを最低でも数回呼び出す必要があります。妥当性検査では、ダウンロードされたリソースの信頼性 (署名が適切であること) がよく確認されます。DownloadServiceListener の実装では、パラメータに基づいて進捗状況バーや更新情報を表示できます。
パラメータ:
url - 妥当性検査が行われるリソースを表す URL
version - 妥当性検査が行われるリソースのバージョン
entry - これまでに妥当性検査が行われた JAR エントリの数
total - 妥当性検査が行われるエントリの合計数
overallPercent - 完了した更新操作全体のパーセンテージ。パーセンテージが不明の場合は -1

upgradingArchive

public void upgradingArchive(java.net.URL url,
                             java.lang.String version,
                             int patchPercent,
                             int overallPercent)
JNLP クライアントの DownloadService の実装では、キャッシュ内のリソースに追加更新を適用するときに、このメソッドを最低でも数回呼び出す必要があります。DownloadServiceListener の実装では、パラメータに基づいて進捗状況バーや更新情報を表示できます。
パラメータ:
url - パッチをあてるリソースを表す URL
version - パッチをあてるリソースのバージョン
patchPercent - 完了したパッチ操作の占めるパーセンテージ。パーセンテージが不明の場合は -1
overallPercent - 完了した更新操作全体のパーセンテージ。パーセンテージが不明の場合は -1

downloadFailed

public void downloadFailed(java.net.URL url,
                           java.lang.String version)
JNLP クライアントの DownloadService の実装では、ダウンロードが失敗したり、途中で異常終了した場合に、このメソッドを呼び出す必要があります。それを受けて DownloadServiceListener の実装では、更新情報をユーザに表示して、反映させることができます。
パラメータ:
url - ダウンロードに失敗したリソースを表す URL
version - ダウンロードに失敗したリソースのバージョン


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