Documentation generated on Tue, 3 May 2005 22:52:00 +0900 by phpDocumentor 1.3.0RC3
philot_doc/elementindex.html 0000644 0000000 0000000 00000063660 10235702503 0017626 0 ustar viewcvs viewcvs 0000001 0000000Documentation generated on Tue, 3 May 2005 22:52:01 +0900 by phpDocumentor 1.3.0RC3
philot_doc/index.html 0000644 0000000 0000000 00000001655 10235702503 0016250 0 ustar viewcvs viewcvs 0000001 0000000Actionクラス。
Located in /Action.php (line 20)
フォーム値を元に、出力データを作成する抽象メッソド。
正常に処理が終了した場合には、_ACTION_MAPPINGSのActionForm論理名(key値)の文字列を返します。 出力は、ActionViewオブジェクトである$actionViewに、送られます。 返り値をNULLにした場合には、他への転送が行われないので、Actionクラス内で表示を行うこと。 処理が異常終了した場合にはtrigger_error()にて、エラーメッセージを保持します。
Documentation generated on Tue, 3 May 2005 22:52:00 +0900 by phpDocumentor 1.3.0RC3
ActionFormクラス。
Located in /ActionForm.php (line 19)
ActionFormクラスのコンスタラクタ。
HTMLのクエリーパラメータの全ての変数名を取得。
HTMLのクエリーパラメータの全ての変数名を要素とする配列を返す。 クエリーパラメータがなければ、nullを返す。
キー値$keyに対応するHTMLフォーム情報を返す。
HTMLフォーム情報から、キー値$keyに対応する値を、 読み出し、戻り値とする。存在しなかった場合には、NULLを返す。
フォーム値をリセットする抽象メソッド。
今のところ、このメソッドをどのように利用したらいいのか、必要なのかが明確になっていません。 以下は、Strutsでの説明ですが、必要性がわかりません。
reset()メソッドはHTMLフォームのcheckboxのためにインプリメントされたものである。 checkboxは、チェックがついてない値は送信されない。 例えばsessionで複数の画面をまたいでチェックボックスを使う場合、 A,B,Cのcheckboxがある場合、画面１を表示した時はA,Bにチェックされているとする。 そこでAのチェックを外して画面２へとフォームを送信します。 ところが<input>タグはfalseのバリューを送信しないので、画面２のチェックボックスは アップデートされずA,B両方にチェックがついたままになる。 そこで、reset()メソッドを使って、このcheckboxをfalseにする必要が出てくる。 これがreset()メソッドの正式な使い方である。 reset()メソッドを使ってフォームのプリポピュレートの処理すべきではありません。 reset()メソッドをプリポピュレートなどに使わない方が良い理由として もしかしたら将来reset()メソッドがdeprecatedになるかもしれないと言われているからです。
ActionFormのresetメソッド ActionFormはstruts設定ファイルの中で設定したスコープに登録されます。 したがってsessionに登録された場合には、同一セッション中の同じHTMLフォームにおいては 同じActionFormインスタンスが使用される事になります。 またHTMLフォームの内、チェックボックスは選択されていない状態でパラメータが送信されません。 したがって以下のような不具合が発生してしまいます。
あるHTMLフォームのチェックボックスを選択し、HTTPリクエストをサーバへ送る。 チェックボックスに該当するActionFormのプロパティ（boolean型）にtrueが設定される。 再び1と同じHTMLフォームにおいて、今度はチェックボックスの選択を外して、 HTTPリクエストをサーバへ送る。 ActionFormはセッションに登録されているため、 2と同じインスタンスが使用される。またチェックボックスに該当するパラメータは送信されないため、 該当するプロパティのsetterメソッドは呼ばれず、2で設定した値（true）がそのまま残る。 チェックボックスを使用する場合には上記のような不具合が生じるため、 ActionFormにはプロパティを初期化するためのメソッド「reset」が用意されています。 resetメソッドはHTTPリクエストからパラメータ値を読み取って設定する前に必ず呼ばれるものです。 ActionFormで何らかの初期化をそのタイミングで行いたい場合には、 resetメソッドをオーバーライドします。resetメソッドの中で初期化を行う事により、 チェックボックスを使用することにより生じる不具合を防ぐ事ができます。
HTMLフォーム情報に、キー値$keyで、値$valueを設定する。
既に、同一キー値がある場合には、上書きし、無い場合には追加する。
フォーム情報の有効性をチェックする抽象メソッド。
フォーム情報が有効であれば true 、無効であれば false を返す。
Documentation generated on Tue, 3 May 2005 22:52:00 +0900 by phpDocumentor 1.3.0RC3
Inherited from superActionView
superActionView::$_action_errors
superActionView::$_action_parameters
superActionView::$_debug
superActionView::$_savefile
ActionViewクラスのコンストラクタ。
デバッグ用に、以下のモードが用意されています。 通常は、ActionView()とするだけで十分です。
ActionView対応の拡張子かどうかを判定する具象メソッド。
テンプレートに対応するファイル拡張子になっているか判定する具象メソッド。
変更履歴：
内部配列に保持されたデータを、テンプレート$tplをもとに表示する具象メソッド。
この呼出により、内部配列とエラーを保持している配列はクリアされる。
Inherited From superActionView
superActionView::superActionView()
superActionView::append()
superActionView::appendErrorMessage()
superActionView::assign()
superActionView::check()
superActionView::clear()
superActionView::display()
Documentation generated on Tue, 3 May 2005 22:52:00 +0900 by phpDocumentor 1.3.0RC3
Persistentのコンストラクタ。
対応するオブジェクトをクリアする抽象メソッド。
session上の対応する変数を開放する。
session上の対応する変数名を返す抽象メソッド
対応するオブジェクトをsession上の対応する変数にシリアライズ化して格納する。
Documentation generated on Tue, 3 May 2005 22:52:01 +0900 by phpDocumentor 1.3.0RC3
ユーザのrequestを処理するActionContoroller。
ActionControllerのエントリーポイント。
perform()の呼び出しにより、以下の処理を行う。
変更履歴：
デバグ用メッセージ保存処理。
実行ファイル名、実行行番号、メッセージをログに保存する。 ログに保存するかどうかは、_LOGGINGが定義されていて、NULL以外のときのみである。
Documentation generated on Tue, 3 May 2005 22:52:00 +0900 by phpDocumentor 1.3.0RC3
HTMLフォームの情報を保持するActionFormクラス。
実際には、このActionFormクラスを継承して、フォームの情報を 保持するクラスを作成することによって実装します。
| Class | Description |
|---|---|
| ActionForm | ActionFormクラス。 |
Documentation generated on Tue, 3 May 2005 22:52:00 +0900 by phpDocumentor 1.3.0RC3
Viewを実現するActionViewクラス。
ActionControllerのActionクラスから出力データを受け取り、ActionForwardで、 表示指示があるまで保持する。 このViewでは、Smartyを使っている。 他のテンプレートを使うのであれば、メソッドをそのままに、このActionViewクラスを書き換える必要がある。
変更履歴：
| Class | Description |
|---|---|
| ActionView | ActionViewクラス。 |
Documentation generated on Tue, 3 May 2005 22:52:00 +0900 by phpDocumentor 1.3.0RC3
Actionの抽象クラス。
実際には、このActionクラスを継承して、ユーザのビジネスロジック、 例えば表示データの作成処理等を、executeメッソドをオーバーライド することによって呼び出します。
| Class | Description |
|---|---|
| Action | Actionクラス。 |
Documentation generated on Tue, 3 May 2005 22:52:00 +0900 by phpDocumentor 1.3.0RC3
ActionController内で使用する定数の定義。
Philotの初期起動時のURLを示す定数
可搬性を高めるために初期起動時のディレクトリを、定数 PHILOT_SELF に記憶する。
Smarty では、例のように使って、起動ディレクトりから独立することができる。
例：{$smarty.const.PHILOT_SELF}/hoge/foo/
3. 2005/03/08 PHILOT_SELF（起動ルートディレクトリ）定数の設定関数追加
4. 2005/03/14 PHILOT_SELF定数の設定関数名に、"_"を追加
action名を指定するクエリー名
ActionControllerの動作環境設定のキー名
ActionFormの論理フォーム名の属性を指定するArrayのキー名
Actionクラスの戻り値に対応するViewの論理名を指定するArray名のキー名
ウエッブからリクエストされたaction名とActionクラスの対応付けを行うArrayのキー名
エラー検出レベルを指定するキー名
ActionFormのvalidate()でエラーが発生した時の入力フォームURL
ロギング用ファイル名。指定しないかNULLの時はロギングしない。
ActionForm論理名。_ACTION_FORMSの中のキー値に対応している。
ActionまたはViewを指定する、/で始まるDocument_Rootからの相対パスを指定するキー名
falseにすると同一セッション内で、ページを遷移する。trueなら、セッションを破棄してページを遷移する。
ActionFormオブジェクトの生存スコープを示す。
（注意：このバージョンでは、何を設定しても、'request'とみなして処理をしている）
trueにすると、Smartyテンプレートがコンパイルされているかどうかを検査し、されていなければ、再コンパイルします。開発完了時にはfalse設定すること。
trueにすると、Smartyのデバッギングコンソールを表示します。
trueにすると、Smartyのデバッギングコンソールを表示します。
Actionのクラス名を指定するキー名
trueの時、ActionFormのvalidate()を呼び出して判定する。
初期画面の表示のためのaction名
Documentation generated on Tue, 3 May 2005 22:52:01 +0900 by phpDocumentor 1.3.0RC3
Sessionスコープの永続的Value Objectを実現する抽象クラス
| Class | Description |
|---|---|
| Persistent | Persistentクラス。 |
Documentation generated on Tue, 3 May 2005 22:52:01 +0900 by phpDocumentor 1.3.0RC3
Philotの読み込み
定数定義、クラス、コントローラの読み込み
HTMLフォームの情報を保持するActionFormクラスの読み込み
ActionController内で使用する定数定義の読み込み
Actionクラスの読み込み
Viewを実現するActionViewの親（抽象）クラスの読み込み
ユーザのrequestを処理するActionContorollerの読み込み
Viewを実現するActionViewクラスの読み込み
Documentation generated on Tue, 3 May 2005 22:52:01 +0900 by phpDocumentor 1.3.0RC3
Viewを実現するActionViewの抽象クラス。
Actionクラスから呼び出したModelの出力データを受け取り、 ActionForwardで、表示指示メソッドdisplay()が呼び出されるまで保持する。
| Class | Description |
|---|---|
| superActionView | superActionViewクラス。 |
Documentation generated on Tue, 3 May 2005 22:52:01 +0900 by phpDocumentor 1.3.0RC3
superActionViewクラス。
Located in /superActionView.php (line 18)
| Class | Description |
|---|---|
| ActionView | ActionViewクラス。 |
superActionViewクラスのコンストラクタ。
デバッグ用に、以下のモードが用意されています。 通常は、superActionView()とするだけで十分です。
出力データの値を追加。
キー値を$name、値を$valueとして、内部配列のキー値$nameに$valueを追加する。 もし、$key値が無ければ、$valueを新規登録する。
エラーメッセージを追加。
エラーメッセージを内部配列に追加する。
出力データの保持。
キー値を$name、値を$valueとして、内部配列に追加する。 既に、同じキー値で登録されている場合には、上書きする。
ActionView対応の拡張子かどうかを判定する抽象メソッド。
テンプレートに対応するファイル拡張子になっているか判定する抽象メソッド。
内部配列のクリア。
内部配列に保持されたデータを、テンプレート$tplをもとに表示する抽象メッソド。
この呼出により、内部配列とエラーを保持している配列はクリアされる。
Documentation generated on Tue, 3 May 2005 22:52:01 +0900 by phpDocumentor 1.3.0RC3