javax.jnlp
インタフェース PersistenceService


public interface PersistenceService

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

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

アプリケーションは、そのコードベースの基となる URL によって格納されたデータだけにアクセスできます。たとえば、コードベース http://www.mysite.com/apps/App1/ を指定すると、アプリケーションは次の関連 URL にあるデータにアクセスできます。

このスキーマを使用すると、同一ホストの各種アプリケーション間でデータを共有できます。たとえば、別のアプリケーションが http://www.mysite.com/apps/App2/ に格納されている場合は、http://www.mysite.com/ および http://www.mysite.com/apps/ の各ディレクトリ内のデータをアプリケーション間で共有できます。

JNLP クライアントでは、特定のアプリケーションが使用する記憶容量を追跡する必要があります。PersistenceService の実装では、現在の記憶域使用率と制限を確認するメソッド、および記憶域を追加要求するメソッドを提供します。記憶域はファイルごとに割り当てられますが、JNLP クライアントでは通常、アプリケーションが使用する記憶域の全容量に基づいて要求を許可または拒否します。

この機構を使用して格納されたデータは、リモートサーバに格納されているデータのローカルコピーとして使用されます。個々のエントリには、サーバが最新のコピーを備えていることを意味する cached、サーバが最新のコピーを備えていないことを意味する dirty、またはファイルを常に再作成できることを意味する temporary のいずれかのタグが付けられます。

バージョン:
1.0

フィールドの概要
static int CACHED
           
static int DIRTY
           
static int TEMPORARY
           
 
メソッドの概要
 long create(java.net.URL url, long maxsize)
          指定の URL によって名前が付けられた、クライアント側の持続ストレージのエントリを新規作成します。
 void delete(java.net.URL url)
          指定の URL に関連したストリームをクライアント側の持続データストアから削除します。
 FileContents get(java.net.URL url)
          このファイルの内容を表す FileContents オブジェクトを返します。
 java.lang.String[] getNames(java.net.URL url)
          指定の URL の全エントリの名前が含まれている文字列の配列を返します。
 int getTag(java.net.URL url)
          指定の URL に関連した持続データストアエントリのタグの現在値に相当する int を返します。
 void setTag(java.net.URL url, int tag)
          指定のタグ値を使用して、指定の URL に関連した持続データストアのエントリにタグを付けます。
 

フィールドの詳細

CACHED

public static final int CACHED

TEMPORARY

public static final int TEMPORARY

DIRTY

public static final int DIRTY
メソッドの詳細

create

public long create(java.net.URL url,
                   long maxsize)
            throws java.net.MalformedURLException,
                   java.io.IOException
指定の URL によって名前が付けられた、クライアント側の持続ストレージのエントリを新規作成します。
パラメータ:
url - 持続データストアのエントリの名前を表す URL
maxsize - このエントリに書き込める最大記憶容量
戻り値:
許可された最大記憶容量 (バイト数)
例外:
java.net.MalformedURLException - アプリケーションが指定の URL によって表された持続データストアへのアクセスを拒否された場合
java.io.IOException - 入出力例外が発生した場合、あるいはエントリがすでに存在している場合

get

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

delete

public void delete(java.net.URL url)
            throws java.net.MalformedURLException,
                   java.io.IOException
指定の URL に関連したストリームをクライアント側の持続データストアから削除します。
パラメータ:
url - 持続データストアから削除するエントリを表す URL
例外:
java.net.MalformedURLException - アプリケーションが指定の URL によって表された持続データストアへのアクセスを拒否された場合
java.io.IOException - 入出力例外が発生した場合

getNames

public java.lang.String[] getNames(java.net.URL url)
                            throws java.net.MalformedURLException,
                                   java.io.IOException
指定の URL の全エントリの名前が含まれている文字列の配列を返します。
パラメータ:
url - エントリ名の検索対象となるルートディレクトリを表す URL
戻り値:
エントリ名が含まれている String 配列
例外:
java.net.MalformedURLException - アプリケーションが指定の URL によって表された持続データストアへのアクセスを拒否された場合
java.io.IOException - 入出力例外が発生した場合

getTag

public int getTag(java.net.URL url)
           throws java.net.MalformedURLException,
                  java.io.IOException
指定の URL に関連した持続データストアエントリのタグの現在値に相当する int を返します。
パラメータ:
url - タグ値が要求される持続データストアのエントリを表す URL
戻り値:
次のいずれかのタグ値が含まれる int
例外:
java.net.MalformedURLException - アプリケーションが指定の URL によって表された持続データストアへのアクセスを拒否された場合
java.io.IOException - 入出力例外が発生した場合

setTag

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


Copyright (c) 2002 Sun Microsystems, Inc. All Rights Reserved