struts的html标签库

来源：互联网发布：淘宝如何抢秒杀商品编辑：程序博客网时间：2024/05/16 05:49

Struts 提供了一个强大的HTML 标签库来帮助你构建 Web 应用程序。

为了更容易、更快速地进行开发， Struts 提供了功能同其它 JSP 标签库类似的五个标签库，即： HTML 、 Bean、 Logic 、 Template 和Nested 。第一部分讲述如何配置一个Struts 应用程序来运用这个标签库，并介绍了第一组标签；第二部分讲述了第二组标签；

HTML 标签库主要用来显示HTML 元素，如果不用这种方法，你就必须用HTML 标签来指定它们。从表面上看，这个标签库很简单。但是通过深入研究，我们就会发现它很强大。例如，它可以为我们在HTML 表单的一个特定输入元素中放置重点内容生成JavaScript ，或为客户端输入验证生成脚本。而且，你可以用它通过一行代码来处理错误。然而，在将这个标签库用于你的Struts 应用程序前，你需要做些简单的准备工作。

配置应用程序来运用标签库
在运用 Struts HTML标签库前，你需要通过三个步骤来配置一个 Struts应用程序。

1. 在部署描述符（web.xml 文件）中注册标签库：

<taglib-uri>/WEB-INF/struts-html.tld</taglib-uri>

<taglib-location>/WEB-INF/struts-html.tld</taglib-location>
</taglib>

上面的代码就告诉了 servlet container 有关 Struts HTML 标签库的情况，以及在哪里可以找到标签库的 TLD 文件。

2. 确信将struts-html.tld 文件复制到WEB-INF 目录中。你不用担心标签库类文件，因为它们已经包含在struts.jar 文件中了。

3. 在运用标签库的每个JSP 页面中，插入下面的 <taglib> 指示符：
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
另外，你也可以运用 struts-html.tld文件来学习它所支持的标签以及每个标签可以带有哪些属性。

运用一个自定义的标签库通常是很容易的：只要遵循前面讲述的步骤就行了。然而，有些标签库包含一些原则，这些原则使我们在运用这些标签库时并不那么容易。Struts HTML 标签库就是其中之一。有些标签很简单、很容易使用；然而，另外有些标签则取决于Struts 应用程序中的其它标签或其它元素。

我将 HTML标签库中的标签大致分成了两类：简单、容易使用的标签，我把它们称为 “ 独立的标签 ”，第二类是必须通过一个 form标签来使用的标签。我把第二类的标签简单地称为与 form 相关的标签。本文主要讲述独立的标签，在本系列文章的第二部分我将讲述与 form相关的标签。

HTML 标签库包含几个很容易使用的独立的标签。下面讲述几个比较重要的标签。

<html> 标签
<html> 标签是 HTML标签库中最容易的标签。它有两个属性： locale和 xhtml ，两者都不是必需的。下面的代码选自一个运用 <html> 标签的 JSP 页面：
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>

<html:html locale="true">

<head>

<title>Welcome</title>

</head>

<body>

Hello World!

</body>

</html:html>

注意，我们没有用标准的 <html> 元素，而是用了 <html:html> 标签。其中第一个 html 指的是前缀，第二个是 <html> 标签本身。而且我们也用了 locale 属性。 JSP页面将显示成：
<html lang="en">

<head>

<title>Welcome</title>

</head>

<body>

Hello World!

</body>

</html>

注意， <html:html locale=“true”>中的 locale 属性在生成的 HTML 页面中被转换成了lang=“en” 。生成的结果取决于Struts 应用程序所位于的服务器的locale 。如果你将应用程序部署到一个不同locale 的服务器，你不需要改变代码。Locale 会自动调整。

<base> 标签
<base> 标签显示一个 HTML元素，用一个 href 属性表示所包含的 JSP 页面的绝对位置。只有当这个标签是内嵌在一个head 标签部分时，它才有效。例如这个JSP 页面：
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>

<html:html locale="true">

<head>

<title>Welcome</title>

<html:base/>

</head>

<body>

Hello World!

</body>
</html:html>

会转换成以下形式：
<html lang="en">

