-
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
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 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
- 入出力例外が発生した場合。
-
-