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