Module java.jnlp

软件包 javax.jnlp

Interface DownloadService

public interface DownloadService

DownloadService服务允许应用程序控制自己的资源如何缓存，以确定当前缓存哪些资源，强制资源被缓存，以及从缓存中删除资源。 JNLP客户端负责提供此服务的具体实现。

从以下版本开始：

1.4.2

方法摘要

Modifier and Type	方法	描述
DownloadServiceListener	getDefaultProgressWindow()	返回一个默认的DownloadServiceListener实现，当传递给一个load方法时，应该在加载进度时弹出并更新进度窗口。
boolean	isExtensionPartCached(URL ref, String version, String part)	如果给定的扩展名的给定部分被缓存，并且在应用程序的JNLP文件中提到扩展名和部分，则返回 true 。
boolean	isExtensionPartCached(URL ref, String version, String[] parts)	如果给定的扩展名的给定部分被缓存，并且在应用程序的JNLP文件中提及扩展和部件，则返回 true 。
boolean	isPartCached(String part)	如果给定字符串引用的部分被缓存，并且该部分在应用程序的JNLP文件中被提到，则返回 true 。
boolean	isPartCached(String[] parts)	如果给定数组引用的部分被缓存，并且这些部分在应用程序的JNLP文件中被提到，则返回 true 。
boolean	isResourceCached(URL ref, String version)	如果给定的URL和版本引用的资源被缓存，并且该资源在调用应用程序JNLP文件中被提及，则在调用应用程序JNLP文件的代码库中，或者调用应用程序已被授予所有权限，则返回true 。 。
void	loadExtensionPart(URL ref, String version, String[] parts, DownloadServiceListener progress)	如果在应用程序的JNLP文件中提到了部件和扩展名，请下载给定扩展的给定部分。
void	loadExtensionPart(URL ref, String version, String part, DownloadServiceListener progress)	如果在应用程序的JNLP文件中提到了部分和扩展名，请下载给定扩展的给定部分。
void	loadPart(String[] parts, DownloadServiceListener progress)	如果在应用程序的JNLP文件中提到了这些部分，请下载给定的部分。
void	loadPart(String part, DownloadServiceListener progress)	下载给定的部分，如果该部分在应用程序的JNLP文件中被提到。
void	loadResource(URL ref, String version, DownloadServiceListener progress)	如果在调用的应用程序JNLP文件中提到资源，请下载给定的资源，是在调用应用程序JNLP文件的代码库内，或者如果调用应用程序已被授予全部权限。
void	removeExtensionPart(URL ref, String version, String part)	如果在应用程序的JNLP文件中提到了部分和扩展名，则从缓存中删除给定扩展的给定部分。
void	removeExtensionPart(URL ref, String version, String[] parts)	如果在应用程序的JNLP文件中提到了部件和扩展名，则从缓存中删除给定扩展的给定部分。
void	removePart(String part)	如果在应用程序的JNLP文件中提到了该部分，则从缓存中删除给定的部分。
void	removePart(String[] parts)	如果在应用程序的JNLP文件中提到了这些部分，则从缓存中删除给定的部分。
void	removeResource(URL ref, String version)	如果在调用应用程序JNLP文件中提到资源，则从缓存中删除给定的资源，在调用的应用程序JNLP文件的代码库内，或者如果调用应用程序已被授予全部权限。

方法详细信息

isResourceCached

boolean isResourceCached(URL ref,
                         String version)

如果给定的URL和版本引用的资源被缓存，并且该资源在调用应用程序JNLP文件中被提及，则在调用应用程序JNLP文件的代码库中，或者调用应用程序已被授予所有权限，则返回true 。 。

参数

ref - 资源的URL。

version - 版本字符串，或 null ，无版本。

结果

true如果满足上述条件，并且 false否则。

isPartCached

boolean isPartCached(String part)

如果给定字符串引用的部分被缓存，并且该部分在应用程序的JNLP文件中被提到，则返回 true 。

参数

part - 零件的名称。

结果

true如果满足上述条件，并且 false否则。

isPartCached

boolean isPartCached(String[] parts)

如果给定数组引用的部分被缓存，并且这些部分在应用程序的JNLP文件中被提到，则返回 true 。

参数

parts - 部件名称数组。

结果

true如果满足上述条件，并且 false否则。

isExtensionPartCached

boolean isExtensionPartCached(URL ref,
                              String version,
                              String part)

如果给定的扩展名的给定部分被缓存，并且扩展名和部分在JNLP文件中被提及，则返回 true 。

参数

ref - 资源的URL。

version - 版本字符串，或 null ，无版本。

