Struts2课程 - 5.1 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>
代码解释
（ 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 文件中就可以使用Struts2 的标签。比如form 标签定义要像如下代码所示。
<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>
只有这样标签库才会在Servlet 版本比较低的情况下使用有效果。
更多信息请查看 java进阶网 http://www.javady.com/index.php/category/thread