:i/プロトタイピング/01 のバックアップ差分(No.58)

to your Kindle
追加された行はこの色です。
削除された行はこの色です。
RIGHT:&tag(実装,コード,目次,更新中);

*目次 [#n27e7315]
#contents
----
#lsx(new=true);
*関連 [#q6bdea1e]
#lsx(tag=プロトタイピング,new=true,except=^プロトタイピング(/.*)?$)

[[検索:プロトタイピング]]

*プロトタイピング周辺のタグ [#k2465701]
#tag(0,プロトタイピング)

*プロトタイピングとは [#k44c6dd0]
RIGHT:[[:t/プロトタイピング]]

実装のためのまとめ。


*特に関連の強いページ [#a1b1cc24]
-[[モデリング]]
-[[フレームワーク]]


*実装 [#u5232eb6]

Perlで。
UI抜きで。
フレームワークの実現と主要機能の実現を。


もしWikiNotationやプラグインをまったく使えないWikiEngineを作ったら…
テキストを記録するだけ。
ファイル名とテキストを与えると記録、ファイル名のみならテキストを出力。

これにプラグイン独自のデータと処理を加えて、プラグインごとに違うHTML出力ができるようにする。
中心はプラグインを作るためのAPI。


*図 [#k966a347]

[[Webアプリケーションのフレームワーク>http://f.hatena.ne.jp/pmint/20090927012512]]
#ref(http://img.f.hatena.ne.jp/images/fotolife/p/pmint/20090927/20090927012512.png)

→[[フレームワーク/Webアプリケーション]]

-ユーザー
システム外。
-メイン
非オブジェクト指向の手続き指向。
--ユースケース
[[フレームワーク/WikiEngine]]のクラス。
編集とか、ページ作成とか、ページ閲覧とか。そういったものの処理フロー。他のクラスに依存しっぱなし。
-クエリー（ユーザーから与えられたデータ）
グローバルなデータ。なのでシングルトン。
モデルによって書き換えられた後、ビューに参照される。
-モデル系
クエリーから入力（内部形式・独自形式、扱い方はモデル系クラス自身が知っている）、処理、保存（永続化）、''クエリーに''出力
-ビュー系
クエリーから入力（文字列）、それをHTMLなどのテンプレートに埋め込む。


------------------------------------------------------------

Wikiエンジンのフレームワーク

→[[フレームワーク/WikiEngine]]


Webアプリ部分で言うモデル系のこと。
スキンはビュー系。

直接関連はしない。コントロールクラス経由で呼び出し。

+ユースケース（コントロールクラス）→モデル
+ユースケース（コントロールクラス）→ビュー

でも、ビューがモデルを呼ぶこともあるかも。
決まりきっている部分。HTMLヘッダーとか、背景とか。多くのページが必要とする部分とか。ユースケース別にすることもない部分。

----------------------------------------

クライアント側で動くものはUI周辺のみ。
*最低限必要なもの [#w0fbb4e3]

-コア部分
-周辺部分
**コア部分 [#zae1fb02]
&ref(http://img.f.hatena.ne.jp/images/fotolife/p/pmint/20091103/20091103015312.png);

-データ変換
--WikiNotationを含むテキストをオブジェクト化する
--個々のオブジェクトから（HTMLなどの）別形式を得る
-各WikiNotationクラスによる同型オブジェクト間の同一性の評価
検索で使用。類似度を算出。
-検索
-オブジェクトの永続化
-プラグインの使用
-構造化ページ
-代表とその決定方法
-エラーレベル
--利用者向け情報 Info
不正なリクエストなど。ページのメッセージ欄に出力。
--警告 Warning
デバッグ用ログ出力と管理者ロール宛てメールに出力。
処理続行。
--致命的エラー Fatal
処理中断。
開発時のアサーション違反はエラー、運用中は警告だけ。

[Prog]参照
***データ変換(WikiNotationクラス) [#j528038f]
テキスト→オブジェクト→HTML
オブジェクト→永続オブジェクト
どれもWikiNotationクラスの役目。


-WikiNotation/表 |…|…|
-WikiNotation/強調 &#x27;&#x27;…&#x27;&#x27;

***周辺部分 [#c715cd8b]
特にWebアプリケーションとしてのWikiに必要なこと。

-Webアプリケーションとしてのコントロールクラス
-UI
-アカウント
-スキン


***UI [#s041046b]
スキンに含まれるテンプレートと関連が深い。


***アカウント [#s0de27cc]
-ログイン、ログアウト
[[Google:はてな認証API]]で。
-アカウントとロールと権限設定

→[[利用者]]

------------------------------------------------------------
必要なときに必要としているクラスから呼び出される。
主にユースケースを表すコントロールクラスから。


------------------------------------------------------------
''ユーザーの属性''
-アカウント（アカウント型）

------------------------------------------------------------
''アカウントの属性''
-ロール（ロール型）
-ID（ID:文字列を継承）
-IDを承認するサイト（URI:文字列を継承）

※アカウントをユーザーの一部にしてもいい。

------------------------------------------------------------
''ロールの属性''
-権限（権限型の集合）
権限の集合を1つのハッシュ構造にしてもいい。

------------------------------------------------------------
''権限の属性''
-権限ID（ID:文字列を継承）
-可否（真偽）
***スキン [#ca6fb64a]
-テンプレート
-スタイルシート
-貼るもの
画像とか。

ページの一種。それがテンプレートになる。
スタイルシートや画像は普通に作ればいい。


***UI [#t9088b46]
最低限必要なUIだけ。




**そのほか [#h8eb4121]

''クラス候補''
-[[WikiEngine/Notation/Link]]
リンクは独立したクラスではなく、WikiEngine/Elementの1つ。Notation系。ページの構成要素なので。
-[[WikiEngine/File]]
フレームワーク/Webアプリケーション側のクラス。
モデル系オブジェクトの永続化で使用。
-[[WikiEngine/InterPageAdapter]]
WikiEngine/InterPage（ただのテキスト）を解析するクラス系。抽象クラス。要具象クラス。
-[[WikiEngine/User]]
→ 利用者（アカウントの「ID」含む）
-[[WikiEngine/User/Role]]
→ アカウント
→ アカウントの「ロール」
-[[WikiEngine/User/Permission]]
→ アカウント
→ アカウントの「権限」
-[[WikiEngine/Style]]
ユースケースから呼ばれて
MVCのモデル系。MVCのビュー担当はフレームワーク/Webアプリケーションにあるので。
そのビュー担当のための情報を持つ。使用するスタイル|テーマ|スキンや、その場所、ページ本体とサイドメニューとヘッダーとフッターをどう配置するかなど。
ページの外側を定義する。
-[[Main]]
エントリーポイントを持つため、必ず呼ばれる。
コントロールクラス。
-[[WikiEngine]]
フレームワーク/WikiEngineの最上位。モデル系にあたる。
アプリケーション全体で使用されるものを定義。
-[[WikiEngine/UseCase]]
コントロールクラス。
WikiEngineから呼ばれる。リクエスト毎に別。
WikiEngineから呼ばれる。リクエスト毎に別。MediaWikiの'Action'、PukiWikiの'cmd'にあたるものと一対一対応。
***ページの構成 [#h4d33ed8]
Wiki（サイト）─Entry（項目）─View（見解）─Revision（版）

:Wiki|WikiEngineのインスタンス
:Entry|項目、ページ、Wikipediaでの1ページ
:View|→ [[見解]]
:Revision|バックアップ、Wikipediaでの版
*コード [#u12dfe3d]

今使ってるPerlのほか、PHP、Microsoftの、Rubyも。
**01 [#rf91a0f1]
[[codeなにがし>http://code.nanigac.com/]]に投稿してみる。
-フレームワーク/Webアプリケーション
[[code*:357]]
-フレームワーク/WikiEngine
[[code*:362]]
-ページ、|…|…|、&#x27;&#x27;…&#x27;&#x27;
[[code*:364]] [[code*:375]]
-検索/クエリー
[[code*:375]]
[[検索/流れ]]
-利用者
クラス定義とOpenID認証のサンプルだけで良い。
''[[code*:???]]'' [[code*:412]]


**02 [#x29cf857]
テスト用のUIを付けて…
[[http://wiki.pmint.name/proto/02/>http://wiki.pmint.name/proto/02/]]に設置して…
コードは[[http://wiki.pmint.name/>http://wiki.pmint.name/]]のどこかに置いて。

-見解
-代表
-利用者
-ページ/章