part - 零件的名称。

结果

true如果满足上述条件，并且 false否则。

isExtensionPartCached

boolean isExtensionPartCached(URL ref,
                              String version,
                              String[] parts)

如果给定扩展的给定部分被缓存，并且在应用程序的JNLP文件中提到扩展和部件，则返回 true 。

参数

ref - 资源的URL。

version - 版本字符串，或 null ，无版本。

parts - 零件名称数组。

结果

true如果满足上述条件，并且 false否则。

loadResource

void loadResource(URL ref,
                  String version,
                  DownloadServiceListener progress)
           throws IOException

如果在调用的应用程序JNLP文件中提到资源，请下载给定的资源，是在调用应用程序JNLP文件的代码库内，或者如果调用应用程序已被授予全部权限。 此方法将阻塞，直到下载完成或发生异常。

参数

ref - 资源的URL。

version - 版本字符串，或 null ，无版本。

progress - 下载进度回调对象。

异常

IOException - 如果发生I / O错误

loadPart

void loadPart(String part,
              DownloadServiceListener progress)
       throws IOException

下载给定的部分，如果该部分在应用程序的JNLP文件中被提到。 此方法将阻塞，直到下载完成或发生异常。

参数

part - 零件的名称。

progress - 下载进度回调对象。

异常

IOException - 如果发生I / O错误

loadPart

void loadPart(String[] parts,
              DownloadServiceListener progress)
       throws IOException

如果在应用程序的JNLP文件中提到了这些部分，请下载给定的部分。 此方法将阻塞，直到下载完成或发生异常。

参数

parts - 零件名称数组。

progress - 下载进度回调对象。

异常

IOException - 如果发生I / O错误

loadExtensionPart

void loadExtensionPart(URL ref,
                       String version,
                       String part,
                       DownloadServiceListener progress)
                throws IOException

如果在应用程序的JNLP文件中提到了部分和扩展名，请下载给定扩展的给定部分。 此方法将阻塞，直到下载完成或发生异常。

参数

ref - 资源的URL。

version - 版本字符串，或 null ，无版本。

part - 零件的名称。

progress - 下载进度回调对象。

异常

IOException - 如果发生I / O错误

loadExtensionPart

void loadExtensionPart(URL ref,
                       String version,
                       String[] parts,
                       DownloadServiceListener progress)
                throws IOException

如果在应用程序的JNLP文件中提到了部件和扩展名，请下载给定扩展的给定部分。 此方法将阻塞，直到下载完成或发生异常。

参数

ref - 资源的URL。

version - 版本字符串，或 null ，无版本。

parts - 要加载的零件名称数组。

progress - 下载进度回调对象。

异常

IOException - 如果发生I / O错误

removeResource

void removeResource(URL ref,
                    String version)
             throws IOException

如果在调用应用程序JNLP文件中提到资源，则从缓存中删除给定的资源，在调用的应用程序JNLP文件的代码库内，或者如果调用应用程序已被授予全部权限。

参数

ref - 资源的URL。

version - 版本字符串，或 null无版本。

异常

IOException - 如果发生I / O错误

removePart

void removePart(String part)
         throws IOException

如果在应用程序的JNLP文件中提到了该部分，则从缓存中删除给定的部分。

参数

part - 零件的名称。

异常

IOException - 如果发生I / O错误

removePart

void removePart(String[] parts)
         throws IOException

如果在应用程序的JNLP文件中提到了这些部分，则从缓存中删除给定的部分。

参数

parts - 零件名称数组。

异常

IOException - 如果发生I / O错误

removeExtensionPart

void removeExtensionPart(URL ref,
                         String version,
                         String part)
                  throws IOException

如果在应用程序的JNLP文件中提到了部分和扩展名，则从缓存中删除给定扩展的给定部分。

参数

ref - 资源的URL。

version - 版本字符串，或 null ，无版本。

part - 零件的名称。

异常

IOException - 如果发生I / O错误

removeExtensionPart

void removeExtensionPart(URL ref,
                         String version,
                         String[] parts)
                  throws IOException

如果在应用程序的JNLP文件中提到了部件和扩展名，则从缓存中删除给定扩展的给定部分。

参数

ref - 资源的URL。

version - 版本字符串，或 null ，无版本。

parts - 零件名称数组。

异常

IOException - 如果发生I / O错误

getDefaultProgressWindow

DownloadServiceListener getDefaultProgressWindow()

返回一个默认的DownloadServiceListener实现，当传递给一个load方法时，应该在加载进度时弹出并更新进度窗口。

结果

A DownloadServiceListener object representing a download progress listener.