Model-Glue FAQ

SeanのブログにModel-GlueのFAQ例が紹介されていた。
もう少しブレークダウンしたFAQが必要だとは思いますが、日本語訳したものを取り急ぎご紹介しておきます。

Eddie Awad’s Blog

全般

ビュースタックのうちどれがユーザに表示されますか？
レンダリングされた最後のViewだけがユーザに表示されます。

HTML FormとURL変数はどこに保存されますか？
全てのHTML formとURL変数は、ModelGlue.Core.Eventオブジェクトに保存されます。

Event起動の優先順位は？(resultタグ）
明示的なresult（名前属性を有する）を暗黙的なresult（名前属性を有しない）の前に起動します。

コントローラー:

データをViewに渡すには？
データをViewに渡す （コンプレックスデータタイプを含む）にはarguments.event.setValue(”name”, value)を使います。

ModelGlue.xmlのConfigデータセクションにアクセスするには？
<config>と</config>で与えられるModelGlue.xmlのConfigデータセッティングにアクセスするには、GetModelGlue().getConfigSetting(”settingName”)を使います。

マップドイベントを呼び出すには？
resultをeventにマッピングし、イベントを呼び出すにはarguments.event.addResult(”eventName”)を使います。

ConfigBeanへの参照を得るには？
まず、 <cfset appConfig = GetModelGlue().GetConfigBean("yourBeanFile.xml")> を使い、 セットしたデータをフェッチするには、appConfig.getSettingName() を使います。

Messageの引数にアクセスするには？
arguments.event.getArgument(”name”)を使います。

ModelGlue.xml:

Viewにデータを送るには？
Viewにデータを送るには、 <include>タグの中で<value>タグをこのように使います。 
<event-handler name="dosomething">
            <views>
                <include template=”view.cfm” name=”body”>
                    <value name=”name” value=”value” />
                </include>
            </views>
        </event-handler>
overwrite=”true” か overwrite=”false” を <value>タグに追加することによって、オーバライドするかしないかを指定することができます。

既存Viewに追加するには?
ユニークでないView名をincludeタグに与えるには、'append=”true”‘ を属性に追加しますI。そうすることで、既存Viewのコンテンツに追加書き出しできます。
    <event-handler name="dosomething">
        <views>
            <include template=”view1.cfm” name=”body” />
            <include template=”view2.cfm” name=”body” append=”true” />
        </views>
    </event-handler>
‘append=”true”‘ がない場合、既存Viewをオーバライドします。

ModelGlue.xmlに一つまたはそれ以上のControllerを定義できますか？
はい、複数のControllerを定義できますが、Controller間でユニークなmessage名である必要があります。

Model-Glueには特別なmessageが準備されていますか？
ModelGlue.xmlでは, Controller内に次のような特別なMessageをマッピングできます：

onRequestStart: リクエスト開始時に必要となる処理をここに記述します。
onRequestEnd: リクエスト終了時に必要となる処理をここに記述します。
onQueueComplete: すべてのViewが追加され、レンダリングされる前に必要となる処理をここに記述します。

messageに引数を追加できますか？
はい、次のようにしてMessageに引数を追加できます。
<message name="dosomething">
        <argument name=”name” value=”value” />
    </message>
Controller内の対応するファンクション内で次のようにして引数を読み出せます。
arguments.event.getArgument(”name”)

Views:

レンダリングされたViewスタック内のViewにデータをセットするには？
Use viewState.setValue(”name”,”value”)

Controller、ModelGlue.xml及びViewスタックからデータを読み出すには？
Use viewState.getValue(”name”, “default value”)

Viewスタック内におけるViewの存在をチェックするには？
Use viewCollection.Exists(”viewName”)

過去に定義されたViewコンテンツを表示するには？
Use viewCollection.getView(”viewName”)

リソース:

• Model-Glue.com
• Quick start guide
• Quick tutorial
• Model-Glue category at corfield.org
• Model-Glue category right here at awads.net