モジュール java.jnlp
パッケージ javax.jnlp

インタフェースDownloadServiceListener



  • public interface DownloadServiceListener
    DownloadServiceListenerは、コールバック・オブジェクト実装のインタフェースを提供します。これは、DownloadService実装で使用されることがあります。 DownloadServiceListener実装のメソッドは、ダウンロードの様々なステージでDownloadService実装により呼び出されます。これにより、JNLP APIを使用するアプリケーションはDownloadServiceでのダウンロード中に進捗バーを表示できます。
    導入されたバージョン:
    1.4.2
    関連項目:
    DownloadService
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 
      修飾子と型 メソッド 説明
      void downloadFailed​(URL url, String version)
      JNLPクライアントのDownloadService実装は、ダウンロードが失敗したり、予期しない中断が発生したりしたときに、このメソッドを呼び出す必要があります。
      void progress​(URL url, String version, long readSoFar, long total, int overallPercent)
      JNLPクライアントのDownloadService実装は、ダウンロードの間にこのメソッドを複数回呼び出す必要があります。
      void upgradingArchive​(URL url, String version, int patchPercent, int overallPercent)
      JNLPクライアントのDownloadService実装は、キャッシュ内リソースへの差分更新の適用時にこのメソッドを複数回呼び出す必要があります。
      void validating​(URL url, String version, long entry, long total, int overallPercent)
      JNLPクライアントのDownloadService実装は、ダウンロードの検証の間にこのメソッドを少なくとも数回呼び出す必要があります。
    • メソッドの詳細

      • progress

        void progress​(URL url,
                      String version,
                      long readSoFar,
                      long total,
                      int overallPercent)
        JNLPクライアントのDownloadService実装は、ダウンロードの間にこのメソッドを複数回呼び出す必要があります。 DownloadServiceListener実装は、パラメータに基づいて進捗バーや更新情報を表示できます。
        パラメータ:
        url - ダウンロードされているリソースを表すURL。
        version - ダウンロードされているリソースのバージョン。
        readSoFar - 現時点でダウンロードされたバイト数。
        total - ダウンロードされる合計バイト数、未知の場合は -1。
        overallPercent - 完了した更新操作の割合、割合が未知の場合は -1。
      • validating

        void validating​(URL url,
                        String version,
                        long entry,
                        long total,
                        int overallPercent)
        JNLPクライアントのDownloadService実装は、ダウンロードの検証の間にこのメソッドを少なくとも数回呼び出す必要があります。 検証では、通常、ダウンロードされたリソースが認証されているか(適切な署名がされているか)が確認されます。 DownloadServiceListener実装は、パラメータに基づいて進捗バーや更新情報を表示できます。
        パラメータ:
        url - 検証されているリソースを表すURL。
        version - 検証されているリソースのバージョン。
        entry - 現時点で検証されたJARエントリの数。
        total - まだ検証されていないエントリの合計数。
        overallPercent - 完了した更新操作の割合、割合が未知の場合は -1。
      • upgradingArchive

        void upgradingArchive​(URL url,
                              String version,
                              int patchPercent,
                              int overallPercent)
        JNLPクライアントのDownloadService実装は、キャッシュ内リソースへの差分更新の適用時にこのメソッドを複数回呼び出す必要があります。 DownloadServiceListener実装は、パラメータに基づいて進捗バーや更新情報を表示できます。
        パラメータ:
        url - パッチを適用されているリソースを表すURL。
        version - パッチを適用されているリソースのバージョン。
        patchPercent - 完了したパッチ操作の割合、割合が未知の場合は -1。
        overallPercent - 完了した更新操作の割合、割合が未知の場合は -1。
      • downloadFailed

        void downloadFailed​(URL url,
                            String version)
        JNLPクライアントのDownloadService実装は、ダウンロードが失敗したり、予期しない中断が発生したりしたときに、このメソッドを呼び出す必要があります。 それに応じて、DownloadServiceListener実装は、ユーザーに更新情報を表示し、ダウンロードの失敗や中断を反映できます。
        パラメータ:
        url - ダウンロードが失敗したリソースを表すURL。
        version - ダウンロードが失敗したリソースのバージョン。