「Struts2 カスタムタグ 文法」の版間の差分
(同じ利用者による、間の1版が非表示) | |||
1行目: | 1行目: | ||
− | ==Struts2 カスタムタグ 文法== | + | ==[[Struts2 カスタムタグ 文法]]== |
− | {{include_html import_keyword_html, "!struts2"}} | + | {{include_html [[import_keyword_html]], "!struts2"}} |
カスタムタグは、動的なデータを表示するように設計されています。"postalCode"プロパティを表示するinput フィールドを生成するには、"postalCode"を textfield タグに渡します。 | カスタムタグは、動的なデータを表示するように設計されています。"postalCode"プロパティを表示するinput フィールドを生成するには、"postalCode"を textfield タグに渡します。 | ||
13行目: | 13行目: | ||
<s:textfield label="%{getText("postalCode.label")}" name="postalCode"/> | <s:textfield label="%{getText("postalCode.label")}" name="postalCode"/> | ||
− | + | [http://struts.apache.org/2.x/docs/ognl.html OGNL 式言語]は、メソッドを呼び出し、プロパティを評価します。 | |
getTextメソッドは、ActionSupportにより提供されています。ActionSupportは、ほとんどのアクションの基底クラスです。 | getTextメソッドは、ActionSupportにより提供されています。ActionSupportは、ほとんどのアクションの基底クラスです。 | ||
Actionは、スタックに乗っているため、getTextを含む、どのメソッドも式から呼び出すことができます。 | Actionは、スタックに乗っているため、getTextを含む、どのメソッドも式から呼び出すことができます。 | ||
====文字列ではない属性属性==== | ====文字列ではない属性属性==== | ||
− | + | [[HTTP]]プロトコルは、テキストベースですが、いくつかのタグは、文字列ではない属性型を持ちます。例えば、boolやintなど。 | |
文字列ではない属性を利用するため、フレームワークが全ての文字列ではない属性を式として評価します。 | 文字列ではない属性を利用するため、フレームワークが全ての文字列ではない属性を式として評価します。 | ||
以下の例では、エスケープ記法を使用する必要はありません。(もし付加したとしても、フレームワークが取り除きます) | 以下の例では、エスケープ記法を使用する必要はありません。(もし付加したとしても、フレームワークが取り除きます) | ||
48行目: | 48行目: | ||
<s:textfield label="%{getText("state.label")}" name="state" value="CA"/> | <s:textfield label="%{getText("state.label")}" name="state" value="CA"/> | ||
− | もし、textfield が、"CA"という値を渡されたら、フレームワークは、getCa | + | もし、textfield が、"CA"という値を渡されたら、フレームワークは、getCa プロパティを探す。おそらくそれは、意図するところではない。文字列を渡すことを意図しているはずだ。式[[言語]]においては、定数は、引用符に囲んで表す。 |
'''文字列定数を渡す正しい方法''' | '''文字列定数を渡す正しい方法''' | ||
<s:textfield label="%{getText("state.label")}" name="state" value="%{'CA'}" /> | <s:textfield label="%{getText("state.label")}" name="state" value="%{'CA'}" /> | ||
− | もうひとつの方法は、value="'CA'" | + | もうひとつの方法は、value="'CA'"とする方法だ。しかし、こういった例では、式[[言語]]の記法を推奨する。 |
要約すれば、タグの属性は、3つのルールにより評価される。 | 要約すれば、タグの属性は、3つのルールにより評価される。 |
2020年2月16日 (日) 04:32時点における最新版
Struts2 カスタムタグ 文法
{{include_html import_keyword_html, "!struts2"}} カスタムタグは、動的なデータを表示するように設計されています。"postalCode"プロパティを表示するinput フィールドを生成するには、"postalCode"を textfield タグに渡します。
動的 input field の生成
<s:textfield name="postalCode"/>
もし、"postalCode"プロパティが、value stack にある場合、input フィールドには、その値がセットされます。フィールドがフレームワークにサブミットされたとき、コントロールの値は、"postalCode"プロパティにセットされます。
しばしば、動的なデータをタグに渡したい場合があります。例えば、inputフィールドとラベルを表示する場合に、ラベルの内容をアプリケーションの メッセージリソースから取得したいとします。この場合、適宜フレームワークはタグの属性に含まれる式を解析するので、動的な属性をタグに混ぜ込むことができます。式のエスケープシーケンスは、"%{ ... }" です。エスケープシーケンスに埋め込まれたどのようなテキストも、式として評価されます。
ラベルのセットに式を使用する
<s:textfield label="%{getText("postalCode.label")}" name="postalCode"/>
OGNL 式言語は、メソッドを呼び出し、プロパティを評価します。 getTextメソッドは、ActionSupportにより提供されています。ActionSupportは、ほとんどのアクションの基底クラスです。 Actionは、スタックに乗っているため、getTextを含む、どのメソッドも式から呼び出すことができます。
文字列ではない属性属性
HTTPプロトコルは、テキストベースですが、いくつかのタグは、文字列ではない属性型を持ちます。例えば、boolやintなど。 文字列ではない属性を利用するため、フレームワークが全ての文字列ではない属性を式として評価します。 以下の例では、エスケープ記法を使用する必要はありません。(もし付加したとしても、フレームワークが取り除きます)
booleanを評価
<s:select label="%{getText("state.label")}" name="state" multiple="true"/>
multiple 属性は、booleanプロパティにマップされるため、フレームワークは値をStringと解釈しません。 値は式として評価され、自動的にbooleanに変換されます。
属性がStringかそうでないかは忘れやすいため、エスケープ記法を使用することもできます。
boolean を評価(詳細)
<s:select label="%{getText("state.label")}" name="state" multiple="%{true}"/>
boolean を評価(プロパティの使用)
<s:select label="%{getText("state.label")}" name="state" multiple="allowMultiple"/>
boolean を評価(プロパティの使用 詳細)
<s:select label="%{getText("state.label")}" name="state" multiple="%{allowMultiple}"/>
value は オブジェクト!
ほとんどの場合、value属性は自動でセットされるので、name属性は通常どのプロパティをvalueにセットするのかをフレームワークに教えます。 しかし、valueを直接設定する理由がある場合、valueは、オブジェクトであり、Stringではないことを承知しておく必要がある。
※ valueはStringではないため、いつでも、valueは評価されるべき式として渡される。- 文字列定数としてではない。
きっと動作しない!
<s:textfield label="%{getText("state.label")}" name="state" value="CA"/>
もし、textfield が、"CA"という値を渡されたら、フレームワークは、getCa プロパティを探す。おそらくそれは、意図するところではない。文字列を渡すことを意図しているはずだ。式言語においては、定数は、引用符に囲んで表す。
文字列定数を渡す正しい方法
<s:textfield label="%{getText("state.label")}" name="state" value="%{'CA'}" />
もうひとつの方法は、value="'CA'"とする方法だ。しかし、こういった例では、式言語の記法を推奨する。
要約すれば、タグの属性は、3つのルールにより評価される。
- 全ての文字列属性型は、"%{ ... }"として、解析される。
- すべての文字列でない属性型は、解析されない。しかし、直接式が書かれたものとして評価される。
- 文字列ではない属性でエスケープ記法"{%{}"を利用した場合、ルール2の例外となる。この記法は冗長として無視され、内容が評価される。
© 2006 矢木浩人