社区应用 最新帖子 精华区 社区服务 会员列表 统计排行 社区论坛任务 迷你宠物
  • 4710阅读
  • 1回复

一篇介绍JSP标签库很详细的文章,可以做为参考手册

级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记! DoA f,9|_  
6|x<) Gc  
一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。 Q}]u n]]Zt  
$@X,J2&  
在这篇文章中,我们主要讨论: +`xp+Q  
[a2/`ywdV  
· 什么是自定义tag标签? }z6HxB]$  
>"b"K{t  
· 怎么使用tag标签? [;}c@  
7}MWmS^8j  
o 声明要使用的tag库 /on p<u  
~Km8 -b(&  
o 找到与之对应的tag处理类 6Z 7$ZQ~  
gKnAw+u\  
o tag标签的类型 1RLSeT  
v%r!}s  
· 自定义tag标签 SJfsFi?n  
#frhO;6  
o tag处理类 6+>rf{5P7  
QLn5:&  
o tag库描述 Nz8iU@!a  
1*5n}cU~  
o tag标签示例 a fjC~}  
p<YO3@B+  
o 带属性的tag W cnYD)  
-kkXyO8js  
o 带body的tag !eW<4jYB  
(NP=5lLH  
o 定义了脚本变量的tag jWQB~XQY  
0x84 Ah)  
o 具有协作关系的tag z&eJ?wb  
6*%lnd+_  
· 自定义tag标签 ;YB8X&H$  
7}xKiHh:  
o 一个迭代tag的例子 E3'6lv'  
.Xr_BJ _  
o 一个模板tag库 jRGG5w}  
' Mg%G(3  
o tag处理类到底是怎样被调用的? TYp{nWwi  
f!87JE=<  
8<P.>u  
什么是自定义的tag? #ws6z`mt  
(7"qT^s3  
一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。 o)NWsUXf  
>k:)'*  
自定义tag标签有很多特色,诸如: 4;_.|!LN  
MtS$ovg?  
· 可以在JSP页面中自定义tag标签的属性 4>(?R[:p)  
>$}nKPC,Y  
· 访问JSP页面中的所有对象 B]jh$@  
WvR}c  
· 可以动态地修改页面输出 b*,R9  
'oo]oeJ-  
· 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。 luV%_[F  
aPWFb.JO4  
· tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。 GSl\n"S]=  
,TL~];J'  
S6cSeRmw  
使用tag标签 B3K%V|;z )  
,2u]rLxx;  
{`-EX  
本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。 L&l> ?"_  
m|p}Jf!  
要使用tag标签,JSP程序员必须做2件事: +1e*>jE  
rBpr1XKl,  
· 声明此tag标签的tag库 Z$2mVRS`c  
dNIY `u  
· 实现此tag标签 b%AYYk)d?  
y#r=^r]l)  
声明tag标签所在的tag库 NAL%qQ  
ZWYwVAo  
如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明) 75<E0O  
s*rtm  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> NJn~XCq  
T_pE'U%[  
uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。 0\u_ \%[  
S# SA:>8s  
TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。 #[J..i/h  
2f F)I&  
以下taglib指示符直接引用一个TLD: 'tF<7\!  
}**^ g:  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> T- JJc#  
Z3 &8(vw  
以下的taglib指示符通过一个逻辑名称间接地引用一个TLD: g~N)~]0{  
V5R``T p  
<%@ taglib uri=”/tutorial-template” prefix=”tt” %> uI.4zbgl[  
#~nI^ ggW  
如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素: -j<m0XUQ  
s|d L.@0,L  
<taglib> yv,90+k  
T7&itgEYG/  
<taglib-uri>/tutorial-template</taglib-uri> J>x)J}:;  
I C7n;n9  
<taglib-location> DtyT8kr  
*F2obpU  
/WEB-INF/tutorial-template.tld |(Io(e  
S =eP/  
</taglib-location> 1 BVivEG  
RQv`D&u_  
</taglib> !j [U  
(iH5F9WO  
wN"irXG  
实现此tag标签 *COr^7Kf5  
zI(b#eUF  
,NKDEcw]  
为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。 Eo)n( Z9  
SC"=M^E  
*T*MLD]Q  
tag标签类型 ?\.P  
r's4-\  
;w[|IRa  
自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点): GiI2nHZc  
ytr~} M%  
<tt:tag> 7_n@iUG2n  
:E]A51  
body `[/BG)4  
7J7uHl`yq`  
</tt:tag> o=4d2V%m  
(N0G[(>  
!Vv$  
一个不带body的tag标签如下: cqi: Rj  
.Mdxbs6.C  
<tt:tag /> -i7W|X"  
9kQ~)4#  
zr2%|YF  
简单的tag标签 ``K.4sG  
K%$%9y  
一个没有body和属性的tag标签如下: f \[Z`D  
a/{T;=_GY  
<tt:simple /> 'l!tQD!  
7[ *,t  
9^3y\@ m  
带属性的tag标签 DpoRR`  
}"2 0:  
pkM_ @K  
自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。 }`\+_@ w  
/@Y/(+DE  
你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值: [#$z.BoEo  
Ik(TII_  
<loglic:present parameter = “Clear”> y`!3Z} 7  
iK s/8n  
而另一个标签logic:iterate是用表达式来给属性赋值: )1Z*kY?f!  
P<km?\Xp(  
<logci:iterate collection=”<%= bookDB.getBooks() %>” -{-w5_B$  
d {T3  
id=”book” type=”database.BookDetails”> $ GL$ iA  
eICk}gfun  
Wu,'S;>C  
带body的tag标签 Wx;:_F7'\  
#,0%g 1  
一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。 6&`.C/"2  
x{6/di  
在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息: dl6d!Nz*  
O)kC[e4  
<logic:present parameter=”Clear”> N;9@-Tb  
2$jTj<.K  
<% cart.clear(); %> 1aS[e%9Mg  
[2a*TI  
<font color=”#ff0000” size=”+2”><strong> hp@g iu7  
KE]!7+8-  
你选择了清除购物车! Bq#?g@V  
A<C`JN}  
</strong></font> Rq%g5lK  
/o*r[g7<  
</logic:present> 1NtN-o)N?  
>sv|  
XI~2Vzht  
到底是用属性还是用body来传递信息? FYFP 6ti  
Hc ]/0:  
如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。 F0t!k>  
U+3,(O  
==F[5]?  
定义脚本变量的tag标签 Yc/Nz(m  
7?:7}xb-  
所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等: ]rO`e N[~U  
yQ?N*'}$  
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” /> TL ;2,@H`  
{'4h.PB+r  
<% tx.begin(); %> qPK3"fzH  
#/Y t4n  
... 'j6PL;~c  
2-Y%W(bEzs  
"45O!AjP  
具有协作关系的tag标签 ,F`:4=H%  
Q* ifmnB'  
自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。 |kyxa2F{  
e; 5 n.+m  
<tt:tag1 attr1=”obj1” value1=”value” /> <i``#" /  
"K5n|{#  
<tt:tag2 attr1=”obj1” /> ^} P|L  
X[\b!<C  
在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。 g^OU+7o  
uh*b[`e  
<tt:outerTag> n*(Vf'k  
p&ytUT na  
<tt:innerTag /> =PWh,lWS  
q$`{$RX  
</tt:outerTag> pRe, B'&  
h~)oiT2v  
-H5n>j0!{  
Tag处理类 kFZw"5hb  
s7e)Mt  
9 =7),`$  
Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。 _IBI x\F  
%p6"Sg*  
当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。 S'#KPzy.  
<yz)iCU?  
下表说明不同类型的tag所需要不同的处理过程: t-*oVX3D  
`VX]vumG  
Tag处理类的方法 0 Po",\^  
s1. YH?A;  
Tag标签类型 t"k6wv;Tq  
所调用的方法 Z? u\  
/{Ksi+q  
基本标签 L)H' g  
doStartTag, doEndTag, release YzJ\< tkp  
,=whwl "tA  
带属性的标签 @ de_|*c  
doStartTag, doEndTag, set/getAttribute1...N, release }UNRe]ft$  
ieXhOA  
带内容的标签 {)nm {IV,  
doStartTag, doEndTag, release fr kDf-P  
~`)`Ip  
带内容的标签,且内容重复循环 &.D3f"  
doStartTag, doAfterBody, doEndTag, release u&Ts'j  
!N:!x[5  
带内容的标签,且内容与JSP交互 T^.;yU_B?  
doStartTag, doEndTag, release, doInitBody, doAfterBody, release 4UD<g+|  
vHSX3\(  
一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。 Nr)v!z~y   
ZlD\)6 dZ  
如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。 KLD)h,]  
Kcv7C{-/  
一般情况都将所有的tag处理类打成了JAR的包,以便于发布。 ov&4&v  
aC:Sy^Tf  
`(s&H8x#  
Tag库描述(简称TLD) Y^DS~CrM  
LdxrS5  
ZYDLl8  
Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。 ,>%2`Z)  
.w=( G  
TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。 :ad  
&5>R>rnB  
一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如: m?cC0(6  
Au Ib>@a  
<?xml version="1.0" encoding="ISO-8859-1" ?> tSX<^VER7  
d l_ h0  
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> xL8r'gV@  
TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表: 2@K D '^(  
8|k r|l  
/RD@ [ 8  
<taglib>的子元素 g-`HKoKe  
LVNq@,s  
Element S9/oBxGN  
Description 'p<lfT  
sq `f?tA?  
tlib-version r}kQ<SRx  
Tag库的版本 NAd|n+[d  
sb"z=4  
jsp-version Q;r9>E!  
Tag库所需要的jsp的版本 7<{g+Q~7*  
~ [L4,q  
short-name ?d@3y<A,~  
助记符,tag的一个别名(可选) *Ju$A  
B-Bgk  
uri E"d\N-I  
用于确定一个唯一的tag库 XaT9`L<  
n0|oV(0FE  
display-name B*=m%NXf  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) !RX\">z  
/{Ff)<Q.Z  
small-icon ^s*j<fH  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) /ZC/yGdIS_  
qKoD*cl)Za  
large-icon 'a]4]d  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) CjtBQ5  
-+vA9,pI  
description CeL`T:]r  
对tag库的描述(可选) 5=< y%VF  
u,h,;'J  
listener "},0Cs  
参见下面listener元素 XLwmXi  
2R}9wDP  
tag jUny&Alj  
参见下面tag 元素 /u hA\m(  
J\7ukm"9  
Listener元素 BS-nny  
fL3Px  
一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。 |Z\?nZ~  
+Fn^@/?yC  
Tag元素 2hZ>bg  
rHS;wT  
每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。 |>w>}w`~  
:exgdm;N  
每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素: eK<X7m^  
a4'KiA2r  
Tag元素的子元素 SZ/}2_;  
ZkbaUIQ  
元素名称 >j5,Z]  
描述 NO(^P+s  
c!,&]*h"k  
name PKDzIA~T  
独一无二的元素名 Cxn<#Kf\-<  
@|e4.(9A  
tag-class cJ CKxj  
Tag标签对应的tag处理类 o+9b%I^1V  
!v^{n+  
tei-class <Mdyz!  
javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选) jO` b&]0  
Dt1v`T~=?  
body-content  z]/;?  
Tag标签body的类型 <K^{36h  
9\yGv  
display-name  18(hrj  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) MCPVql`+`q  
U;o$=,_p  
small-icon &sFEe<  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) Se0!-NUK0  
%kS4v,I  
large-icon =H<I` J'  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) bOEO2v'cQ  
A* 1-2  
description 74[wZDW|(  
此tag标签的描述 W0zRV9"P  
^M:Y$9r_s  
variable J^!2F}:  
提供脚本变量的信息(同tei-class)(可选) >9WJa5{  
%anY'GK   
attribute n! Dr:$  
Tag标签的属性名 d4#CZv[g/  
cO8':P5Q  
以下章节介绍对于不同类型的tag,如何具体地实现它们。 )bd)noZi  
#9( 0.!v  
~CtLSyB  
简单的tag O c[F  
Z[ NO`!<  
Qu  x1N  
tag处理类 '-,$@l#  
Mr0<b?I  
简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。 H%nA"-  
L:.z FW,  
以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下: 1Fg*--8[r  
y[D8rFw  
J1s~w`,  
public SimpleTag extends TagSupport vvTQ!Aa  
.jXD0~N8q  
{ bwC~  
~E8L,h~  
public int doStartTag() throws JspException H|.cD)&eYy  
V 6*ohC:  
{ 18HmS>Qo  
< dD)>Y.  
try{ 9hTzi+'S  
^t$xR_  
pageContext.getOut().print(“Hello.”); :Rroz]*  
JK/gq}c  
}catch(Exception e){ 4:I'zR5  
N^TE ;BM  
throw new JspTagException(“SimpleTag: “ + e.getMessage()); ^H(,^cVN  
7'g{:dzS*3  
} +_T`tmQ  
<2V:tj)?P  
return SKIP_BODY; ~Z>!SMXp<  
rqi/nW  
} lVYrP|#  
(M-W ea!q  
public int doEndTag() ~PtIq.BY  
c-y`Hm2"  
{ fEB&)mM  
YAsE,M+  
return EVAL_PAGE; 6ec#3~ Y]  
K(3_1*e  
} :Ldx^UO  
M(Tlkr  
} XCd[<\l  
\0fk^  
J=t@2  
注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如 0a}a  
63fg l+  
<body-content>empty</body-content> 9SQc ChG~j  
l3:2f-H   
:[J'B4>9  
带属性的tag标签
评价一下你浏览此帖子的感受

精彩

感动

搞笑

开心

愤怒

无聊

灌水
级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
只看该作者 1 发表于: 2007-01-01
tag处理类 (>SucUU  
(9Of,2]&E  
对于tag标签的每个属性,你必须依照JavaBeans规范来定义其属性,以及get和set方法。以struts的logic:present 标签为例, oV'G67W  
@y2cC6+'t  
<logic:present parameter=”Clear”> dK41NLGQ  
oTg 'N  
与此相应,此tag处理类应有如下方法和定义: x c|1?AFj  
<~zPt&C]V  
.Vrl:  
protected String parameter = null; wpg7xx!  
30W.ks5(  
public String getParameter() 9y*2AaxW  
"j8`)XXa(  
{ @rS(3wu_&  
?4#UW7I  
return this.parameter; w!jY(WK U  
9t!Agxm  
} "fC>]iA8I  
?&=JGk^eJ  
public void setParameter(String parameter) 05Q4$P  
<;*w97n  
{ *|ef#-|D  
XEBj=5sG  
this.parameter = parameter; hi/Z>1ZOX  
(9{qT>eJg=  
}  =>XjChM  
-<:w{cV  
LqLhZBU9  
注意:如果你的属性名为id,而且你的tag处理类是从TagSupport类继承的,那你就不需要定义它的属性和set和get方法,因为他们早已在TagSupport被定义过了。 n~ZZX={a  
*M.,Yoj  
Attribute元素 49ehj1Se  
Zb&"W]HSf  
对于tag标签的每个属性,你必须定义它是否必须的,它的值是否可以用诸如<%= …%>的表达式来获得,以及它的类型(可选),如果不指定它的类型,那就默认为是java.lang.String类型。如果rtexprvalue元素被定义为true或yes,那么在type元素中就定义了attribute的返回类型。 ZiPz~G0[^  
|I;]fH,+  
<attribute> ~])Q[/=p  
juI)Do2_  
<name>attr1</name> OC)=KV@KE  
xXfv({  
<required>true|false|yes|no</required> {Ve3EYYm  
UOyM=#ipY  
<rtexprvalue>true|false|yes|no</rtexprvalue> gvr&7=p  
xo4lM  
<type>attribute的返回类型(只用当rtexprvalue为真是才有效)</type> xd\ml 37~  
2f1Q&S  
</attribute> <fE ^S  
jO9! :L>b`  
如果tag的某个属性不是必须的,那tag处理类会自动提供一个缺省值。 bVzJOBe  
HL-'\wtl  
例如,在logic:present这个tag标签中定义了一个属性叫parameter,但它不是必须的,而且它可以被诸如<%= …%>的表达式来赋值。 ?_r{G7|D  
jrpki<D  
<tag> `KZu/r-M9  
?vFtv}@\  
<name>present</name> $)~:H-  
 OO</d:  
<tag-class>org.apache.struts.taglib.logic.PresentTag</tag-class> hAs ReZ?  
x3sX=jIW_  
<body-content>JSP</body-content> ;GKL[ tI"  
my/KsB  
… $@l=FV_;  
?XeaoD/  
<attribute> 6"NtVfui  
N3zZ>#{  
<name>parameter</name> 4|\  
L2_[M'  
<required>false</required> e1y#p3 @d  
ysPm4am$  
<rtexprvalue>true</rtexprvalue> ^Ku]8/ga  
4>HaKJ-c#  
</attribute> =M}tet }  
`,]_r 4~ ~  
… @eutp`xoT\  
w~&#:F?  
</tag> ;Qi!~VsP;  
^Epup$  
Ya> AI.!K  
属性元素的校验 2h#.:!/SMw  
q[+ h ~)  
o^Ysp&#p  
有关于tag标签的有效值可以从tag库的说明文档中获得,当JSP页面被编译时,jsp引擎会强制性地参照TLD中定义的规则进行检查。 QO{=Wi-  
4;RCPC  
还有一个方法也可以进行属性元素的校验,就是先继承类TagExtraInfo,然后调用它的isValid方法。这个类同时也起到提供tag中定义的脚本变量信息的作用。 {|Ki^8h/p  
QaWHz   
IsValid方法通过TagData对象来传递属性信息,它包括着tag的所有的属性名-值的信息。由于校验发生在运行时刻,因此这个属性的值将被赋值为TagData.REQUEST_TIME_VALUE。 -I-Uh{)j  
+RV-VrV  
例如tag标签<tt:twa attr1=”value1” />在TLD中定义如下: 1/ pA/UVO  
t*d >eK`:N  
<attribute> HDVl5X`j'  
M+;P?|a  
<name>attr1</name> l(#ke  
IT`=\K/[4  
<required>true</required> oD#>8Aws  
0sDwTb"  
<rtexprvalue>true</rtexprvalue> {M r~%y4  
H [Lt%:r  
</attribute> iv:/g|MBI&  
Tz[?gF.Do  
pp]_/46nN  
这个定义说明了attr1能在运行期间被赋值。 ,.jHV  
4r[pMJiq  
以下的isValid方法检查attr1属性的值是否属于Boolean类型。注意由于attr1能在运行刻被赋值,那么isValid方法必须检查tag用户是否对此tag进行了运行时刻赋值。 7~"(+f  
6f?BltFaN  
Q"|kW[Sg  
Public class TwaTEI extends TagExtraInfo /Pn.)Lxfl  
0UGiPH,()  
{ ?#m<\]S<  
!ml_S)  
public boolean isValid(Tagdata data) X#DL/#z k  
N xb\[  
{ dGsS<@G  
- LiPHHX<  
Object o = data.getAttribute(“attr1”); 4e@&QOo`Cu  
wI! +L&Q  
If(o != null && o != TagData.REQUEST_TIME_VALUE) Wk`bb!P_  
IAP/G5'Q  
{ cXS;z.M\_  
`u#;MUg  
if( ( (String)o).toLowerCase().equals(“true”) || =!(*5\IM  
sK@Y!oF}\  
((String)o).toLowerCase().equals(“false”) ) #9D/jYK1X  
ZU-4})7uSB  
return true; - J"qrpZ^  
w dGpt_  
else SqXy;S@  
%1\v7Xw{9  
return false; jq57C}X}2  
 ofMu3$Q  
} GS ;HtUQ  
]8$#qDS@  
else ,< @,gZru  
4llD6&%  
return true; ]?0{(\  
I %|@3=Yc  
} `FA) om  
:7p9t.R<$h  
} #K=b%;>  
o 'C~~Vg).  
"jL1. 9%"  
带body的tag dqqnCXYuW  
rO/a,vV  
2E$^_YT C  
tag处理类 i@P 9EU  
}m6f^fs}  
 T/[f5?p  
如果tag标签含有内容,那处理方式会略微有些不同,而且还要视tag处理类是否要与body交互的情况而定。如果要与body交互,那我们认为tag处理类要可能要对body进行操作。 SQ}S4r  
`6&`wKz  
Tag处理类不与body交互 ]\A1mw-T  
OmB TA=E<  
如果tag处理类不与body交互,tag处理类应该实现Tag接口或从TagSupport中派生,如果body要被计算,那么doStartTag方法应返回 EVAL_BODY_INCLUDE,否则应返回SKIP_BODY。 -=>sTMWpr  
N 0+hejz  
如果tag处理类要对body反复运算,则它应该实现IterationTag或从TagSupport中派生。如果tag处理类认为body还未计算完的话,那它的doStartTag方法和doAfterBody方法必须返回EVAL_BODY_AGAIN。 Bk,2WtVX  
]>5T}h  
Tag处理类与body交互 oP/>ju  
'%R<"  
如果tag处理类与body交互,那tag处理类应实现BodyTag接口或从BodyTagSupport中派生。这种tag处理类一般要实现doInitBody和doAfterBody方法。 O?CdAnhQc`  
n_v02vFAHT  
Body允许一些方法来读写它的内容。Tag处理类可以调用body内容的getString或getReader方法来从body中提取信息,也可用 writeOut(out) 方法来将body的内容写入到out对象中。其中out对象通过tag处理类的getPreviousOut方法来获得。 Hi^35  
Di:{er(p  
如果body的内容需要被计算,那么doStartTag方法必须返回EVAL_BODY_BUFFERED,否则,它将返回 SKIP_BODY。 <mL%P`Jj  
`M&P[ .9Pz  
doInitBody 方法 z&O#v9.NE|  
4S tjj!ew  
此方法在body内容已经设好,但未被计算之前被调用。你可以根据不同的body内容来制定初始化策略。 wfE^Sb3  
TN5>"? ?"  
doAfterBody方法 alFNSRY  
lr,q{;  
此方法在body内容已被计算后进行调用。 6,X+1EXY  
*ot> WVB  
和doStartTag方法一样,doAfterBody方法返回一个指示符指示是否要继续计算body,如果要继续计算,则doAfterBody应返回EVAL_BODY_BUFFERED,否则,它应返回SKIP_BODY。 bl=ku<}@  
c&E]E(  
release 方法 E, GN|l  
tAERbiH  
tag处理类调用此方法将它的状态重置为初始状态,并释放所有的私有资源。 ~(P&g7u  
k0JW[04j  
;+a2\j+  
以下的例子读取body的内容(其中含有一条sql语句),然后将它传递给一个对象,让它进行查询。由于此处body不须重新计算,所以doAfterBody会返回SKIP_BODY。 ! D$Ooamq  
[ 7g><  
jXixVNw  
Public class QueryTag extends BodyTagSupport 28a$NP\KW  
}Al YNEY  
{ =>qTNh*'  
M diw Ri  
public int doAfterBody() throws JspTagException M*w'1fT  
z8E1m"  
{ 0 Qnd6mb  
vy [C'a  
BodyContent bc = getBodyContent(); ##cnFQCB  
lNz]H iD  
//将body的内容以字符串的格式提取出来 LBat:7aH>  
$5NKFJc  
String query = bc.getString(); .fp&MgiQ  
&l m#  
//清除body |0g{"}%  
MG{l~|\x)  
bc.clearBody(); BRzfic :e  
wP<07t[-g  
try{  cG{L jt  
O6X"RsI}  
Statement stmt = connection.createStatement(); G69GoT  
;SY\U7B\  
Result result = stmt.executeQuery(query); T.ML$"f  
g<wRN#B  
}catch(SQLException e){ @kxel`,$e  
$!B}$I;cd  
throw new JspTagException(“queryTag: “ + e.getMessage() ); ;wHCj$q  
2YlH}fnH  
return SKIP_BODY; SwW['c'*]B  
.4-,_`T?  
} \)/yC74r7(  
5T?-zFMM  
} ^5; `-Ky  
(V?:]  
(Un_!)  
body-content元素 hgj <>H|  
~ G6"3"  
= 1.9/hW  
由于tag可能会有body,你必须用body-content元素来指定body内容的类型: u0Nm.--;_3  
!mMpb/&&S  
<body-content>JSP|tagdependent</body-content> y[?-@7i  
T~4N+fK  
E3aDDFDH  
如果body的内容是定制的或内部的tag、脚本元素、或HTML广本,则归类为JSP类型。其他的类型,比如上面代码所述的?D?D将sql statement类传给 query tag的这种类型应该标为tagdependent。 SF*n1V3hx  
eq4C+&O&  
注意:实际上body-content的值并不影响tag处理类对body内容的处理,它仅仅是被tag编辑工具用来描述此body的内容。 &--ej|n  
p-SJ6Gg 9  
kgi>} %  
用tags定义脚本变量 ;j8 )KC  
o*rQP!8,oy  
NnT g3:.  
tag处理类 'T<iHV&  
$%R$ G`.KM  
}g7]?Ee  
tag处理类负责创建或设置页面中定义的脚本变量,用pageContext.setAttribute(name,value,scope)或pageContext.setAttribute(name,value)方法来实现。一般来说,tag处理类通过脚本变量的名称来获取它,脚本变量的名称一般可用get方法来获得。 /3B $(  
:GpDg  
如果脚本变量的值依赖于tag处理类中的上下文中某一对象,那它可用pageContext.getAttribute(name,scope)方法来找到那个对象。一般的处理过程是tag处理类先找到脚本变量,再对其进行处理,然后用pageContext.setAttribute(name,object)的方法来设置它的新值。 f"1>bW>R+  
0 &_UH}10  
对象的生存周期(scope)如下表: MY#   
03E4cYxt5  
对象的生存周期表 6(d}W2GP  
3psU?8(  
名字 a2Pf/D]n  
可访问范围 2owEw*5jl/  
生存周期 :+Om]#`Vls  
n_ lo`  
page ^sN (  
当前页面 K*UgX(xu4P  
一直有效,除非页面向客户提交响应或重定向到一个新页面 . 8N.l^0,  
b306&ZVEk  
request $un?0S  
当前页面或当前页面重定向到的页面 AdRX`[ik  
一直有效,除非页面向客户提交响应 _4^R9Bt  
>SPh2[f  
session >h0-;  
当前页面或在同一浏览器窗口中的页面 m3Il3ZY.  
一直有效,除非关闭当前浏览器、超时、网络故障 {ZY+L;eg1  
U- )i+}Ng  
application 8JmFi  
整个web应用程序的所有请求 S26MDLk`R3  
一直有效,除非发生网络故障、服务器故障 !uQPc   
,U(1NK8o  
提供关于脚本变量的信息 qOIW(D  
k'0Pi6  
以下示例定义了一个名为“book”的脚本变量,用来访问程序中关于书的信息: @v}/zS  
E@7J:|.)R  
<bean:define id=”book” name=”bookDB” property=”bookDetails” type=”database.BookDetails” /> o=0]el^A  
5mb]Q)f9-  
<font color=”red” size=”+2” > tHzZ@72B7  
,}K<*t[I  
<%= messages.getString(“CartRemoved”) %> Q-1vw6d  
W.kM7z>G  
<strong><jsp:getProperty name=”book” property=”title” /></strong> fW?o@vlO  
Ol!ntNhXm  
</font> )ZN|t?|  
K4kMM*D  
当包含此tag的JSP页面被编译时,jsp引擎会自动生成关于此book的同步的代码(同步可以避免几个客户同时访问此book时造成的冲突),要生成同步代码,jsp引擎需要知道此脚本变量的如下信息: fkac_X$7  
'3uVkp 6tF  
· 脚本变量名称 >y,-v:Vy  
<>Hj ;q5p  
· 脚本变量所属的类 jYKor7KTqT  
z*-2.}&U<  
· 此脚本变量是否引用了一个新的或已存在的对象 <_7*67{  
DY`kx2e!  
· 此脚本变量的有效性 kBffF@{  
>rf'-X4n  
有两种办法可以向jsp引擎提供关于脚本变量的信息:在TLD中定义variable子元素,或用tei-class子元素定义一个额外tag信息类。用variable最简单,但可能降低了一些灵活性。 ^jx7@LgS=  
ga`3 (  
Variable元素 _fKou2$yz  
o,)?!{k}  
Variable元素有如下子元素: >G%o,9i  
.4E&/w+  
· name-given ?D?D 给出的名字,是一个常量 adR)Uq9  
R#I0|;q4|p  
· name-from-attribute?D?D 属性名,在编译时给出的属性名 xU4 +|d  
jEZMUqGY!  
name-given或name-from-attribute两者必须选一,但以下子元素是可选的: *+#8mA(  
=o$sxb E(  
· variable-class?D?D变量的类型,缺省为java.lang.String。 R21b!Pd\  
C)`Fv=]R  
· declare?D?D此脚本变量是否引用了一个新对象,缺省为True。 :0Rx#%u}#  
IhVO@KJI  
· scope?D?D脚本变量的范围,缺省为NESTED。下表描述了scope的几种类型: fR(d  
)% ~OH  
脚本变量的有效范围 {A05u3}  
SMpH._VFeE  
值 1ng!G 7g  
有效性 `ojoOB^L  
方法 e?8HgiP-  
6G[4rD&  
NESTED hHV";bk  
在tag标签的开始和结束之间 Z$/xy"  
如果tag处理类实现BodyTag接口,则在doInitBody和doAfterBody中调用,否则在doStartTag中调用 n(;|q&3  
*%%g{ 3$  
AT_BEGIN lPw%ErG  
从tag标签的开始一直到页面结束 7$CBx/X50)  
如果tag处理类实现BodyTag接口,则在doInitBody、doAfterBody和doEndTag中调用,否则在doStartTag和doEndTag中调用 5kCUaPu  
ahJ`$U4n  
AT_END RBs-_o+%  
从tag标签的结束一直到页面结束 l1BtI_7p  
在doEndTag中调用 @~ ^5l  
j+$rj  
以struts为例,它的bean:define标签的实现遵循JSP1.1规范,此规范要求使用额外tag信息类来定义脚本变量。Variable元素是JSP1.2规范中加入的。以bean:define标签为例,你可以定义如下variable元素: ,-8"R`UI8  
<G|(|E1  
<tag> _Xk.p_uh  
u)}$~E>  
<variable> "_-Po^u=r  
ywGd>@  
<name-from-attribute>id</name-from-attribute> \Q0[?k  
aX)I3^ar  
<variable-class>database.BookDetails</variable-class> vHry&#Pl+  
WW4vn|0v  
<declare>true</declare> hT`J1nNt  
RP[{4 Q8  
<scope>AT_BEGIN</scope> 1OCeN%4]Qk  
s4A43i'g!h  
</variable> a{^m-fSaR"  
<D<4BnZ(  
</tag> m$}R%  
6Ypc`  
额外tag信息类 V58wU:li  
RYQ<Zr$!  
如果要定义一个额外tag信息类,你要继承javax.servlet.jsp.TagExtraInfo类。一个TagExtraInfo类必须实现getVariableInfo方法,此方法返回一个叫VariableInfo的数组类,它包括如下信息: 52:HNA\E/  
vK|E>nL  
· 变量名 [$0p+1  
iU$] {c2;A  
· 变量所属类名 QM5R`i{r  
Q sZx) bO  
· 此变量是否引用了一个新对象 *scVJ  
4|buk]9  
· 此变量的有效范围 K1mPr^3rC  
be]bZ 1f  
jsp引擎将一个名为data的参数传给getVariableInfo方法,data中包括tag标签中的所有“属性名?D?D属性值”对。它可以用来向VariableInfo对象提供脚本变量的名字和类名。 XewVcRo  
QdT}wkX  
以struts为例,它在bean:define标签中定义了一个名为DefineTei的额外tag信息类,用来向脚本变量提供信息。由于脚本变量的名称(book)和类名(database.BookDetails)是通过tag标签的属性来传递的,它们一般定义在VariableInfo的构建代码中,并且可用data.getAttributeString方法来得到这些信息。如果要允许book脚本变量能在从tag开始直到整个JSP页面结束的范围内都可用的话,那它的范围应设为AT_BEGIN。如下所示: wvO|UP H\  
0h#l JS*  
_ "?.!  
public class DefineTei extends TagExtraInfo E7t+E)=8  
*,[=}v1  
{ &CmkNm_B  
n`KXJ?t  
public VariableInfo[] getVariableInfo(TagData data) (l P4D:X  
KP7RrgOan&  
{ }~C ZqIP  
y{?jr$js<  
String type = data.getAttributeString(“type”); H$z+gbjJ  
s]%!  
If( type == null) q4ko}jn  
%y\7  
type = “java.lang.Object”; ,L:)ZZgN  
99>yaW  
return new VariableInfo[] { <({eOh5 N  
p33GKg0i+(  
new VariableInfo(data.getAttributeString(“id”), /"{ ,m!  
n rB27  
type, .*f4e3  
>`|uc  
true, L"IHyUW  
Aq]'.J =4  
VariableInfo.AT_BEGIN) 9qy 9  
*K.7Zf0  
}; ^k<$N  
MNmQ%R4jRN  
} B@vH1T  
|M>k &p,B-  
} 8Xzx ;-&4  
H 7F~+ Q-}  
i4r~eneP  
注意:关于额外tag信息类的类名必须要在TLD中的tag标签下的tei-class子元素中定义。因此,DefineTei的tei-class中的定义看起来如下: |+~2sbM  
<tei-class> j77}{5@p  
org.apache.struts.taglib.bean.DefineTagTei oP75|p  
</tei-class> ^Jc0c)*  
3'e 4{  
I_*>EA  
具有协作关系的tag V\hct$ 7Vm  
h5keYBA  
O~OWRJ@p  
tag通过共享对象来进行协作,JSP技术支持2种方式的对象共享。 :uDB3jN[  
w>Sz^_ h  
第一种方法是使用pageContext对象进行对象的共享(可支持JSP页面和tag处理类之间的共享),如果在一个tag处理类中要调用由另一个tag处理类创建的对象,可调用pageContext.getAttribute(name, scope)方法。 h*Tiv^a  
ZSt ww{Z  
第二各方式的共享是对于tag之间有嵌套关系而言的,外层的tag所创建的对象对于内层的tag来说是可以共用的。这种形式的共享的好处是减少了可能存在的重名冲突。 becQ5w/~  
N|vJrye  
要访问一个嵌套tag创建的对象,tag处理类必须先找到此嵌套tag对象,可用TagSupport的静态方法 TagSupport.findAncestorWithClass(from, class)或TagSupport.getParent方法。前者在当不确定此tag是否为嵌套tag对象时使用。一旦它的父类被找到,它就能访问其所有动态或静态创建的对象。静态创建的对象是父类的成员,而动态创建的对象可能是父类的私有对象。诸如此类的对象可以用tag处理类的setValue方法来保存,用getValue方法来获得。 *~^^A9C8  
{Dq51  
下例阐述了以上两种共享对象的方法。在这个例子当中,一个查询tag检查一个名为connection的属性名是否在doStartTag中被设置。如果connection属性被设置,tag处理类从pageContext中得到这个connection对象。否则,此tag处理类先找到它的父tag处理类,然后从它的父tag处理类中找到connection对象。 {[~,q\M[  
;_&L^)~P$  
-- FtFo  
public class QueryTag extends BodyTagSupport H,~In2Z  
K(<P" g(  
{ C8q-gP[  
S]g)^f'a65  
private String connectionId; Lpf=VyqC  
=ApT#*D)o  
public int doStartTag() throws JspException k8V0-.UL}  
}TvAjLIS6  
{ !{ lb#  
5xUPqW%3  
String cid = getConnection(); 4]KceE  
b;l%1x9r  
if(cid != null) _Z2)e*(  
HI 61rXNF  
{ o]U ==  
T9?_ `h  
//存在一个connection id,使用它。 Lr:K0A.Ch  
{'kL]qLg  
connection = (Connection) pageContext.getAttribute(cid); ,-kZ5&r  
g XMkI$ab  
} 'WCTjTob/  
3 2D/%dHC  
else :tG5~sK  
C\D4C]/8  
{ =x>k:l~s  
b@hoH)<9E  
ConnectionTag ancestorTag = (ConnectionTag)findAncestorWithClass(this, 2Wtfx" .y  
7Y:s6R|  
ConnectionTag.class); 5{TF6  
xE_[ = 7=  
if(ancestorTag == null) ?VsZo6Z"  
t+ ]+Gn  
{ \gpKQt0  
6I0MJpLW  
throw new JspTagException(“一个没有connection属性的查询标签必须被一个connection标记嵌套。”); 7F\g3^ z9`  
Qafg/JU  
} |0-L08DW  
gEu\X|7'  
connection = ancestorTag.getConnection(); ps{(UYM=b  
9qA_5x%"%u  
} 3RUB2c4  
?dYDfyFfB  
} NQ!F`  
.O^|MhBJu  
} A )cb  
w?q"%F;/  
!k63 `(Ti  
J:a^''  
此查询标签在JSP页面中的调用形式可以从以下2种定义中任选一种: RI=B(0 A  
u 6+  
x!+ a,+G  
<tt:connection id=”con01” ...> ... </tt:connection> PdZSXP4;k  
p\K5B,  
<tt:query id=”balances” connection=”con01” > XEI]T~  
1Rh&04O>VL  
SELECT account, balance FROM acct_table :.,I4>b2  
W+E2({  
where customer_num = <%= request.getCustno() %> mVLGQlvVK  
pifgt  
</tt:query> ZSNg^)cN  
%y q}4[S+o  
eMwf'*#  
或 W=*\4B]  
vKeK]  
<tt:connection ...> XN@5TZoaW  
oS4ag  
<x:query id=”balances”> wHmEt ORo  
1tDN$rM5  
SELECT account, balance FROM acct_table [g? NU]  
sIpK@BQ'  
where customer_num = <%= request.getCustno() %> o>YR Kb  
X {$gdz8S9  
</x:query> lQzrf"N'  
-Da_#_F  
</tt:connection> B06/mKZ7  
`PL!>oa(8  
<bH>\@p7}  
与此同时,在TLD中必须指定connection属性为可选的,定义如下: 9SPu 4i  
Ud](hp"  
<tag> epnDvz\   
7"NUof?i  
... 4ZIXG,@mZJ  
ll#PCgIm  
<attribute> j{vzCRa>8  
Q7C'O @  
<name>connection</name> Wq4?`{  
G`pI{_-e  
<required>false</required> SG~R!kN}Q  
e\89;)  
</attribute> ()r DM@  
V;m3=k0U  
</tag>
描述
快速回复

您目前还是游客,请 登录 或 注册
温馨提示:欢迎交流讨论,请勿纯表情、纯引用!
认证码:
验证问题:
10+5=?,请输入中文答案:十五