Struts HTML标签库

liugao_0614

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

HTML标签库主要用来显示HTML元素，如果不用这种方法，你就必须用HTML标签来指定它们。从表面上看，这个标签库很简单。但是通过深入研究，我们就会发现它很强大。例如，它可以为我们在HTML表单的一个特定输入元素中放置重点内容生成JavaScript，或为客户端输入验证生成脚本。而且，你可以用它通过一行代码来处理错误。然而，在将这个标签库用于你的Struts应用程序前，你需要做些简单的准备工作。
配置应用程序来运用标签库
在运用Struts HTML标签库前，你需要通过三个步骤来配置一个Struts应用程序。
1. 在部署描述符（web.xml文件）中注册标签库：
  
    /WEB-INF/struts-html.tld
    /WEB-INF/struts-html.tld
  
上面的代码就告诉了servlet container有关Struts HTML标签库的情况，以及在哪里可以找到标签库的TLD文件。
2. 确信将struts-html.tld文件复制到WEB-INF目录中。你不用担心标签库类文件，因为它们已经包含在struts.jar文件中了。
3. 在运用标签库的每个JSP页面中，插入下面的指示符：
另外，你也可以运用struts-html.tld文件来学习它所支持的标签以及每个标签可以带有哪些属性。
运用一个自定义的标签库通常是很容易的：只要遵循前面讲述的步骤就行了。然而，有些标签库包含一些原则，这些原则使我们在运用这些标签库时并不那么容易。Struts HTML标签库就是其中之一。有些标签很简单、很容易使用；然而，另外有些标签则取决于Struts应用程序中的其它标签或其它元素。
我将HTML标签库中的标签大致分成了两类：简单、容易使用的标签，我把它们称为“独立的标签”，第二类是必须通过一个form标签来使用的标签。我把第二类的标签简单地称为与form相关的标签。本文主要讲述独立的标签，在本系列文章的
第二部分
我将讲述与form相关的标签。
HTML标签库包含几个很容易使用的独立的标签。下面讲述几个比较重要的标签。
标签
标签是HTML标签库中最容易的标签。它有两个属性：locale和xhtml，两者都不是必需的。下面的代码选自一个运用标签的JSP页面：
Welcome
Hello World!
注意，我们没有用标准的元素，而是用了标签。其中第一个html指的是前缀，第二个是标签本身。而且我们也用了locale属性。JSP页面将显示成：
Welcome
Hello World!
注意，中的locale属性在生成的HTML页面中被转换成了lang=“en”。生成的结果取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器，你不需要改变代码。Locale会自动调整。
标签
标签显示一个HTML元素，用一个href属性表示所包含的JSP页面的绝对位置。只有当这个标签是内嵌在一个head标签部分时，它才有效。例如这个JSP页面：
Welcome
Hello World!
会转换成以下形式：
Welcome
Hello World!
标签
标签用来生成一个HTML 标签。它最重要的属性有：
· page：图象文件相对于模块的路径；前面必须带有一个斜线。
· height：图象的高度。
· width：图象的宽度。
· alt：如果找不到图象，显示的文本。
例如：
会转换成：
标签
标签会生成一个超链接。例如标签：
Click
here
会转换成：
Click
here
标签
标签的易于使用性通常会掩盖其真正的强大功能。通过一个简单的标签，你就可以在一个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相关的标签；
与form相关的标签包括
标签本身以及所有必须包含在其中的标签。比如，和标签就是和form相关的标签，因为如果不把它们放到一个form中它们就没有意义。
标签
标签用于生成一个HTML form。使用该标签时必须遵循许多规则。
首先，标签中必须包含一个action属性，它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个name属性，它的值是form bean的名称。
例如，如果你有这样一个标签：
  
那么你的Struts配置文件的元素中必须有一个如下显示为粗体的元素：
     
     
      
   
    .
    .
    .
  
  
这就是说一个form标签是和form bean相关联的。
另一个要遵循的规则是：任何包含在中用来接收用户输入的标签（、、、、、、）必须在相关的form bean中有一个指定的属性值。比如，如果你有一个属性值被指定为“username”的标签，那么相关的form bean中也必须有一个名为“username”的属性。输入标签中的值会被用于生成form bean的userName属性。
除了上面所讲的属性之外，标签还有一些不是必须但加上更好的“次要”的属性。比如，你可以用focus属性来生成JavaScript，它会“定焦”（focus）到该form所包含的一个元素上。使用focus属性时你需要给它指定元素的名称。比如，以下代码是定焦在第二个Text元素上的：
User Name:
Password:
该段代码会被转换成：
User Name:
Password:
  
注意，标签中method属性的缺省值是POST。另外，有没有看到这个标签库是如何建立JavaScript来定焦到password元素上的? 这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程，它会帮你自动生成。
在运行前面的例子时还要注意，你必须有一个包含userName和password属性的相关form。
标签
标签用于生成一个文本的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个标签中时才有效。
例如：

会被转换成：

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

会被转换成:

标签
标签用于生成一个文本区元素（text area element）。它必须包含和相关form bean中的相同属性对应的“property”属性。
比如：
会被转换成：
Enter details here
标签
标签用于显示一个单选按钮（radio button）。它必须包含“value”属性。比如这段代码：
Mr.
Ms.
Dr.
会被转换成这样的HTML：
Mr.
Ms.
Dr.
标签
标签用于显示checkbox类型的输入区域。比如：
Please send me notification
会被转换成：
Please send me notification
标签
标签用于生成提交类型（type submit）的输入区域。比如：

会被转换成：

标签
标签用于生成重置类型（type reset）的输入区域。比如：

会被转换成：

标签
标签用于显示select box中的一个选项。参照下面的标签。
标签
标签用于显示一个包含零个或更多选项的HTML选择元素。它必须被嵌入一个标签中才有效。下面这个例子将说明如何使用该标签：
  red
  green
  blue
会被转换成：
red
  green
  blue


本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u/25176/showart_385081.html