• 追加された行はこの色です。
  • 削除された行はこの色です。
オブジェクトを以降のリクエストでも、他の利用者にも使えるようにすること。
RIGHT:[[:t/永続化]]

***永続化でやること [#j94c78cf]
-Fetch
キー（複数）　→　オブジェクト（複数）
-Store
キーとオブジェクト　→　保存できていたらそのキー／さもなくば「保存できなかった」という何か
-Search
何か　→　適合するキー（複数）
何かとは…キーの一部　またはオブジェクト内の永続化クラスが特別視する部分…例えばクラス名とか。
-ValidateKeys
キー（複数）　→　使えるキー（複数）
永続化クラス内部で使われるので、呼び出し側が使う必要は無い。
Storeせずに使えるキーを得るために。
ページを以降のリクエストや他の利用者からも使えるようにすること。
永続化するものはページくらいしかない。

----

例えば…
Search→Fetch
組み合わせて使う。
***永続化での上書きは追加で [#c1313797]
同一キーの書き込みはファイルの追加。ファイル追加ならロック待ちがおきないので効率的。
古いファイルは残す。同じキーに関連付けられるオブジェクトは複数。
#contents

上書き時、古いファイルは残す。
ファイル名に時刻でも付ければいい。新しいファイル名として有効ならいい。排他的ロックをかけられるまでは残す。

参照可能なのは最新版。
1つのキーに対して複数のファイルが存在するので、最新版は探して見つける。ファイル名探索。
***古いファイルは消せるときに消す [#aeaf399f]
古いファイル（同一キーでより新しいファイルがあるというファイル）を消すのはいつでもいい。消せるときに。
つまり最新版でなくて排他的ロックを取得できたファイルは消していい。
**永続化は後付けで [#k93a286d]

***[[:i/永続化での上書きは追加で]] [#c1313797]

***排他的ロック／共有ロック [#j61c0374]
排他的ロックを使うのはファイルを作るときと消すときだけ。
変更／上書きはしないのでN/A。
共有ロックを使うのはファイルを参照するとき。
***[[:i/永続化での削除も追加で]] [#xfd6d35b]

ファイルを消すときだけブロック（ロック待ち）が発生しうる。
***[[:i/永続化でのキー変更も追加で]] [#rf3f140f]
永続化キーの変更は編集であり削除でもある。
これもロック不要。負担にならない。
**データベースとの関連付け [#i39acd2e]

***[[:i/古いファイルは消せるときに消す]] [#aeaf399f]

***永続化のキー [#md972074]
Validateで削除か置き換えになる文字がある。
ファイルシステムのパスに使えない文字。
***[[:i/排他的ロック／共有ロック]] [#j61c0374]

ディレクトリ区切りはそのままディレクトリ区切りになる。
ファイルシステムを直接見たときに分かりやすいように。
***%%[[:i/ロックシステム]]%% [#z2b10f1d]
%%決まった順序でロック。予約制なので必要なロックを事前に決めなければならない。%%
%%永続化クラスも同じファイルを読み書きするならこのルールを守らなければならないが、ロック対象と永続化クラスで扱うファイルは区別して対処。例えばディレクトリを分けて。同じファイルを両者で使うことはしない。%%

 【パスの形式】
 永続化ディレクトリ/クラス名/キー（ディレクトリ区切りがあればそれをディレクトリとして扱う）.time.拡張子
→全て永続化クラスで。ロックシステムは必要ない。
***[[:i/永続化のキー]] [#md972074]

Store時、渡されたキーが使えるキーでなければ勝手に変更する。ValidateKeysを使って。
Storeではキーが渡されなくてもいい。勝手に生成する。
戻り値に実際に使ったキーを含める。
***シリアライズ [#de841db8]
Store時、シリアライズ可能なオブジェクトを渡されたらそのシリアライズを実行。不可能ならToString()でもしておく。それも不可能ならエラー。渡すオブジェクトはいずれかができなければならない。
（Stringのシリアライズは不要。Stringのシリアル形式はString）


*資料 [#ua11db1c]
***[[:i/永続化クラスでの検索]] [#q93c0dda]
検索機能とは別の、低いレベルの話。

**[[:t/永続化]] [#h1ad6cc3]
DBクラスにページ検索の機能を
X/PageFactory
フレームワーク/WikiEngineでやること
プロトタイピング
ページ
ページ/要素
保存は入力されたままのWikiTextか
永続化システムの仕分け機能
複数ファイルで1セクション
RIGHT:[[:t/永続化]]
**効率化 [#zcd047fa]

***キューイング [#i54f8bba]
RIGHT:[[:t/キュー]] [[:t/開発]]

読み書きジョブをキュー入れ／キュー出し。
永続化を使う側の一つ。永続化からすると使われ方の例。

永続化システムはロックとパフォーマンス低下を防ぐ方法。
※通常の編集1回で1回のロックとファイル削除が必要。でもすぐにでなくていい。やることの分散。編集時のロックをいつでもいいようにしてパフォーマンス低下防止。しかもロックは非ブロックですぐタイムアウトにしていい。待たない。
***[[:i/キューはModelに出すもの]] [#bca5bab1]

***[[:i/キューの永続化]] [#ab6061b1]

***全体複製をしたくないなら [#e7160e07]
ちょっと更新するだけで全体を複製することになる。そこで時間がかかるなら逆効果。
全複製は1ファイルで1エントリー全体をまかなえるということ。複数ファイルで1エントリーだったら？
→関連ファイルを全て読み込んでマージすればいい。この場合エントリーに''追記するだけ''なら複製不要。参照は新しい順に、エントリー1つ分が揃うまで、ファイル参照をして、得たデータを全てマージ。
型によってはマージ不可能。その場合は全複製を要する。条件が多すぎて使いにくい。

それよりも1エントリーをDictionaryの1エントリーに見立てて、フォルダーをDictionaryにすればいい。
フォルダーをネストすればDictionaryのネストのようになる。キー→キー→値といったアクセスが可能に。



***[[:/内部名と外部名]] [#bcfa0e95]
これをどう記録して参照を速くするか。
†[[:i/ページ名インデックス]]
フォルダーをDictionaryとして使う方法で。
**問題 [#sf83f730]

***[[:Done/参照したときすでに古いかも]] [#z5f2d514]
編集の衝突判定から書き込みまでロックが必要。

方法は…
衝突判定のあと何もしないかも知れないので、ファイルを作ったりはしないで。
それでいて他のプロセスと共有できる方法は…
既存ファイルのロック。
そのファイルとは…
ロック用ファイル。同一キーのtimeなし。キーごとに常設だけど無くてもいい。初回使用時に作る。存在確認が面倒ならキー作成時に一緒に作っておく。キー削除時、一緒に消す。



***ファイル間のバージョンがずれる [#hc92c1db]
ファイル間でバージョンのずれがあり得るので、複数ファイルを同時に更新しても読んだときにいずれかが古いままの可能性がある。
依存関係のあるデータは1つのエントリーにする。

待たされるのを覚悟で最新版を要求することはできる。



**永続化/ [#i3d330bf]
- 永続化でやること

#ls