Struts TagLib 标签库
环境:JBuilderX + Struts1.1 + tomcat5.x
为了更容易、更快速地进行开发,Struts提供了功能同其它JSP标签库类似的五个标签库,即:HTML、Bean、Logic、Template和Nested。下面我们来一一介绍这五个标签的作用和用法。
一. html 标签
HTML标签库主要用来显示HTML元素,如果不用这种方法,你就必须用HTML标签来指定它们。从表面上看,这个标签库很简单。但是通过深入研究,我们
就会发现它很强大。例如,它可以为我们在HTML表单的一个特定输入元素中放置重点内容生成JavaScript,或为客户端输入验证生成脚本。而且,你
可以用它通过一行代码来处理错误。然而,在将这个标签库用于你的Struts应用程序前,你需要做些简单的准备工作。
配置应用程序来运用标签库
在运用Struts HTML标签库前,你需要通过三个步骤来配置一个Struts应用程序。
1. 在部署描述符(web.xml文件)中注册标签库,告诉servlet容器有关Struts HTML标签库的情况,以及在哪里可以找到标签库的TLD文件,代码如下:
<taglib>
<taglib-uri>/WEB-INF/struts-html.tld</taglib-uri>
<taglib-location>/WEB-INF/struts-html.tld</taglib-location>
</taglib>
2. 要确定将struts-html.tld文件复制到WEB-INF目录中。你不用担心标签库类文件,因为它们已经包含在struts.jar文件中了。
3. 在运用标签库的每个JSP页面中,插入下面的<taglib>指示符:
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
HTML标签库包含几个很容易使用的独立的标签:
<html:html>标签
<html:html>标签是HTML标签库中最容易的标签。它有两个属性:locale和xhtml,两者都不是必 需的。
e.g. HelloWorld-html:
建立一个JSP页面welcome.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 locale="true">中的locale属性在生成的HTML页面中被转换成了<html lang="zh">。生成的结果
取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器,你不需要改变代码。Locale会自动
调整。
<html:base>标签
<html:base>标签显示一个HTML元素,用一个href属性表示所包含的JSP页面的绝对位置。只有当这个标签是内嵌在一个head标签部分时,它才有效。e.g. HelloWorld-base:
<%@ 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:base>标签会转换成:
<html lang="zh">
<head>
<title>Welcome</title>
<base href="http://localhost:8080/testSite/welcome.jsp">
</head>
<html:link>标签
<html:link>标签会生成一个超链接。
e.g. <html:link page="/index.jsp">Index</html:link>
会转换成:<a href="/testSite/index.jsp">Index</a>
<html:errors>标签
<html: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:相应的信息在错误信息的单独列表后显示。
二. logic 标签
一、定义标签文件(web.xml)
<taglib>
<taglib-uri>/tags/struts-logic</taglib-uri>
<taglib-location>/WEB-INF/struts-logic.tld</taglib-location>
</taglib>
二、引用标签文件(jsp文件)
<%@ taglib uri="/tags/struts-logic" prefix="logic" %>
三、标签文件说明(struts-logic.tld)
(1)empty标签
类名:org.apache.struts.taglib.logic.EmptyTag
标签体:bodycontent=JSP
引用logic:empty
属性 attribute:name,property,scope
功能:判断对象的值是否为空
(2)equal
类名:org.apache.struts.taglib.logic.EqualTag
标签体:bodycontent=JSP
引用logic:equal
属性 attribute:cookie,header,name,parameter,property,scope,value
功能:等于比较符
(3) forward
org.apache.struts.taglib.logic.ForwardTag
标签体:bodycontent=empty
引用logic:forward
属性 attribute:name
功能:页面导向,查找配置文件的全局forward
(4) greaterEqual
类名:org.apache.struts.taglib.logic.GreaterEqualTag
标签体:bodycontent=JSP
引用logic:greaterEqual
属性 attribute:cookie,header,name,parameter,property,scope,value
功能:大于等于比较符
(5)greaterThan
类名:org.apache.struts.taglib.logic.GreaterThanTag
标签体:bodycontent=JSP
引用logic:greaterThan
属性 attribute:cookie,header,name,parameter,property,scope,value
功能:大于比较符
(6) iterator
类名:org.apache.struts.taglib.logic.IterateTag
标签体:bodycontent=JSP
引用logic:iterator
属性 attribute:collection,id,indexId,length,name,offset,property,scope,type
功能:显示列表为collection的值(List ,ArrayList,HashMap等)
(7)lessEqual
类名org.apache.struts.taglib.logic.LessEqualTag
标签体:bodycontent=JSP
logic:lessEqual
属性 attribute:cookie,header,name,parameter,property,scope,value
功能:小于等于比较符
(8)lessThan
类名:org.apache.struts.taglib.logic.LessThanTag
标签体:bodycontent=JSP
logic:lessThan
属性 attribute:cookie,header,name,parameter,property,scope,value
功能:小于比较符
(9)match
类名:org.apache.struts.taglib.logic.MatchTag
标签体:bodycontent=JSP
引用logic:match
属性 attribute:cookie,header,location,name,parameter,property,scope,value
功能:比较对象
(10)messagesNotPresent
类名:org.apache.struts.taglib.logic.MessagesNotPresentTag
标签:bodycontent=JSP
引用logic:messagesNotPresent
属性 attribute:name,property,message
功能:ActionMessages/ActionErrors对象是否不存在
(11)messagePresent
类名:org.apache.struts.taglib.logic.MessagesPresentTag
标签:bodycontent=JSP
引用logic:messagePresent
属性 attribute:name,property,message
功能:ActionMessages/ActionErrors对象是否不存在
(12)notEmpty
类名:org.apache.struts.taglib.logic.NotEmptyTag
标签:bodycontent=JSP
引用logic:notEmpty
属性 attribute:name,property,scope
功能:比较对象是否不为空
(13)notEqual
类名:org.apache.struts.taglib.logic.NotEqualTag
标签:bodycontent=JSP
引用logic:notEqual
属性 attribute:cookie,header,name,parameter,property,scope,value
(14)notMatch
类名:org.apache.struts.taglib.logic.NotMatchTag
标签:bodycontent=JSP
引用logic:notMatch
属性 attribute:cookie,header,location,name,parameter,property,scope,value
功能:比较对象是否不相等
(15)notPresent
类名:org.apache.struts.taglib.logic.NotPresentTag
标签:bodycontent=JSP
引用logic:notPresent
属性 attribute:cookie,header,name,parameter,property,role,scope,user
功能:request对象传递参数是否不存在
(16)present
类名:org.apache.struts.taglib.logic.PresentTag
标签:bodycontent=JSP
引用logic:present
属性 attribute:cookie,header,name,parameter,property,role,scope,user
功能:request对象传递参数是否存在
(17)redirect
类名:org.apache.struts.taglib.logic.RedirectTag
标签:bodycontent=JSP
引用logic:redirect
属性 attribute:anchor,forward,href,name,page,paramId,paramName,paramProperty,paramScope,property,scope,transaction
功能;页面转向,可传递参数
未完待续。。。。。。
posted on 2005-04-23 13:05
winfar 阅读(2397)
评论(0) 编辑 收藏