javax.jnlp

インタフェースDownloadService

public interface DownloadService

アプリケーションはDownloadServiceサービスを使うことで、自身のリソースがキャッシュされる方法の制御、現在どのリソースがキャッシュされているかの判定、リソースの強制キャッシュ、およびキャッシュからのリソースの削除を行うことが可能になります。JNLP Clientによって、このサービス特有の実装が提供されます。

導入されたバージョン:

1.4.2

メソッドのサマリー

修飾子と型	メソッドと説明
DownloadServiceListener	getDefaultProgressWindow() loadメソッドに渡されると進捗ウィンドウをポップアップし、ロードの進行に従ってこのウィンドウを更新する、デフォルトのDownloadServiceListener実装を返します。
boolean	isExtensionPartCached(java.net.URL ref, java.lang.String version, java.lang.String part) 指定された拡張の指定された部分がキャッシュされる場合は、trueを返します。この拡張と部分は、アプリケーションのJNLPファイルで言及されます。
boolean	isExtensionPartCached(java.net.URL ref, java.lang.String version, java.lang.String[] parts) 指定された拡張の指定された複数の部分がキャッシュされる場合は、trueを返します。この拡張と複数の部分は、アプリケーションのJNLPファイルで言及されます。
boolean	isPartCached(java.lang.String part) 指定された文字列によって参照される部分がキャッシュされる場合は、trueを返します。この部分は、アプリケーションのJNLPファイルで言及されます。
boolean	isPartCached(java.lang.String[] parts) 指定された配列によって参照される部分がキャッシュされる場合は、trueを返します。この部分は、アプリケーションのJNLPファイルで言及されます。
boolean	isResourceCached(java.net.URL ref, java.lang.String version) 指定されたURLによって参照されるリソースとバージョンがキャッシュされ、このリソースが呼出し側のアプリケーションのJNLPファイルで言及されているか、呼出し側のアプリケーションのJNLPファイルのコード・ベースに含まれているか、呼出し側のアプリケーションにすべてのアクセス権が付与されている場合は、trueを返します。
void	loadExtensionPart(java.net.URL ref, java.lang.String version, java.lang.String[] parts, DownloadServiceListener progress) 複数の部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された複数の部分をダウンロードします。
void	loadExtensionPart(java.net.URL ref, java.lang.String version, java.lang.String part, DownloadServiceListener progress) 部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された部分をダウンロードします。
void	loadPart(java.lang.String[] parts, DownloadServiceListener progress) 複数の部分がアプリケーションのJNLPファイルで言及されている場合、指定された複数の部分をダウンロードします。
void	loadPart(java.lang.String part, DownloadServiceListener progress) 部分がアプリケーションのJNLPファイルで言及されている場合、指定された部分をダウンロードします。
void	loadResource(java.net.URL ref, java.lang.String version, DownloadServiceListener progress) リソースが呼出し側のアプリケーションのJNLPファイルで言及されているか、呼出し側のアプリケーションのJNLPファイルのコード・ベースに含まれているか、呼出し側のアプリケーションにすべてのアクセス権が付与されている場合に、指定されたリソースをダウンロードします。
void	removeExtensionPart(java.net.URL ref, java.lang.String version, java.lang.String part) 部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された部分を削除します。
void	removeExtensionPart(java.net.URL ref, java.lang.String version, java.lang.String[] parts) 複数の部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された複数の部分を削除します。
void	removePart(java.lang.String part) 部分がアプリケーションのJNLPファイルで言及されている場合、キャッシュから指定された部分を削除します。
void	removePart(java.lang.String[] parts) 複数部分がアプリケーションのJNLPファイルで言及されている場合、キャッシュから指定された複数の部分を削除します。
void	removeResource(java.net.URL ref, java.lang.String version) リソースが呼出し側のアプリケーションのJNLPファイルで言及されているか、呼出し側のアプリケーションのJNLPファイルのコード・ベースに含まれているか、呼出し側のアプリケーションにすべてのアクセス権が付与されている場合に、指定されたリソースをキャッシュから削除します。

メソッドの詳細

isResourceCached

boolean isResourceCached(java.net.URL ref,
                         java.lang.String version)

指定されたURLによって参照されるリソースとバージョンがキャッシュされ、このリソースが呼出し側のアプリケーションのJNLPファイルで言及されているか、呼出し側のアプリケーションのJNLPファイルのコード・ベースに含まれているか、呼出し側のアプリケーションにすべてのアクセス権が付与されている場合は、trueを返します。.

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

戻り値:

上記条件を満たす場合はtrue、そうでない場合はfalse。

isPartCached

boolean isPartCached(java.lang.String part)

指定された文字列によって参照される部分がキャッシュされる場合は、trueを返します。この部分は、アプリケーションのJNLPファイルで言及されます。

パラメータ:

part - 部分の名前。

戻り値:

上記条件を満たす場合はtrue、そうでない場合はfalse。