<head>

<title>Welcome</title>

</head>

<body>

Hello World!

</body>
</html>

<img> 标签
<img> 标签用来生成一个 HTML <IMG> 标签。它最重要的属性有：
·page ：图象文件相对于模块的路径；前面必须带有一个斜线
·height ：图象的高度
·width ：图象的宽度
·alt ：如果找不到图象，显示的文本

例如：
<html:img page="/logo.gif" height="50" width="200" alt="Company Logo"/>

会转换成：
<img src="/myStrutsApp/logo.gif" height="50" width="200" alt="Company Logo">

<link> 标签
<link> 标签会生成一个超链接。例如标签：
<html:link page="/index.html">Click here</html:link>
会转换成：
<a href="/myStrutsApp6/index.html">Click here</a>

<errors> 标签
<errors> 标签的易于使用性通常会掩盖其真正的强大功能。通过一个简单的 <html:errors/> 标签，你就可以在一个 JSP 页面上显示完全自定义的错误信息。

这个标签检查 Request 对象的属性集合来查找一个 reserved key 。如果它找到一个 reserved key ，它就假设这个 key 是一个 String、或是一个 String 数组（它包含在模块的 MessageResources 中查找的 message keys ）、或是类型为 org.apache.struts.action.ActionErrors的一个对象。

如果在应用程序资源中存在相应的信息，那么就可以用下面这些可选的 message keys ：
· errors.header ：相应的信息在错误信息的单独列表前显示
· errors.footer ：相应的信息在错误信息的单独列表后显示
· errors.prefix ：相应的信息在错误信息的单独列表前显示
· errors.suffix ：相应的信息在错误信息的单独列表后显示

Struts HTML 标签库会使开发更容易、更快速。为了有效地运用这个标签库，你需要对标签库中的标签很熟悉。在本系列文章的第一部分中，你学习了如何配置一个 Struts 应用程序来运用标签库，并对独立的标签有了总体的了解。
在下面第二部分中，你将学习与 form 相关的标签，讲述了如何使用 Struts 提供的 form相关的标签。
与 form 相关的标签包括 <form> 标签本身以及所有必须包含在其中的标签。比如， <text> 和 <password> 标签就是和form 相关的标签，因为如果不把它们放到一个form 中它们就没有意义。

<form> 标签
<form> 标签用于生成一个 HTML form 。使用该标签时必须遵循许多规则。
首先要遵循的规则是 ，<form> 标签中必须包含一个action 属性，它是这个标签中唯一必需的属性。如果不具备该属性则JSP 页面会抛出一个异常。之后你必须给这个action 属性指定一个有效值。一个有效值是指应用程序的Struts 配置文件中 <action-mappings> 元素里的任何一个 <action> 子元素的访问路径。而且相应的 <action> 元素中必须有一个 name 属性，它的值是 form bean的名称。

例如，如果你有这样一个 <form> 标签： <html:form action="/login" >

那么你的 Struts配置文件的 <action-mappings>元素中必须有一个如下显示为粗体的 <action>元素：
<action-mappings>
     <action path="/login"
      type="com.javapro.struts.LoginAction"
      name="loginForm"
      scope="request"
      input="/login.jsp">
      <forward name="success" path="/mainMenu.jsp"/>
    </action>
    .
    .
    .
</action-mappings>

这就是说一个form 标签是和 form bean 相关联的。

另一个要遵循的规则是： 任何包含在<form> 中用来接收用户输入的标签（<text> 、 <password> 、 <hidden>、 <textarea> 、 <radio> 、<checkbox> 、 <select> ）必须在相关的 form bean 中有一个指定的属性值。比如，如果你有一个属性值被指定为 “username” 的 <text>标签，那么相关的 form bean中也必须有一个名为 “username”的属性。输入 <text> 标签中的值会被用于生成 form bean 的 userName 属性。

除了上面所讲的属性之外， <form> 标签还有一些不是必须但加上更好的 “ 次要 ” 的属性 。比如，你可以用focus 属性来生成 JavaScript ，它会 “ 定焦 ” （ focus ）到该form 所包含的一个元素上。使用focus 属性时你需要给它指定元素的名称。比如，以下代码是定焦在第二个Text 元素上的：

