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

数据标签主要用于提供各种和数据访问相关的功能,如输出信息和显示调试信息等。常用的数据标签有 <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、JSPServlet 等)。该标签有两个属性 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。