javax.jnlp
インタフェース DownloadServiceListener


public interface DownloadServiceListener

DownloadServiceListener は、コールバックオブジェクト実装のインタフェースを提供します。このインタフェースは、DownloadService 実装により使用されます。DownloadServiceListener 実装のメソッドは、ダウンロードの種々のステージで DownloadService により呼び出されます。これにより、JNLP API を使用するアプリケーションは DownloadService ダウンロードの間に進捗バーを表示できます。

導入されたバージョン:
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

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

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

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

void downloadFailed(java.net.URL url,
                    java.lang.String version)
JNLP クライアントの DownloadService 実装は、ダウンロードが失敗したり、予期しない中断が発生したりしたときに、このメソッドを呼び出す必要があります。DownloadServiceListener 実装は、ユーザに更新情報を表示して、ダウンロードの失敗や中断を反映することができます。

パラメータ:
url - ダウンロードが失敗したリソースを表す URL
version - ダウンロードが失敗したリソースのバージョン


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