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

インタフェースPersistenceService

  • public interface PersistenceService
    PersistenceServiceは、信頼されていない実行環境で実行されているアプリケーションに対しても、クライアント・システム上にローカルにデータを格納するためのメソッドを提供します。 このサービスは、クッキー・メカニズムがHTMLベースのアプリケーションに提供するサービスに若干似ています。

    持続的データ・ストアの各エントリには、URLを使って名前が付けられます。 これにより、従来のファイル・システムと同様の階層構造が提供されます。

    アプリケーションは、コード・ベースに基づくURLを使う場合だけ、格納されたデータにアクセスが許可されます。 たとえば、http://www.mysite.com/apps/App1/コード・ベースが与えられた場合、アプリケーションは次に示す関連付けられたURLでデータにアクセスすることが許可されます。

    • http://www.mysite.com/apps/App1/
    • http://www.mysite.com/apps/
    • http://www.mysite.com/

    このスキームは、同じホストから異なるアプリケーション間でデータを共有できるようにします。 たとえば、別のアプリケーションがhttp://www.mysite.com/apps/App2/にある場合、これらのアプリケーションはhttp://www.mysite.com/ディレクトリとhttp://www.mysite.com/apps/ディレクトリでデータを共有できます。

    JNLPクライアントは、特定のアプリケーションが使用する記憶領域の容量を追跡する必要があります。 PersistenceService実装は、現在の記憶領域の使用率と限界を取得し、さらに記憶領域を要求するメソッドを提供します。 記憶領域は、ファイル単位に割り当てられますが、JNLPクライアントは一般にアプリケーションで使用される合計記憶領域に基づいて付与または要求を拒否するようになります。

    このメカニズムを使って格納されたデータは、リモート・サーバーに格納されたデータのローカル・コピーであることを目的としています。 各エントリには、サーバーが最新のコピーを持っていることを意味するcached、サーバーが最新のコピーを持たないことを意味するdirty、ファイルを常に再作成できることを意味するtemporaryというタグを付けることができます。

    導入されたバージョン:
    1.4.2

    • フィールドのサマリー

      フィールド 
      修飾子と型 フィールド 説明
      static int CACHED  
      static int DIRTY  
      static int TEMPORARY  

    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 
      修飾子と型 メソッド 説明
      long create​(URL url, long maxsize)
      指定されたURLを使って名前が付けられたクライアント・サイドの新しい持続的記憶領域エントリを作成します。
      void delete​(URL url)
      クライアントのデータの持続的データ・ストアから、指定されたURLに関連付けられたストリームを削除します。
      FileContents get​(URL url)
      このファイルの内容を表すFileContentsオブジェクトを返します。
      String[] getNames​(URL url)
      指定されたURLのすべてのエントリの名前を含むStringsの配列を返します。
      int getTag​(URL url)
      指定されたURLに関連付けられた持続的データ・ストア・エントリのタグの現在の値に対応するintを返します。
      void setTag​(URL url, int tag)
      指定されたURLに関連付けられた持続的データ・ストアに、指定されたタグ値を使ってタグを付けます。

    • メソッドの詳細

      • create

        long create​(URL url,
            long maxsize)
     throws MalformedURLException,
            IOException
        指定されたURLを使って名前が付けられたクライアント・サイドの新しい持続的記憶領域エントリを作成します。
        パラメータ:
        url - 持続的データ・ストアのエントリの名前を表すURL。
        maxsize - このエントリに書き込むことができる記憶領域の最大サイズ。
        戻り値:
        付与された記憶領域の最大サイズ(バイト単位)。
        例外:
        MalformedURLException - 指定されたURLで表される永続データストアへのアクセスがアプリケーションから拒否された場合、またはURLがnullの場合。
        IOException - I/O例外が発生した場合、またはエントリがすでに存在する場合。

      • get

        FileContents get​(URL url)
          throws MalformedURLException,
                 IOException,
                 FileNotFoundException
        このファイルの内容を表すFileContentsオブジェクトを返します。
        パラメータ:
        url - 持続的データ・ストアのエントリを表すURL。
        戻り値:
        FileContentsとしてのファイルの内容。
        例外:
        IOException - 入出力エラーが発生した場合。
        MalformedURLException - 指定されたURLで表される永続データストアへのアクセスがアプリケーションから拒否された場合、またはURLがnullの場合。
        FileNotFoundException - 指定されたURLの永続ストアが見つからない場合。

      • delete

        void delete​(URL url)
     throws MalformedURLException,
            IOException
        クライアントのデータの持続的データ・ストアから、指定されたURLに関連付けられたストリームを削除します。
        パラメータ:
        url - 持続的データ・ストアから削除するエントリを表すURL。
        例外:
        MalformedURLException - 指定されたURLで表される永続データストアへのアクセスがアプリケーションから拒否された場合、またはURLがnullの場合。
        IOException - 入出力例外が発生した場合。

      • getNames

        String[] getNames​(URL url)
           throws MalformedURLException,
                  IOException
        指定されたURLのすべてのエントリの名前を含むStringsの配列を返します。
        パラメータ:
        url - エントリ名を検索するためのルート・ディレクトリを表すURL。
        戻り値:
        エントリ名を含むString配列。
        例外:
        MalformedURLException - 指定されたURLで表される永続データストアへのアクセスがアプリケーションから拒否された場合、またはURLがnullの場合。
        IOException - 入出力例外が発生した場合。

      • getTag

        int getTag​(URL url)
    throws MalformedURLException,
           IOException
        指定されたURLに関連付けられた持続的データ・ストア・エントリのタグの現在の値に対応するintを返します。
        パラメータ:
        url - タグの値が要求された持続的データ・ストアのエントリを表すURL。
        戻り値:
        次のタグの値のいずれかを含むint。
        例外:
        MalformedURLException - 指定されたURLで表される永続データストアへのアクセスがアプリケーションから拒否された場合、またはURLがnullの場合。
        IOException - 入出力例外が発生した場合。

      • setTag

        void setTag​(URL url,
            int tag)
     throws MalformedURLException,
            IOException
        指定されたURLに関連付けられた持続的データ・ストアに、指定されたタグ値を使ってタグを付けます。
        パラメータ:
        url - タグの値を設定する持続的データ・ストアのエントリを表すURL。
        tag - 設定するタグの値。
        例外:
        MalformedURLException - 指定されたURLで表される永続データストアへのアクセスがアプリケーションから拒否された場合、またはURLがnullの場合。
        IOException - 入出力例外が発生した場合。