lablab.jp （日本語版）

私は今日も、ActionFormのお勧めの手順について説明します。

Validate

ActionFormはそれの中で妥当性検査をします。 例えば、「メール」は特別なパターンがある文字列です。 ActionFormは文字列として入力値をとって来て、メールとしてそれを検査します。 この場合、文字列はフォームプロパティの情報です、そして、メールはフィールドプロパティの情報です。

フィールドプロパティ設定によって、その妥当性検査は働きます。XCubeとLegacyには、様々なフィールドプロパティがあります。 もちろん、開発者はフィールドプロパティとして彼らのバリデーションパターンを追加することができます。

値が妥当性検査に違反するなら、ActionFormは検査と結びつけられるエラーメッセージを保持するようになります。そして、また、ワンタイムトークン(チケット)がこの過程でチェックされます。 XCube_ActionFormのワンタイムトークンは、トランザクショントークンの１種です。開発者はバリデーションとして、ワンタイムトークンを扱うことができます。

Error Check

hasError()は、ActionFormにエラーがあるかどうかチェックします。 開発者はgetErrorMessages()メンバー関数を通じてActionFormのエラーメッセージにアクセスすることができます。

Cubsonは、ビジネスロジックを、リクエストの種類で変更することを勧めます。 それがGETかエラーであるなら、うまくいくまで入力形式を何度でも表示してください。 POSTであり、それがエラーでなければ、次の手順に行ってください。 このループによって、ユーザはそれがエラーであっても彼の入力値を失いません。

例えば、myaccountモジュールで、メッセージ値なしで「送信」ボタンをクリックしてみてください。 1つのエラーメッセージが表示されるでしょう。しかし、subject は失われません。あなたはメッセージフォームを満たすまで、次の手順に行くことができません。同様に、トークンエラーの場合も、このループは働きます。