モジュール java.jnlp
パッケージ javax.jnlp

インタフェースDownloadService

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

    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 
      修飾子と型 メソッド 説明
      DownloadServiceListener getDefaultProgressWindow()
      loadメソッドに渡されると進捗ウィンドウをポップアップし、ロードの進行に従ってこのウィンドウを更新する、デフォルトのDownloadServiceListener実装を返します。
      boolean isExtensionPartCached​(URL ref, String version, String part)
      指定された拡張の指定された部分がキャッシュされる場合は、trueを返します。この拡張と部分は、アプリケーションのJNLPファイルで言及されます。
      boolean isExtensionPartCached​(URL ref, String version, String[] parts)
      指定された拡張の指定された複数の部分がキャッシュされる場合は、trueを返します。この拡張と複数の部分は、アプリケーションのJNLPファイルで言及されます。
      boolean isPartCached​(String part)
      指定された文字列によって参照される部分がキャッシュされる場合は、trueを返します。この部分は、アプリケーションのJNLPファイルで言及されます。
      boolean isPartCached​(String[] parts)
      指定された配列によって参照される部分がキャッシュされる場合は、trueを返します。この部分は、アプリケーションのJNLPファイルで言及されます。
      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)
        指定された文字列によって参照される部分がキャッシュされる場合は、trueを返します。この部分は、アプリケーションのJNLPファイルで言及されます。
        パラメータ:
        part - 部分の名前。
        戻り値:
        上記条件を満たす場合はtrue、そうでない場合はfalse。

      • isPartCached

        boolean isPartCached​(String[] parts)
        指定された配列によって参照される部分がキャッシュされる場合は、trueを返します。この部分は、アプリケーションのJNLPファイルで言及されます。
        パラメータ:
        parts - 部分の名前の配列。
        戻り値:
        上記条件を満たす場合はtrue、そうでない場合はfalse。

      • isExtensionPartCached

        boolean isExtensionPartCached​(URL ref,
                              String version,
                              String part)
        指定された拡張の指定された部分がキャッシュされる場合は、trueを返します。この拡張と部分は、アプリケーションのJNLPファイルで言及されます。
        パラメータ:
        ref - リソースのURL。
        version - バージョン文字列、バージョンがない場合はnull。
        part - 部分の名前。
        戻り値:
        上記条件を満たす場合はtrue、そうでない場合はfalse。

      • isExtensionPartCached

        boolean isExtensionPartCached​(URL ref,
                              String version,
                              String[] parts)
        指定された拡張の指定された複数の部分がキャッシュされる場合は、trueを返します。この拡張と複数の部分は、アプリケーションのJNLPファイルで言及されます。
        パラメータ:
        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 - 入出力エラーが発生した場合

      • loadPart

        void loadPart​(String part,
              DownloadServiceListener progress)
       throws IOException
        部分がアプリケーションのJNLPファイルで言及されている場合、指定された部分をダウンロードします。 このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。
        パラメータ:
        part - 部分の名前。
        progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。
        例外:
        IOException - 入出力エラーが発生した場合

      • loadPart

        void loadPart​(String[] parts,
              DownloadServiceListener progress)
       throws IOException
        複数の部分がアプリケーションのJNLPファイルで言及されている場合、指定された複数の部分をダウンロードします。 このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。
        パラメータ:
        parts - 部分の名前の配列。
        progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。
        例外:
        IOException - 入出力エラーが発生した場合

      • loadExtensionPart

        void loadExtensionPart​(URL ref,
                       String version,
                       String part,
                       DownloadServiceListener progress)
                throws IOException
        部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された部分をダウンロードします。 このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。
        パラメータ:
        ref - リソースのURL。
        version - バージョン文字列、バージョンがない場合はnull。
        part - 部分の名前。
        progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。
        例外:
        IOException - 入出力エラーが発生した場合

      • loadExtensionPart

        void loadExtensionPart​(URL ref,
                       String version,
                       String[] parts,
                       DownloadServiceListener progress)
                throws IOException
        複数の部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された複数の部分をダウンロードします。 このメソッドは、ダウンロードが完了するまでまたは例外が発生するまでブロックされます。
        パラメータ:
        ref - リソースのURL。
        version - バージョン文字列、バージョンがない場合はnull。
        parts - ロードする部分の名前の配列。
        progress - ダウンロードの進捗状況を示すコールバック・オブジェクト。
        例外:
        IOException - 入出力エラーが発生した場合

      • removeResource

        void removeResource​(URL ref,
                    String version)
             throws IOException
        リソースが呼出し側のアプリケーションのJNLPファイルで言及されているか、呼出し側のアプリケーションのJNLPファイルのコード・ベースに含まれているか、呼出し側のアプリケーションにすべてのアクセス権が付与されている場合に、指定されたリソースをキャッシュから削除します。
        パラメータ:
        ref - リソースのURL。
        version - バージョン文字列、バージョンがない場合はnull。
        例外:
        IOException - 入出力エラーが発生した場合

      • removePart

        void removePart​(String part)
         throws IOException
        部分がアプリケーションのJNLPファイルで言及されている場合、キャッシュから指定された部分を削除します。
        パラメータ:
        part - 部分の名前。
        例外:
        IOException - 入出力エラーが発生した場合

      • removePart

        void removePart​(String[] parts)
         throws IOException
        複数部分がアプリケーションのJNLPファイルで言及されている場合、キャッシュから指定された複数の部分を削除します。
        パラメータ:
        parts - 部分の名前の配列。
        例外:
        IOException - 入出力エラーが発生した場合

      • removeExtensionPart

        void removeExtensionPart​(URL ref,
                         String version,
                         String part)
                  throws IOException
        部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された部分を削除します。
        パラメータ:
        ref - リソースのURL。
        version - バージョン文字列、バージョンがない場合はnull。
        part - 部分の名前。
        例外:
        IOException - 入出力エラーが発生した場合

      • removeExtensionPart

        void removeExtensionPart​(URL ref,
                         String version,
                         String[] parts)
                  throws IOException
        複数の部分と拡張がアプリケーションのJNLPファイルで言及されている場合、指定された拡張の指定された複数の部分を削除します。
        パラメータ:
        ref - リソースのURL。
        version - バージョン文字列、バージョンがない場合はnull。
        parts - 部分の名前の配列。
        例外:
        IOException - 入出力エラーが発生した場合

      • getDefaultProgressWindow

        DownloadServiceListener getDefaultProgressWindow()
        loadメソッドに渡されると進捗ウィンドウをポップアップし、ロードの進行に従ってこのウィンドウを更新する、デフォルトのDownloadServiceListener実装を返します。
        戻り値:
        ダウンロード進捗リスナーを表すDownloadServiceListenerオブジェクト。