V
- PermanentFile インスタンスの型public class PermanentFile<V> extends Object implements Serializable, TreasureFile<V>
データをそのままファイルに保存して、サーバの再起動後も保存したデータを 扱うためのAPIを提供します。
保存するデータは、直列化可能なオブジェクトに限ります。 また、保存した時の環境と取り出した時の環境において、そのデータに関連する クラスの構造が異なっている場合、正常に値を復元できません。
このオブジェクトにより扱うデータは、Storage 上で一元管理されます。 そのため、intra-mart の各サーバモジュールを分散配置している場合、 また、データファイルが保存されるディレクトリは、 システムストレージ/treasure/ 以下の PermanentFile#getParentName() メソッドで示されるディレクトリになります。 サブディレクトリを任意に指定する事が可能で、そのサブディレクトリ内に グループが存在し、そのグループ内にデータがキーにマップされる形で 保存されます。
修飾子 | コンストラクタと説明 |
---|---|
protected |
PermanentFile(jp.co.intra_mart.system.service.client.information.PermanentDirectoryDelegate parent,
String id)
/** 共有データを扱うための新しいオブジェクトを構築します。
|
修飾子とタイプ | メソッドと説明 |
---|---|
void |
clear()
このオブジェクトのマップからマッピングをすべて削除します。
|
Map<String,V> |
entryMap()
グループデータを取得します。
|
V |
get(String key)
データを取得します。
|
String |
getName()
このオブジェクトの表す名称を取得します。
|
String |
getParentName()
この PermanentFile が所属するPermanentDirectory の保存ディレクトリを取得します。
|
List<String> |
keyList()
キー一覧を取得します。
|
boolean |
move(String newId)
この PermanentFile に格納されているデータを移動先グループID に移動します。
|
V |
put(String key,
V value)
データを保存します。
|
void |
putAll(Map<String,V> list)
データを保存します。
|
V |
remove(String key)
データを削除します。
|
int |
size()
マップされている key の数を取得します。
|
Map<String,V> |
subMap(String[] keys)
データを取得します。
|
protected PermanentFile(jp.co.intra_mart.system.service.client.information.PermanentDirectoryDelegate parent, String id)
このインスタンスは、parent に保存されている共有データの中の id に属するデータを扱えます。 domain に保存されているデータや、他の id に属するデータを扱う事は できません。
parent
- 親ディレクトリ名称id
- グループNullPointerException
- 引数が nullpublic String getParentName()
public String getName()
TreasureFile
getName
インタフェース内 TreasureFile<V>
public void clear() throws IOException
TreasureFile
clear
インタフェース内 TreasureFile<V>
IOException
- 入出力エラーpublic V put(String key, V value) throws IOException, ClassNotFoundException
TreasureFile
このオブジェクトに key と value をマップします。 返却値は、key にマップされていたデータになります。返却データに関して、 データを保存した時の環境とデータに関連するクラスの構造が異なる場合 例外がスローされます。
put
インタフェース内 TreasureFile<V>
key
- データを保存するキーvalue
- 保存するデータIOException
- 入出力エラーClassNotFoundException
- データ復元時のエラーpublic void putAll(Map<String,V> list) throws IOException
TreasureFile
このオブジェクトに list をマップに追加します。 list 内のキーがすでにマップに存在している場合、list のマップ情報で 上書きされます。
putAll
インタフェース内 TreasureFile<V>
list
- データIOException
- 入出力エラーpublic V get(String key) throws IOException, ClassNotFoundException
TreasureFile
このマップの中から key にマップされているデータを取得します。
返却データに関して、 データを保存した時の環境とデータに関連するクラスの構造が異なる場合 例外がスローされます。
get
インタフェース内 TreasureFile<V>
key
- キーIOException
- 入出力エラーClassNotFoundException
- データ復元時のエラーpublic Map<String,V> subMap(String[] keys) throws IOException, ClassNotFoundException
TreasureFile
このマップの中から keys の各要素にマップされているデータ群を取得します。
返却データに関して、 データを保存した時の環境とデータに関連するクラスの構造が異なる場合 例外がスローされます。
subMap
インタフェース内 TreasureFile<V>
keys
- キーの配列IOException
- 入出力エラーClassNotFoundException
- データ復元時のエラーpublic Map<String,V> entryMap() throws IOException, ClassNotFoundException
TreasureFile
このマップのデータ一覧を取得します。
返却データに関して、 データを保存した時の環境とデータに関連するクラスの構造が異なる場合 例外がスローされます。
entryMap
インタフェース内 TreasureFile<V>
IOException
- 入出力エラーClassNotFoundException
- データ復元時のエラーpublic V remove(String key) throws IOException, ClassNotFoundException
TreasureFile
マップの中から key にマップされているデータを削除します。
返却データに関して、 データを保存した時の環境とデータに関連するクラスの構造が異なる場合 例外がスローされます。
remove
インタフェース内 TreasureFile<V>
key
- キーIOException
- 入出力エラーClassNotFoundException
- データ復元時のエラーpublic boolean move(String newId) throws IOException
newId
- 移動先グループIDIOException
- 入出力エラーpublic List<String> keyList() throws IOException, ClassNotFoundException
TreasureFile
マップされている key のリストを取得します。 実行環境のバージョン等が異なると ClassNotFoundException がスロー される事があります。
コレクションの各要素は String です。
keyList
インタフェース内 TreasureFile<V>
IOException
- 入出力エラーClassNotFoundException
- データ復元時のエラーpublic int size() throws IOException, ClassNotFoundException
TreasureFile
実行環境のバージョン等が異なると ClassNotFoundException がスロー される事があります。
size
インタフェース内 TreasureFile<V>
IOException
- 入出力エラーClassNotFoundException
- データ復元時のエラーCopyright © 2012 NTT DATA INTRAMART CORPORATION