Struts2標簽使用原理解疑
在筆者下載的Struts2的包中,讀者可以在/lib下找到struts2-core-2.0.11.1.jar包,解壓該包在其根目錄下的/META-INF文件夾下可以看到一個名字為“struts-tags.tld”文件。該文件就是Struts2中所有自帶的標簽庫定義。本節通過對該文件代碼的介紹來讓讀者知曉Struts2內部是如何使用這些標簽來進行工作。并簡單說明JSP中是如何用其來書寫標簽代碼。
技術要點
本節代碼說明Struts2內部定義標簽的格式和在JSP中使用方式。
? struts-tags.tld文件定標簽定義配置格式。
? JSP中使用標簽功能介紹。
演示代碼
- <!------------------文件名: struts-tags.tld----------------->
- <taglib>
- <tlib-version>2.2.3</tlib-version>
- <jsp-version>1.2</jsp-version>
- <short-name>s</short-name>
- <uri>/struts-tags</uri>
- <display-name>"Struts Tags"</display-name>
- <description>………………</description>
- <tag>
- <name>action</name>
- <tag-class>org.apache.struts2.views.jsp.ActionTag</tag-class>
- <body-content>JSP</body-content>
- <description><![CDATA[Execute an action from within a view]]></description>
- <attribute>
- <name>executeResult</name>
- <required>false</required>
- <rtexprvalue>false</rtexprvalue>
- <description><![CDATA[Whether the result of this action (probably a view) should be executed/rendered]]></description>
- </attribute>
- …………………………
- <attribute>
- <name>namespace</name>
- <required>false</required>
- <rtexprvalue>false</rtexprvalue>
- <description><![CDATA[Namespace for action to call]]></description>
- </attribute>
- </tag>
- </taglib>
<!------------------文件名: struts-tags.tld----------------->
<taglib>
<tlib-version>2.2.3</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>s</short-name>
<uri>/struts-tags</uri>
<display-name>"Struts Tags"</display-name>
<description>………………</description>
<tag>
<name>action</name>
<tag-class>org.apache.struts2.views.jsp.ActionTag</tag-class>
<body-content>JSP</body-content>
<description><![CDATA[Execute an action from within a view]]></description>
<attribute>
<name>executeResult</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description><![CDATA[Whether the result of this action (probably a view) should be executed/rendered]]></description>
</attribute>
…………………………
<attribute>
<name>namespace</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description><![CDATA[Namespace for action to call]]></description>
</attribute>
</tag>
</taglib>
代碼解釋
(1)struts-tags.tld是Struts2自標簽定義文件。所有標簽定義都是在<tablib>和</taglib>之間定義。以<tag></tag>用來定義一個具體標簽。每個標簽因為都可以有很多自己的屬性。這些屬性定義都是以<attribute></attribute>來定義。
(2)<tlib-version></tlib-version>之間定義的是標簽庫的版本。<jsp-version></jsp-version>定義的是標簽庫這些標簽是支持JSP的哪個版本。<short-name> </short-name>其實是標簽庫的默認名,也可以認為是其昵稱。<uri> </uri>定義的是標簽庫的URI,在JSP中會使用到。<display-name></display-name>是顯示名。<description></description>是標簽庫的記述,記述標簽庫的使用用途等等。
(3)<attribute>中<name></name>是屬性名稱定義。<required></required>表示的該屬性是否是必須的屬性,如果是必須的則<required></required>之間為true,否則為false。<rtexprvalue></rtexprvalue>表示的是可否使用表達式,大多數標簽都是為false。這里不是不能使用表達式,而是恰恰相反表示可以使用表達式。<description></description>定義和前面介紹相同。
(4)在JSP中,如之前章節的演示代碼所示,都是在文件頭有個使用標簽的聲明,代碼如下。
- <!---------------------文件名: *.jsp------------------------->
- <%@taglib prefix="s" uri="/struts-tags"%>
<!---------------------文件名: *.jsp------------------------->
<%@taglib prefix="s" uri="/struts-tags"%>
有了這個聲明,在JSP文件中就可以使用Struts2的標簽。比如form標簽定義要像如下代碼所示。
- <s:form action="upload" ………>
<s:form action="upload" ………>
記住一定要用“s”,它是Struts2中標簽的默認名也是相當于一個昵稱,當然讀者也可以把它改為自己想取的名字,不過在標簽聲明中的“prefix”中就要改成那個自己取的名字。
注意:因為筆者使用的Servlet版本是2.3之上的版本,因此沒必要在web.xml中定義標簽庫。如果讀者使用的Servlet版本比較低,則在web.xml文件中需要定義如下的代碼:
- <!----------------------文件名:web.xml----------------------->
- <taglib>
- <!- 定義URI - ->
- <taglib-uri>/Struts 2-tags</taglib-uri>
- <!- 定義標簽庫支持的jar包位置- ->
- <taglib-location>/WEB-INF/lib/struts2-core-2.0.11.1.jar</taglib-location>
- </taglib>
<!----------------------文件名:web.xml----------------------->
<taglib>
<!- 定義URI - ->
<taglib-uri>/Struts 2-tags</taglib-uri>
<!- 定義標簽庫支持的jar包位置- ->
<taglib-location>/WEB-INF/lib/struts2-core-2.0.11.1.jar</taglib-location>
</taglib>
只有這樣標簽庫才會在Servlet版本比較低的情況下使用有效果。
posted on 2009-04-13 15:28
lanxin1020 閱讀(463)
評論(0) 編輯 收藏 所屬分類:
struts2