用标签库提高开发速度

发表于:2007-07-04来源:作者:点击数: 标签:
Struts提供了一个强大的HTML标签库来帮助你构建Web应用程序。 为了更容易、更快速地进行 开发 ,Struts提供了功能同其它JSP标签库类似的五个标签库,即:HTML、Bean、Logic、Template和Nested。本系列文章通过三个部分来讲述HTML标签库。第一部分讲述如何配
Struts提供了一个强大的HTML标签库来帮助你构建Web应用程序。
 
    为了更容易、更快速地进行开发,Struts提供了功能同其它JSP标签库类似的五个标签库,即:HTML、Bean、Logic、Template和Nested。本系列文章通过三个部分来讲述HTML标签库。第一部分讲述如何配置一个Struts应用程序来运用这个标签库,并介绍了第一组标签;第二部分讲述了第二组标签;第三部分以一个应用程序为例,讲述如何运用这个标签库。学习本系列文章的前提是,你已经对Struts有了基本的了解了。如果你不太了解,请阅读我撰写的关于Struts的系列文章(共六个部分)。

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

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

1. 在部署描述符(web.xml文件)中注册标签库:
  <taglib>
    <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>
<base href="http://www.domain.com/myStrutsApp/testing.jsp">
</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:相应的信息在错误信息的单独列表后显示。 


在本系列文章的第三部分,我将进一步讲述<errors>标签。

    Struts HTML标签库会使开发更容易、更快速。为了有效地运用这个标签库,你需要对标签库中的标签很熟悉。在本系列文章的第一部分中,你学习了如何配置一个Struts应用程序来运用标签库,并对独立的标签有了总体的了解。在第二部分中,你将学习与form相关的标签;在第三部分,我们将提供一个运用这个标签库的应用程序。


 在本文系列的第一部分中我讲述了如何使用Struts提供的HTML标签库来配置一个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">
  <!--
 if (document.forms["loginForm"].elements["password"].type != "hidden") 
    document.forms["loginForm"].elements["password"].focus()
  // -->
</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>

    在本文系列的第二部分,你学到了一些更重要的和form相关的标签。在使用这些标签之前,你必须依照一些规则以便正确地运用它们。第三部分将讲述如何在真正的程序中使用这些标签。

原文转自:http://www.ltesting.net