X のバックアップの現在との差分(No.30)

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• バックアップ を表示
• X へ行く。

---

クラス設計。
なおす。
ここで作っているWikiシステム（WikiEngineまたはWikiソフトウェアと呼ばれるもの）。

• X/Adapters
• X/Adapters/Dropbox
• X/Adapters/InterInclude
• X/Plugins

1. Xとは
2. クラス構造
   1. X/Actor[?]
   2. Actor
   3. X
   4. X/Usecase[?]
   5. X/User[?]
   6. X/Page[?]
   7. X/Pages/Name[?]
   8. X/Pages/Property[?]
   9. X/Pages/ShadowProperty[?]
   10. X/永続化[?]
   11. X/Element[?]
   12. X/Pages/Element[?]
   13. X/Pages/Elements[?]/…
   14. X/Elements[?]/…
   15. X/Elements/Notations[?]系
   16. X/Elements/DynamicNotations[?]系
   17. X/Elements/Semantics[?]系
   18. X/Elements/Plains[?]系
   19. X/Plugins/...
3. その他のクラス

Xとは †

フレームワーク/WikiEngine.
フレームワーク/Webアプリケーションから呼ばれる。
アプリケーション全体で使用されるものを定義。

クラス構造 †

X/Actor[?] †

Actor †

リクエスト送信。PageNameとかUsecaseNameとかStepNameとかViewNameとか含む。
→fw/Web→fw/Wiki→Usecase

X †

フレームワーク/WikiEngineの実装。

X/Usecase[?] †

プラグイン。

コントロールクラス。
WikiEngineから呼ばれる。リクエスト毎に別クラス。
MediaWikiの'Action'、PukiWikiの'cmd'にあたるものと一対一対応。

• 権限判定
• 閲覧
• 編集

→User

X/User[?] †

利用者。
ページを扱うクラス。Userが扱うページを特に「利用者ページ」と呼んでおく。権限情報が書かれているので特殊。
データはページ化されているので、このクラスが無くても読み/書きできる。書くのは利用者。
存在意義が薄い。ただ利用者ページにデータアクセスするラッパーでしかない。

• 鍵←UserID

→Page

X/Page[?] †

Wikiのデータを保存するもの。
利用者が手作業で書く。どういう記法を使うかでデータアクセス時の反応が違う。
属性を持つ。
URIでプラグインを呼んだときは仮のページ。その場合でも流れは同じ。

• 錠（ユーザーページもそれ以外も）
• 鍵（ユーザーページの場合）
  →Pages/Name
  →永続化
  →PageElement（記法に書かれると呼ばれる）

→ Pages/Name
→ PageElement（記法に書かれると呼ばれる）

• 永続化
  • FlyweightFactoryでインスタンス生成
  • コンストラクターは非公開

X/Pages/Name[?] †

ページ名。ValueObjectにするのが自然。

Page.rename(new Name(...))
ページ名を変更するときはNameインスタンスを作り直す。
ページ名変更時にやることがあるならrename()でできる。

• 外部名4区分
  • space
  • entry
  • opinion
  • revision
• 内部名

• 永続名
  主キーとしての内部名＋検索用の外部名
  †:i/永続化のキー

X/Pages/Property[?] †

ページ/属性。
属性/継承を行なう。

X/Pages/ShadowProperty[?] †

ページ/裏。

X/永続化[?] †

ページ以外も永続化
ページ以外も永続化。
データストアにはファイルシステム(flat files)使用。

• Page←PageName
• PageProperty←PageName
• Session←SessionID

X/Element[?] †

ページの構成要素。
記法から生成したオブジェクト。各種記法や一続きのプレーンテキスト部分などが1つのオブジェクトになる。
ElementがElementの集約にもなる。ネスト構造。

X/Pages/Element[?] †

→PageElement
PageElementがPageElementの集約。ネスト構造。
→PageElements

X/Pages/Elements[?]/… †

PageElementのサブクラス。プラグインはNotations系／DynamicNotations系／Semantics系／Plains系。

X/Elements[?]/… †

PageElementのサブクラス。プラグインはNotations系／Semantics系／DynamicNotations系／Plains系。

• レイアウトもテンプレートもビューも下位展開付きビューも
• セレクターも
• その他要素全て

X/Elements/Notations[?]系 †

記法を統一する抽象クラス。

X/Elements/DynamicNotations[?]系 †

例えば自動リンク。
記法はあるが決まっていないもの。

X/Elements/Semantics[?]系 †

検索でスコアを上げる記法。
数詞やカラーコードなど。

X/Elements/Plains[?]系 †

ただのテキスト。

X/Plugins/... †

いろいろなプラグイン型。

• X/Plugins/Elements/...
  • X/Plugins/Elements/Notation
    記法を当てたり汎用記法から使うもの。
  • X/Plugins/Elements/Semantic
    検索スコア用の記法。正規表現で表現。
  • X/Plugins/Elements/DynamicNotation
    自動リンク系の。
  • X/Plugins/Elements/Plain
    ただのテキストの別解釈をしたいときに。文字同一視とか。
• X/Plugins/Usecase
  ユースケース。利用者からのリクエストに応えるもの。
• X/Plugins/Page
  ページ/属性/型に対応するもの。

その他のクラス †

• X/Adapters
• X/Adapters/Dropbox
• X/Adapters/InterInclude
• X/Plugins