首页 > Struts2

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

< 上一页Struts2的控制标签 Struts2的模板和主题下一页 >
数据标签主要用于提供各种和数据访问相关的功能，如输出信息和显示调试信息等。常用的数据标签有 <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.w3school.com.cn</h2>'" escape="true"/><br/>
    不忽略HTML代码：
    <s:property value="'<h2>www.w3school.com.cn</h2>'" escape="false"/><br/>
</body>
</html>
上述代码中，分别对 <s:property> 标签的 value、default 和 escape 属性的使用进行了演示。启动项目后，在浏览器的地址栏中输入地址 http://localhost:8080/struts2Demo04/propertyTags.jsp 访问 propertyTags.jsp，浏览器的显示结果如图 1 所示。

property标签的输出
图 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 所示。

Debug标签
图 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。
<s:include>标签的使用
图 3  <s:include>标签的使用

<s:param>

<s:param> 标签主要用于为其他标签提供参数，通常要与其他标签一起使用。在上一部分使用 <s:include> 标签时，就使用了 <s:param> 标签给被包含的页面传递参数。<s:param> 标签有两种用法，具体如下。

一种用法是通过标签体指定参数值，用法如下所示：

<s:param name="color">red</s:param>

另一种用法是使用 value 属性指定参数值，用法如下所示：

<s:param name="color" value="'red'"/>

上述两种用法的功能一样，不同点在于使用 value 属性设置参数值时，需要添加单引号，而使用标签体设置参数值时，不需要添加单引号。

注意：在使用 value 属性指定参数时，如果不添加单引号，则表示该值为一个引用对象，如果该对象不存在，则为其属性赋值为 null。
< 上一页Struts2的控制标签 Struts2的模板和主题下一页 >