Struts2数据标签：<s:property><s:a><s:debug><s:include><s:param>等

时间：12-11来源：作者：点击数：

数据标签主要用于提供各种和数据访问相关的功能，如输出信息和显示调试信息等。常用的数据标签有 <s:property>、<s:a>、<s:debug>、<s:include> 和 <s:param> 等。

<s:property>标签

<s:property> 标签的作用是输出指定的值，通常输出的是 value 属性指定的值，<s:property> 标签的属性及属性说明如下。

value：可选属性，指定需要输出的属性值，如果没有指定该属性，则默认输出 ValueStack 栈顶的值（关于值栈内容会在后面教程中进行讲解）。
id：可选属性，指定该元素的标识。
default：可选属性，如果要输出的属性值为 null，则显示 default属性的指定值。
escape：可选属性，指定是否忽略 HTML 代码。默认值是 true，即忽略输出值中的 HTML 代码。

为了使读者更好地掌握 <s:property> 标签的使用，下面编写案例进行演示。在项目的 WebContent 目录下创建一个名称为 propertyTags.jsp 的文件，编辑后如下所示。

<%@ page language="java" contentType="text/html; charset=utf-8"
    pageEncoding="utf-8"%>
<%@taglib prefix="s" uri="/struts-tags" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>property标签</title>
</head>
<body>
    输出字符串：
    <s:property value="'this is a string'"/><br/>
    输出默认值：
    <s:property value="" default="default_value"/><br/>
    忽略HTML代码：
    <s:property value="'<h2>www.cdsy.xyz</h2>'" escape="true"/><br/>
    不忽略HTML代码：
    <s:property value="'<h2>www.cdsy.xyz</h2>'" escape="false"/><br/>
</body>
</html>

上述代码中，分别对 <s:property> 标签的 value、default 和 escape 属性的使用进行了演示。启动项目后，在浏览器的地址栏中输入地址 http://localhost:8080/struts2Demo04/propertyTags.jsp 访问 propertyTags.jsp，浏览器的显示结果如图 1 所示。

图 1 property标签的输出

<s:a>标签

<s:a> 标签与 HTML 中的 <a> 标签类似，主要用于构造 HTML 页面中的超链接。<s:a> 标签的属性及相关说明如表 1 所示。

表 1 标签的常用属性及描述
属性	是否必须	类型	描述
action	否	String	指定超链接 Action 地址
href	否	String	超链接地址
namespace	否	String	指定 Action 地址
id	否	String	指定其 id
method	否	String	指定 Action 调用方法

<s:a> 标签的使用格式如下所示：

<s:a href="链接地址"></s:a>
<s:a namespace="" action="">www.baidu.com</s:a>

<s:debug>标签

<s:debug> 标签用于输出服务端对象（如 request、application、ValueStack 等）中的信息，该标签可用于辅助调试 Java Web 程序。

<s:debug> 标签只有一个 id 属性，表示 <s:debug> 标签的一个引用，通常不使用该属性。在使用 <s:debug> 标签后，网页中会生成一个 Debug 的链接，单击该链接，网页中将输出各种服务器对象的信息，如图 2 所示。

图 2 Debug标签

<s:include>标签

<s:include> 标签用于在当前页面中包含另一个 Web 资源（如 HTML、JSP、Servlet 等）。该标签有两个属性 id 和 value。其中 id 是可选属性，表示该标签的引用；value 是必填属性，用于指定被包含的 Web 资源文件。

在 <s:include> 标签中还可以指定多个 <s:param/> 子标签给被包含的 Web 资源传递请求参数。下面通过案例演示 <s:include> 标签的使用。

在 struts2Demo04 项目的 WebContent 目录下创建一个名称为 includeTags.jsp 的页面和一个名称为 file.jsp 的页面，在 includeTags.jsp 页面中使用 <s:include> 标签包含 file.jsp 页面。其中被包含页面 file.jsp 的主要代码如下所示。

<%@ page language="java" contentType="text/html; charset=utf-8"
    pageEncoding="utf-8"%>
<%@taglib prefix="s" uri="/struts-tags" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>property标签</title>
</head>
<body>
    <h2>这是被包含页面includefile.jsp</h2><br/>
    传递的参数为：<%out.print(request.getParameter("username")); %>
</body>
</html>

包含页面 includeTags.jsp 的主要代码如下所示。

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>includeTags</title>
</head>
<body>
    <h3>这是包含页面includeTags.jsp</h3><br/>
    <s:include value="file.jsp">
        <s:param name="username" value="'小韩'"/>
    </s:include>
</body>
</html>

启动项目后，在浏览器的地址栏中输入 http://localhost:8080/struts2Demo04/includeTags.jsp 访问 includeTags.jsp，浏览器的显示结果如图 3 所示。

从图 3 中可以看出，includeTags.jsp 页面使用 <s:include> 标签已经成功将 file.jsp 页面包含在其中，并且通过 <s:param> 标签已将参数和参数值传递给了被包含页面 file.jsp。

图 3 <s:include>标签的使用