<body>
<html:form action="/login" focus="password">
User Name: <html:text property="userName"/>
<br>Password: <html:text property="password"/>
<br><html:submit/>
</html:form>
</body>
该段代码会被转换成：
<body>
<form name="loginForm" method="post" action="/myStrutsApp6/login.do">
User Name: <input type="text" name="userName" value="">
<br>Password: <input type="text" name="password" value="">
<br><input type="submit" value="Submit">
</form>
<script language="JavaScript"
type="text/javascript">

</script>

</body>
注意， <form>标签中 method 属性的缺省值是 POST 。另外，有没有看到这个标签库是如何建立JavaScript 来定焦到password 元素上的 ? 这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程，它会帮你自动生成。

在运行前面的例子时还要注意，你必须有一个包含 userName 和 password属性的相关 form 。你可以参考本文第三部分中的 Login 程序。

<text> 标签
<text> 标签用于生成一个文本的输入区域。它必须包含和相关 form bean 中的相同属性对应的 “property” 属性。该标签只有在嵌入到一个 <form> 标签中时才有效。
例如： <html:text property="userName"/>
会被转换成： <input type="text" name="userName" value="">

<password> 标签
<password> 标签用于生成一个口令字（ type password ）的输入区域。它必须包含和相关 form bean 中的相同属性对应的 “property” 属性。该标签只有在嵌入到一个 <form> 标签中时才有效。该标签中的一个很重要的属性是 “redisplay” ，它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true 。然而，为了使 password 不能被重新显示，你或许希望将该属性的值设为 false 。
例如： <html:password property="password" redisplay="false"/>
会被转换成 : <input type="password" name="password" value="">

<hidden> 标签
<hidden> 标签用于生成一个隐藏文本的输入区域。它必须包含和相关 form bean 中的相同属性对应的 “property” 属性。该标签只有在嵌入到一个 <form> 标签中时才有效：
例如： <html:hidden property="userName"/>
会被转换成 : <input type="hidden" name="userName" value="">

<textarea> 标签
<textarea> 标签用于生成一个文本区元素（ text area element ）。它必须包含和相关 form bean 中的相同属性对应的 “property” 属性。

比如：
<html:textarea property="details" cols="80" rows="20" value="Enter details here"/>
会被转换成：
<textarea name="details" cols="80" rows="20">Enter details here</textarea>

<radio> 标签
<radio> 标签用于显示一个单选按钮（ radio button ）。它必须包含 “value” 属性。比如这段代码：
<html:radio property="title" value="1"/>Mr.
<html:radio property="title" value="2"/>Ms.
<html:radio property="title" value="3"/>Dr.
会被转换成这样的 HTML：
<input type="radio" name="title" value="1">Mr.
<input type="radio" name="title" value="2">Ms.
<input type="radio" name="title" value="3">Dr.

<checkbox> 标签
<checkbox> 标签用于显示 checkbox 类型的输入区域。比如：
<html:checkbox property="notify"/>Please send me notification
会被转换成：
<input type="checkbox" name="notify" value="on">Please send me notification

<submit> 标签
<submit> 标签用于生成提交类型（ type submit ）的输入区域。
比如： <html:submit value="Login"/>
会被转换成： <input type="submit" value="Login">

<reset> 标签
<reset> 标签用于生成重置类型（ type reset ）的输入区域。比如：
<html:reset/>
会被转换成： <input type="reset" value="Reset">

<option> 标签
<option> 标签用于显示 select box 中的一个选项。参照下面的 <select> 标签。

<select> 标签
<select> 标签用于显示一个包含零个或更多选项的 HTML 选择元素。它必须被嵌入一个 <form> 标签中才有效。下面这个例子将说明如何使用该标签：
<html:select property="color" size="3">
<html:option value="r">red</html:option>
<html:option value="g">green</html:option>
<html:option value="b">blue</html:option>
</html:select>

会被转换成：
<select name="color" size="3"><option value="r">red</option>
<option value="g">green</option>
<option value="b">blue</option>
</select>

1 0