public interface DownloadServiceListener
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.DownloadService| Modifier and Type | Method | Description |
|---|---|---|
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. |
void progress(java.net.URL url,
java.lang.String version,
long readSoFar,
long total,
int overallPercent)
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.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.void validating(java.net.URL url,
java.lang.String version,
long entry,
long total,
int overallPercent)
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.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.void upgradingArchive(java.net.URL url,
java.lang.String version,
int patchPercent,
int overallPercent)
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.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.void downloadFailed(java.net.URL url,
java.lang.String version)
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.url - The URL representing the resource for which the download failed.version - The version of the resource for which the download failed.Copyright © 1998, 2025, Oracle and/or its affiliates. All rights reserved.