javax.jnlp
Interface DownloadServiceListener


public interface DownloadServiceListener

The DownloadServiceListener provides an interface for a callback object implementation, which may be used by a DownloadService implementation. The DownloadServiceListener implementation's methods should be invoked by the DownloadService implementation at various stages of the download, allowing an application that uses the JNLP API to display a progress bar during a DownloadService download.

Since:
1.0
See Also:
DownloadService

Method Summary
 void downloadFailed(java.net.URL url, java.lang.String version)
          A JNLP client's DownloadService implementation should call this method if a download fails or aborts unexpectedly.
 void progress(java.net.URL url, java.lang.String version, long readSoFar, long total, int overallPercent)
          A JNLP client's DownloadService implementation should call this method several times during a download.
 void upgradingArchive(java.net.URL url, java.lang.String version, int patchPercent, int overallPercent)
          A JNLP client's DownloadService implementation should call this method at least several times when applying an incremental update to an in-cache resource.
 void validating(java.net.URL url, java.lang.String version, long entry, long total, int overallPercent)
          A JNLP client's DownloadService implementation should call this method at least several times during validation of a download.
 

Method Detail

progress

void progress(java.net.URL url,
              java.lang.String version,
              long readSoFar,
              long total,
              int overallPercent)
A JNLP client's DownloadService implementation should call this method several times during a download. A DownloadServiceListener implementation may display a progress bar and / or update information based on the parameters.

Parameters:
url - The URL representing the resource being downloaded.
version - The version of the resource being downloaded.
readSoFar - The number of bytes downloaded so far.
total - The total number of bytes to be downloaded, or -1 if the number is unknown.
overallPercent - The percentage of the overall update operation that is complete, or -1 if the percentage is unknown.

validating

void validating(java.net.URL url,
                java.lang.String version,
                long entry,
                long total,
                int overallPercent)
A JNLP client's DownloadService implementation should call this method at least several times during validation of a download. Validation often includes ensuring that downloaded resources are authentic (appropriately signed). A DownloadServiceListener implementation may display a progress bar and / or update information based on the parameters.

Parameters:
url - The URL representing the resource being validated.
version - The version of the resource being validated.
entry - The number of JAR entries validated so far.
total - The total number of entries to be validated.
overallPercent - The percentage of the overall update operation that is complete, or -1 if the percentage is unknown.

upgradingArchive

void upgradingArchive(java.net.URL url,
                      java.lang.String version,
                      int patchPercent,
                      int overallPercent)
A JNLP client's DownloadService implementation should call this method at least several times when applying an incremental update to an in-cache resource. A DownloadServiceListener implementation may display a progress bar and / or update information based on the parameters.

Parameters:
url - The URL representing the resource being patched.
version - The version of the resource being patched.
patchPercent - The percentage of the patch operation that is complete, or -1 if the percentage is unknown.
overallPercent - The percentage of the overall update operation that is complete, or -1 if the percentage is unknown.

downloadFailed

void downloadFailed(java.net.URL url,
                    java.lang.String version)
A JNLP client's DownloadService implementation should call this method if a download fails or aborts unexpectedly. In response, a DownloadServiceListener implementation may display update information to the user to reflect this.

Parameters:
url - The URL representing the resource for which the download failed.
version - The version of the resource for which the download failed.


Copyright © 1998, 2011, Oracle and/or its affiliates. All rights reserved.