使用struts标签

鱼 发表于 2008-01-05 12:30:09

为了更容易、更快速地进行开发，Struts提供了功能同其它JSP标签库类似的五个标签库，即：HTML、Bean、Logic、Template和Nested。
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相关的标签。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：相应的信息在错误信息的单独列表后显示。
 
Struts HTML标签库会使开发更容易、更快速。为了有效地运用这个标签库，你需要对标签库中的标签很熟悉。
与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。
<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>
 
这个Login程序是一个简单的Struts程序，它将显示如何使用HTML标签库，尤其是和form相关的标签和用于错误处理的标签。其目录结构如图1中所示。
本文将介绍程序中每个类之间的关系以及它们所起的作用。注意，你必须自己将所有的库文件复制到WEB-INF/lib目录下；
视图
MVC范例中有三种作为视图的JSP页面：login.jsp、 mainMenu.jsp和viewSecret.jsp。login.jsp文件中包含一个用于用户登录的form，mainMenu.jsp中显示了两个链接（注销（log out）和查看公司机密），而viewSecret.jsp则用来显示一条机密消息。
这个程序的首页面是一个Login页面，它是一个包含两个输入框（userName和password）的form（见图2）。用户被要求在这两个输入框中输入正确的值。登录成功之后程序会显示mainMenu.jsp页面，它包含两个链接：一个是注销，另一个是查看公司机密账号（见图3）。
如果点击了“注销”链接，程序便会退出并重新显示Login页面。如果点击了“查看机密”链接，则会显示viewSecret.jsp 页面。如果注册失败，那么用户会被重新引导到Login页面以重新登录。
如果用户输入正确的用户名和密码，程序会建立一个session对象，并会有一个名为loggedIn的属性被添加到这个session对象中去。只有当程序能够在用户的session对象中查找到这个loggedIn属性时，用户才可以浏览Main Menu页面和Secret页面。所有缺少该属性或无效的session对象都会迫使用户登录。在这个程序中，正确的用户名是“john”，密码是“123”。这些值是程序中固定写死的以避免需要连接到数据库里或使用其他存储来完成用户验证。
当用户注销时，他或她的session对象将失效，同时Longin页面会重新显示。当用户点击链接要查看公司机密时，会弹出viewSecret.jsp页面（见图4）。
图3. 主页面
配置文件
Login程序有两个位于WEB-INF目录下的配置文件：作为部署描述符的web.xml文件（见列表1）；以及作为Struts配置文件的truts-config.xml文件（见列表2）。在列表1中，你需要特别注意action servlet配置中的<init-param>元素：
<init-param>
     <param-name>application</param-name>
     <param-value>com.javapro.struts.
            ApplicationResources
           </param-value>
   </init-param>
一个<init-param>元素代表一个初始化参数，它会被包含在传送到action servlet中的ServletConfig对象里。带有名为“application”的初始化参数对action servlet来说具有特殊的意义：它定义了一个会被加载到缺省消息资源（message resource）中的属性文件。（我将在“消息资源”部分介绍这个属性文件）。在这个程序中，该属性文件被用于存贮整个程序中的错误消息。
部署描述符中需要注意的第二个地方是的<taglib>元素，它包含<taglib-uri>和<taglib-location>元素。基本上，<taglib>元素是用来告诉servlet容器如何使用一个标签库的，该标签库的TLD文件可以在<taglib-location>元素指定的位置找到。
注意在列表2中，<form-beans>部分包含一个名为loginForm的form bean。
WEB-INF目录中的最后一个文件是struts-html.tld文件，它是HTML标签库中的TLD文件。为了节省时间我将跳过对它的介绍，但你可以在ZIP文件中的WEB-INF目录下找到它。
Form
该form以com.javapro.struts.LoginForm类的形式显示（见列表3）。注意粗体的部分：它通过传入“error.missing.userName”和“error.missing.password”字符串来举例说明ActionError对象，这些字符串在消息资源中起关键字（key）的作用。
Action类
Action类分两种：LoginAction （见列表4）和LogoutAction（见列表5）。另外值得一提的是如何通过消息资源中的一个关键字来构建这个ActionError消息（在列表4中显示为粗体）。
HTML标签库的使用
列表6、列表7和列表8中分别包含了JSP文件。login.jsp页面（见列表6）中显示了如何在HTML库中使用这些标签（粗体部分）。
消息资源
如我在“配置文件”部分简要介绍的那样，在WEB-INF/classes/com/javapro/struts目录下的ApplicationResources.properties 文件中包含配对的key/values，它们会被加载到缺省的消息资源中去。HTML标签库中的<errors>标签会在该消息资源中查找到自定义的错误消息。想知道它是如何出错的，你可以试着用一个错误的用户名或密码来登录，看看显示的错误消息是什么。更改错误消息和编辑属性文件一样容易。看看如下的属性文件：
errors.header=
   <b>Error(s)!!!</b><ul>
errors.footer=
   </ul><hr>
error.missing.userName=
   <li>A user name was not found.</li>
error.missing.password=
   <li>A password was not found.</li>
error.login.failed=
   <li>Incorrect user name and/or password.</li>
如果你检查了程序的web.xml文件，你会看到这些对象是如何被加载的。消息资源通过将程序的参数传入ActionServlet来完成加载过程。在ActionServlet进行初始化时，它会将package文件夹中的ApplicationResources.properties属性解析为缺省的消息资源。如果在资源中更改一个消息并重新加载程序，它就会在整个程序中显示。在你的Login程序中，这个属性文件包含一些程序的类中所使用的错误消息。
 
关键词(Tag): struts,java

相关日志:

阅读272次 评论 个人主页 扔小纸条 文件夹: struts相关
收藏: QQ书签 del.icio.us

最新评论

发表评论

*昵称

已经注册过? 请登录
Email
网址
*评论