Module  java.jnlp
软件包  javax.jnlp

Interface DownloadServiceListener


  • public interface DownloadServiceListener
    DownloadServiceListener提供了一个回调对象实现的接口，可以由一个DownloadService实现使用。 DownloadServiceListener实现的方法应由DownloadService实现在不同的下载阶段调用，允许使用JNLP API的应用程序在DownloadService下载期间显示进度条。
    从以下版本开始：
    1.4.2
    另请参见：
    DownloadService

    • 方法摘要

      所有方法  接口方法  抽象方法 
      Modifier and Type 方法 描述
      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实现应该在下载过程中多次调用此方法。 A DownloadServiceListener实现可以基于参数显示进度条和/或更新信息。
        参数
        url - 表示正在下载的资源的URL。
        version - 正在下载的资源的版本。
        readSoFar - 到目前为止下载的字节数。
        total - 要下载的字节总数，如果数字未知，则为-1。
        overallPercent - 完整更新操作的百分比，如果百分比未知，则为-1。

      • validating

        void validating​(URL url,
                String version,
                long entry,
                long total,
                int overallPercent)
        JNLP客户端的DownloadService实现在验证下载过程中应至少调用此方法。 验证通常包括确保下载的资源是真实的（适当签名的）。 A DownloadServiceListener实现可以基于参数显示进度条和/或更新信息。
        参数
        url - 表示正在验证的资源的URL。
        version - 要验证的资源的版本。
        entry - 到目前为止验证的JAR条目数。
        total - 要验证的条目总数。
        overallPercent - 完整更新操作的百分比，如果百分比未知，则为-1。

      • upgradingArchive

        void upgradingArchive​(URL url,
                      String version,
                      int patchPercent,
                      int overallPercent)
        JNLP客户端的DownloadService实现在将缓存资源应用增量更新时至少应该调用此方法。 A DownloadServiceListener实现可以基于参数显示进度条和/或更新信息。
        参数
        url - 表示正在修补的资源的URL。
        version - 正在修补的资源的版本。
        patchPercent - 完成补丁操作的百分比，如果百分比未知，则为-1。
        overallPercent - 完整更新操作的百分比，如果百分比未知，则为-1。

      • downloadFailed

        void downloadFailed​(URL url,
                    String version)
        如果下载失败或意外中止，JNLP客户端的DownloadService实现应该调用此方法。 作为响应， DownloadServiceListener实现可以向用户显示更新信息以反映这一点。
        参数
        url - 表示下载失败的资源的URL。
        version - 下载失败的资源的版本。