isPartCached

boolean isPartCached(java.lang.String[] parts)

指定された配列によって参照される部分がキャッシュされる場合は、trueを返します。この部分は、アプリケーションのJNLPファイルで言及されます。

パラメータ:

parts - 部分の名前の配列。

戻り値:

上記条件を満たす場合はtrue、そうでない場合はfalse。

isExtensionPartCached

boolean isExtensionPartCached(java.net.URL ref,
                              java.lang.String version,
                              java.lang.String part)

指定された拡張の指定された部分がキャッシュされる場合は、trueを返します。この拡張と部分は、アプリケーションのJNLPファイルで言及されます。

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

part - 部分の名前。

戻り値:

上記条件を満たす場合はtrue、そうでない場合はfalse。

isExtensionPartCached

boolean isExtensionPartCached(java.net.URL ref,
                              java.lang.String version,
                              java.lang.String[] parts)

指定された拡張の指定された複数の部分がキャッシュされる場合は、trueを返します。この拡張と複数の部分は、アプリケーションのJNLPファイルで言及されます。

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

parts - 部分の名前の配列。

戻り値:

上記条件を満たす場合はtrue、そうでない場合はfalse。

loadResource

void loadResource(java.net.URL ref,
                  java.lang.String version,
                  DownloadServiceListener progress)
           throws java.io.IOException

リソースが呼出し側のアプリケーションのJNLPファイルで言及されているか、呼出し側のアプリケーションのJNLPファイルのコード・ベースに含まれているか、呼出し側のアプリケーションにすべてのアクセス権が付与されている場合に、指定されたリソースをダウンロードします。このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。

例外:

java.io.IOException

loadPart

void loadPart(java.lang.String part,
              DownloadServiceListener progress)
       throws java.io.IOException

部分がアプリケーションのJNLPファイルで言及されている場合、指定された部分をダウンロードします。このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。

パラメータ:

part - 部分の名前。

progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。

例外:

java.io.IOException

loadPart

void loadPart(java.lang.String[] parts,
              DownloadServiceListener progress)
       throws java.io.IOException

複数の部分がアプリケーションのJNLPファイルで言及されている場合、指定された複数の部分をダウンロードします。このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。

パラメータ:

parts - 部分の名前の配列。

progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。

例外:

java.io.IOException

loadExtensionPart

void loadExtensionPart(java.net.URL ref,
                       java.lang.String version,
                       java.lang.String part,
                       DownloadServiceListener progress)
                throws java.io.IOException

部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された部分をダウンロードします。このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

part - 部分の名前。

progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。

例外:

java.io.IOException

loadExtensionPart

void loadExtensionPart(java.net.URL ref,
                       java.lang.String version,
                       java.lang.String[] parts,
                       DownloadServiceListener progress)
                throws java.io.IOException

複数の部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された複数の部分をダウンロードします。このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

parts - ロードする部分の名前の配列。

progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。

例外:

java.io.IOException

removeResource

void removeResource(java.net.URL ref,
                    java.lang.String version)
             throws java.io.IOException

リソースが呼出し側のアプリケーションのJNLPファイルで言及されているか、呼出し側のアプリケーションのJNLPファイルのコード・ベースに含まれているか、呼出し側のアプリケーションにすべてのアクセス権が付与されている場合に、指定されたリソースをキャッシュから削除します。

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

例外:

java.io.IOException

removePart

void removePart(java.lang.String part)
         throws java.io.IOException

部分がアプリケーションのJNLPファイルで言及されている場合、キャッシュから指定された部分を削除します。

パラメータ:

part - 部分の名前。

例外:

java.io.IOException

removePart

void removePart(java.lang.String[] parts)
         throws java.io.IOException

複数部分がアプリケーションのJNLPファイルで言及されている場合、キャッシュから指定された複数の部分を削除します。

パラメータ:

parts - 部分の名前の配列。

例外:

java.io.IOException

removeExtensionPart

void removeExtensionPart(java.net.URL ref,
                         java.lang.String version,
                         java.lang.String part)
                  throws java.io.IOException

部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された部分を削除します。

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

part - 部分の名前。

例外:

java.io.IOException

removeExtensionPart

void removeExtensionPart(java.net.URL ref,
                         java.lang.String version,
                         java.lang.String[] parts)
                  throws java.io.IOException

複数の部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された複数の部分を削除します。

パラメータ:

ref - リソースのURL。

version - バージョン文字列、バージョンがない場合はnull。

parts - 部分の名前の配列。

例外:

java.io.IOException

getDefaultProgressWindow

DownloadServiceListener getDefaultProgressWindow()

loadメソッドに渡されると進捗ウィンドウをポップアップし、ロードの進行に従ってこのウィンドウを更新する、デフォルトのDownloadServiceListener実装を返します。

戻り値:

ダウンロード進捗リスナーを表すDownloadServiceListenerオブジェクト。