Struts2数据标签:<s:property><s:a><s:debug><s:include&g 图片看不了?点击切换HTTP 返回上层
数据标签主要用于提供各种和数据访问相关的功能,如输出信息和显示调试信息等。常用的数据标签有 <s:property>、<s:a>、<s:debug>、<s:include> 和 <s:param> 等。
为了使读者更好地掌握 <s:property> 标签的使用,下面编写案例进行演示。在项目的 WebContent 目录下创建一个名称为 propertyTags.jsp 的文件,编辑后如下所示。
图 1 property标签的输出
<s:a> 标签的使用格式如下所示:
<s:debug> 标签只有一个 id 属性,表示 <s:debug> 标签的一个引用,通常不使用该属性。在使用 <s:debug> 标签后,网页中会生成一个 Debug 的链接,单击该链接,网页中将输出各种服务器对象的信息,如图 2 所示。
图 2 Debug标签
在 <s:include> 标签中还可以指定多个 <s:param/> 子标签给被包含的 Web 资源传递请求参数。下面通过案例演示 <s:include> 标签的使用。
在 struts2Demo04 项目的 WebContent 目录下创建一个名称为 includeTags.jsp 的页面和一个名称为 file.jsp 的页面,在 includeTags.jsp 页面中使用 <s:include> 标签包含 file.jsp 页面。其中被包含页面 file.jsp 的主要代码如下所示。
从图 3 中可以看出,includeTags.jsp 页面使用 <s:include> 标签已经成功将 file.jsp 页面包含在其中,并且通过 <s:param> 标签已将参数和参数值传递给了被包含页面 file.jsp。
图 3 <s:include>标签的使用
一种用法是通过标签体指定参数值,用法如下所示:
注意:在使用 value 属性指定参数时,如果不添加单引号,则表示该值为一个引用对象,如果该对象不存在,则为其属性赋值为 null。
<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 所示。
图 1 property标签的输出
<s:a>标签
<s:a> 标签与 HTML 中的 <a> 标签类似,主要用于构造 HTML 页面中的超链接。<s:a> 标签的属性及相关说明如表 1 所示。属性 | 是否必须 | 类型 | 描述 |
---|---|---|---|
action | 否 | String | 指定超链接 Action 地址 |
href | 否 | String | 超链接地址 |
namespace | 否 | String | 指定 Action 地址 |
id | 否 | String | 指定其 id |
method | 否 | String | 指定 Action 调用方法 |
<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>标签的使用
<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。