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

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

级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记! sDR Av%w  
3$Vx8:Rhdn  
一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。 $E[M[1j  
AWPgrv/  
在这篇文章中,我们主要讨论: S8+l!$7   
ya5HAs  
· 什么是自定义tag标签? if*~cPnN  
aMxj{*v7  
· 怎么使用tag标签? Q[aF"5h%  
yPe9KN_  
o 声明要使用的tag库 ,fTC}>s4  
G<k.d"<  
o 找到与之对应的tag处理类 mPqK k  
:-<30LS $  
o tag标签的类型 n qx0#_K-E  
63_#*6Pv28  
· 自定义tag标签 jUl_ToX  
5''k|B>  
o tag处理类 <;'{Tj-"  
wq,&0P-v  
o tag库描述 7cWeB5 e?O  
sZxTsUW  
o tag标签示例 e=p_qhBt  
Vgkj4EE  
o 带属性的tag N6p0`  
>R_m@$`  
o 带body的tag \ykA7Y%  
oM^vJ3  
o 定义了脚本变量的tag Q4*{+$A  
-!mtLaLw  
o 具有协作关系的tag Gc*=n*@^K  
zY@0R`{@p  
· 自定义tag标签 nk_X_y  
3Nwix_&S  
o 一个迭代tag的例子 c`hENPhW  
9z{g3m70@  
o 一个模板tag库 tS5J{j>T  
#G?#ot2o  
o tag处理类到底是怎样被调用的? f*88k='\W  
(UhJ Pco"  
Q9h=1G\K  
什么是自定义的tag? O"kb*//  
=8TBkxG  
一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。 J>G'H)  
EAm31v C  
自定义tag标签有很多特色,诸如: &OE-+z  
P*>?/I`G  
· 可以在JSP页面中自定义tag标签的属性 ePl+ M  
[\ Sd*-  
· 访问JSP页面中的所有对象 e-UWbn'~  
  )*6  
· 可以动态地修改页面输出 #H4<8B  
a5O$he  
· 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。 0H.bRk/P+  
kka{u[ruA  
· tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。 $;} @2U   
0-aaLC~Z>  
PX0N7L  
使用tag标签 1:- M<=J?f  
J7oj@Or9  
hR:i!  
本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。 _A& [rBm|  
l+@k:IK  
要使用tag标签,JSP程序员必须做2件事: +t1+1 Zv  
QmGK! H>3  
· 声明此tag标签的tag库 l Le&q  
l-20X{$m:  
· 实现此tag标签 "X._:||8  
U(x$&um(l  
声明tag标签所在的tag库 y!:vX6l  
zFipuG02  
如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明) TOgH~R=  
8tf>G(I{  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> ]]`[tVaFr  
Z,\(bW qF  
uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。 N%q{CYF6  
;14Q@yrZ0  
TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。 fhR u-  
(E 8jkc  
以下taglib指示符直接引用一个TLD: :RZ'_5P[If  
7<(U`9W/q  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> hH-!3S2'  
59:kL<;S-  
以下的taglib指示符通过一个逻辑名称间接地引用一个TLD: "R-j  
oRcP4k;d=  
<%@ taglib uri=”/tutorial-template” prefix=”tt” %> %}-ogi/c  
wv\"(e7(  
如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素: r4gLoHD)  
'Z,7{U1P  
<taglib> *%_M?^  
Au/'|%2#(  
<taglib-uri>/tutorial-template</taglib-uri> \>EUa}%xn  
P,F5Hf  
<taglib-location> F.(e}EMyNh  
qz Hsqlof  
/WEB-INF/tutorial-template.tld `:m=rT_  
j5[ >HL  
</taglib-location> n>:e8KVM;  
qPUACuF'  
</taglib> : 4lR`%  
3BLH d<  
t4~?m{  
实现此tag标签 2v4&'C  
5 ^l-3s?M  
2\O!vp>|-  
为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。 =*6frC~  
tBwPB#:W  
DAtAc(05)  
tag标签类型 wa&:86~l?  
-cZuP7oA  
z5<&}Vh;P  
自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点): %wu,c e]*  
;F71f#iY  
<tt:tag> 9WQ'"wyAQ  
)liNjY@  
body 9n\v{k=  
Sn.I{~  
</tt:tag> UN^M.lqZX  
_x`:Ne?  
AGVipI #  
一个不带body的tag标签如下: _jxysFl=  
sv "GX< +  
<tt:tag /> g&ba]?[A  
^Ga_wJP8S  
TC:t!:  
简单的tag标签 4zBcq<R7  
;t@^Z_z,CR  
一个没有body和属性的tag标签如下: d)$ seZB  
K #JO#  
<tt:simple /> {cw+kY]m4-  
eR3MU]zF  
+K;%sAZy  
带属性的tag标签 RzLeR%O  
ms+gq  
-*?{/QmKb  
自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。 :4"b(L  
 M[R'  
你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值: 1JI7P?\B  
WS@8Z0@RD  
<loglic:present parameter = “Clear”> Dl}va  
S|IDFDn  
而另一个标签logic:iterate是用表达式来给属性赋值: ??P3gA  
sP8_Y,  
<logci:iterate collection=”<%= bookDB.getBooks() %>”  |FFM Q"  
RT9%E/m  
id=”book” type=”database.BookDetails”> j2n 4; m  
3}.OSt'=  
Y[;Z7p  
带body的tag标签 lgHzI(  
. ve a[  
一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。 jwwst\f  
eN<?rVZl  
在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息: Mt12 1Q&"  
oT}Sh4Wt.  
<logic:present parameter=”Clear”> cavzXz  
4&`d$K  
<% cart.clear(); %> {?IUf~<  
bGB5]%v,  
<font color=”#ff0000” size=”+2”><strong> zn\$6'"  
W}\<}dK  
你选择了清除购物车! ]k.YG!$  
p!K]c D  
</strong></font> g8Zf("  
N$8"X-na?  
</logic:present> + j6^g*  
s! sG)AR.J  
j2%#xZ{33  
到底是用属性还是用body来传递信息? mi sPJO&QD  
DJRr  
如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。 )Vx C v  
6wyhL-{:  
42DB0+_wz  
定义脚本变量的tag标签 xn7bb[g;  
U }}E E~W  
所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等: NX<Q}3cC  
n(Ry~Xu_  
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” /> [>kzQYT[  
Yb>A?@S  
<% tx.begin(); %> bLz('mUY  
v,c:cKj  
... DEKO] i  
t~]tw  
3 W?H^1t  
具有协作关系的tag标签 >vQKCc|93  
lMXLd91  
自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。 QPsvc6ds  
k=5v J72U  
<tt:tag1 attr1=”obj1” value1=”value” /> t$U eks  
l`AA<Rj*O-  
<tt:tag2 attr1=”obj1” /> Be0v&Q_NK  
|DoD.?v  
在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。 ,#80`&\%  
_,|N`BBqd  
<tt:outerTag> a[V4EX1E  
i}ti  
<tt:innerTag /> s#)tiCSVW  
6C*4' P9>  
</tt:outerTag> jR,3 -JQ  
dv \aP  
'ewVn1ME[  
Tag处理类 |f"1I4K g  
lO^YAOY  
K>`*JJ,  
Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。 0]t7(P"F6  
dIvvJk8  
当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。 3=kw{r[2lM  
vtf`+q  
下表说明不同类型的tag所需要不同的处理过程: &0@AM_b  
?rububDT{  
Tag处理类的方法 I~U;M+n*y  
o7s<G8;?  
Tag标签类型 o_%gFV[q  
所调用的方法 hc5iIJ]  
x?-kt.M  
基本标签 .&c!k1kH  
doStartTag, doEndTag, release @RVj~J.A  
Pt %EyFG  
带属性的标签 BYsQu.N  
doStartTag, doEndTag, set/getAttribute1...N, release F%e5j9X`  
uze5u\  
带内容的标签 Je;HAhL  
doStartTag, doEndTag, release WEB enGQ  
u69s}yZ  
带内容的标签,且内容重复循环 *Mr'/qp,  
doStartTag, doAfterBody, doEndTag, release 5JRj'G0I  
&+F}$8,  
带内容的标签,且内容与JSP交互 \"hP*DJ"  
doStartTag, doEndTag, release, doInitBody, doAfterBody, release r#' E;Yx  
eWAgYe2  
一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。 BZWGXzOFh  
:jioF{,  
如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。 ^Dw18gqr=@  
1c03<(FCd  
一般情况都将所有的tag处理类打成了JAR的包,以便于发布。 O2>W#7  
L k]/{t0  
u}IQ)Ma  
Tag库描述(简称TLD) 5QJ FNE  
BvV!?DY4  
)qV&sru.$  
Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。 LDv>hzo  
)1S"D~j-  
TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。 `?xE-S ;Pn  
%W]" JwRu  
一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如: 0w ] pDj  
gpzZs<ST  
<?xml version="1.0" encoding="ISO-8859-1" ?> SI@Yct]<g  
9q f=P3  
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> - -H%FYF`  
TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表: s~MCt|a  
qz/d6-0"  
K yFR;.F-  
<taglib>的子元素 joJ:* oL  
"?TKz:9r  
Element Wc- 8j2M  
Description Z:s:NvFX  
Pi:=0,"XOp  
tlib-version xSoXf0zq:  
Tag库的版本 W8{zV_TBm  
0ud>oh4WPR  
jsp-version H@hHEzO  
Tag库所需要的jsp的版本 Qp]-4%^Vz  
Sk&l8"  
short-name b!xm=U  
助记符,tag的一个别名(可选) ^5d9n<_xnQ  
1*J#:|({(  
uri &C7HG^;W9  
用于确定一个唯一的tag库 b9@VD)J0E  
\H5{[ZUn  
display-name VyL|d^'f_  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) J?N9*ap)  
o@g/,V $  
small-icon E?Ofkc$q  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) Q.Ljz Z  
i@ XFnt  
large-icon CHRO9  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) oc3}L^aD  
(N25.}8Y  
description '=eE6=m^K  
对tag库的描述(可选) bkfk9P  
Rk.GrLp  
listener @ag*zl  
参见下面listener元素 @n:.D9  
ngHPOI16  
tag 6$^dOJ_"  
参见下面tag 元素 Ghpk0ia%d  
eEG]JH  
Listener元素 gELb(Y\ak  
Jz6,2,LN  
一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。 '}q1 F<&  
&k2nt  
Tag元素 znl_~:.4]X  
Tx'ctd#Y  
每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。 N$SJK  
!,3U_!  
每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素: ^  M4-O~  
~ U,a?LR/  
Tag元素的子元素 ~NtAr1  
v lsS  
元素名称 8^Ov.$rP  
描述 /4Lmu+G4  
?nAKB5=  
name 3qc o2{nz  
独一无二的元素名 t,yzqn  
gwepaW  
tag-class eZWR)+aq  
Tag标签对应的tag处理类 I^z$0  
"gPAxt  
tei-class _ooSMp|  
javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选) MjHjL~Tg  
uJ!yM;{+  
body-content wzRIvm{  
Tag标签body的类型 Q5s?/r  
Xqac$%[3  
display-name S(f V ,;Z  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) C8 b%r|^#  
Ag!#epi{0  
small-icon GCgpe(cQ  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) a~-^$Fzgy  
S3k>34_%9  
large-icon E|A,NPf%I  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) T?Dq2UW  
CF`fn6  
description >xt*(j&}  
此tag标签的描述 MXxE)"G*a  
 Dy[ YL  
variable /B?hM&@z  
提供脚本变量的信息(同tei-class)(可选) Um$a9S8b&  
]3E':JM@  
attribute nd] AvVS  
Tag标签的属性名 -~HlME *~f  
%T&#JF+;  
以下章节介绍对于不同类型的tag,如何具体地实现它们。 `f2m5qTP%  
o\luE{H .?  
'd"\h#  
简单的tag QJG]z'c+  
zq5_&AeW  
.F~EQ %  
tag处理类 2,>q(M6,EA  
+"] 'h~W  
简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。 "iof -b=ys  
e< Ee2pGX  
以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下: Kup-O u,  
rwxJR@Ttn  
Q#bFW?>y,  
public SimpleTag extends TagSupport BX),U  
Oed&B  
{ Lh &L5p7  
*TuoC5  
public int doStartTag() throws JspException ^yRCR] oT  
qvOBvUR}  
{ OD"eB?  
^3`98y.Q  
try{ T T0O %  
n20H{TA  
pageContext.getOut().print(“Hello.”); =*'X  
i[ BR"(  
}catch(Exception e){ T^GdN_qF  
>?e*;f$VdJ  
throw new JspTagException(“SimpleTag: “ + e.getMessage()); nX Qz  
f|VP_o<  
} CRWO R pP  
)m[!HE`cZ  
return SKIP_BODY; PyHE >C%  
!*%3um  
} !9o8v0ZI  
)K2n!Fbd  
public int doEndTag() NUL~zb  
#G#gB   
{ W,agP G\+  
rMlbj2T  
return EVAL_PAGE; XB;;OP12  
73xI8  
} ]Ly)%a32  
'd?8OV  
} PfrW,R~r  
JsPuxu_  
:OI!YR%"  
注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如 L761m7J]B  
lQ+-g#`  
<body-content>empty</body-content> >5 5/@+^  
Q)a*bPz  
*pasI.2s#  
带属性的tag标签
评价一下你浏览此帖子的感受

精彩

感动

搞笑

开心

愤怒

无聊

灌水
级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
只看该作者 1 发表于: 2007-01-01
tag处理类 jEO;  
3YT _GW{  
对于tag标签的每个属性,你必须依照JavaBeans规范来定义其属性,以及get和set方法。以struts的logic:present 标签为例, hcaH   
%)aDh }  
<logic:present parameter=”Clear”> xEiW]Eo  
xU rfH$$!`  
与此相应,此tag处理类应有如下方法和定义: ;8 b f5  
Y2$ % %@  
Y0hL_46>  
protected String parameter = null; H{GbOI.  
.HtDcGp  
public String getParameter() /r?X33D!  
mA>Pr<aV:  
{ =q"3a9 pb7  
gVl#pVO`N  
return this.parameter; JqZ%*^O  
j/Kw-h ,5"  
} L|H{;r'  
3?}SXmA'@  
public void setParameter(String parameter) ,,iQG' *  
-zTeIvcy5  
{ 0 s 4j>  
G37_ `C  
this.parameter = parameter;  3sw1y  
{l1;&y?  
} ,#m\W8j  
JL$RBr  
JEd/j zR(  
注意:如果你的属性名为id,而且你的tag处理类是从TagSupport类继承的,那你就不需要定义它的属性和set和get方法,因为他们早已在TagSupport被定义过了。 lubS{3<  
/;>EyWW  
Attribute元素 1h"B-x  
C/$IF M<  
对于tag标签的每个属性,你必须定义它是否必须的,它的值是否可以用诸如<%= …%>的表达式来获得,以及它的类型(可选),如果不指定它的类型,那就默认为是java.lang.String类型。如果rtexprvalue元素被定义为true或yes,那么在type元素中就定义了attribute的返回类型。 >pYgF =J  
BxG;vS3>*e  
<attribute> &, )tD62s  
U9q*zP_jV  
<name>attr1</name> u J$"2<O  
_1Eyqh`oh  
<required>true|false|yes|no</required> >w'6ZDA*X  
$200?[  
<rtexprvalue>true|false|yes|no</rtexprvalue> g$97"d'  
g?`J,*y  
<type>attribute的返回类型(只用当rtexprvalue为真是才有效)</type> AX)zSrXn  
_Dv^~e1c  
</attribute> ZA P+jX;  
(/Mc$V  
如果tag的某个属性不是必须的,那tag处理类会自动提供一个缺省值。 'K!kJ9oqe  
`l}-S |a  
例如,在logic:present这个tag标签中定义了一个属性叫parameter,但它不是必须的,而且它可以被诸如<%= …%>的表达式来赋值。 C+mU_g>  
J B|I/\(A  
<tag> QJ /SP  
3,[2-obmi  
<name>present</name> }B5I#Af7  
p%s D>1k  
<tag-class>org.apache.struts.taglib.logic.PresentTag</tag-class> 4|(?Wt)5  
=bDG|:+  
<body-content>JSP</body-content> A>?fbY2n  
u62sq: GjH  
dd$N4&  
H07j&  
<attribute> Y!L jy [/  
H@zk8]_P  
<name>parameter</name> 'GFzI:Xr  
|(%H O@i  
<required>false</required> @K9T )p]  
"|.(yN  
<rtexprvalue>true</rtexprvalue> ueR42J%s  
p{rS -`I  
</attribute> QP#Wfk(C  
H[D/Sz5`  
MjpJAV/84  
U]|q4!WE  
</tag> &f*dFUM]I  
!A!\S/x4  
=lwS\mNs  
属性元素的校验 .N=hA  
mw[4<vfB0a  
qx)k1QY  
有关于tag标签的有效值可以从tag库的说明文档中获得,当JSP页面被编译时,jsp引擎会强制性地参照TLD中定义的规则进行检查。 Z=0W@_s  
MxRU6+a  
还有一个方法也可以进行属性元素的校验,就是先继承类TagExtraInfo,然后调用它的isValid方法。这个类同时也起到提供tag中定义的脚本变量信息的作用。 >v[(w1?rX  
|Z ,G  
IsValid方法通过TagData对象来传递属性信息,它包括着tag的所有的属性名-值的信息。由于校验发生在运行时刻,因此这个属性的值将被赋值为TagData.REQUEST_TIME_VALUE。 ?_aR-[XRg  
(5~C _Y  
例如tag标签<tt:twa attr1=”value1” />在TLD中定义如下: *K|aK p}  
D.(G9H  
<attribute> Rs`a@ Fn  
zc+;VtP|8  
<name>attr1</name> B5:g{,C  
er0D5f R  
<required>true</required> yf)`jPM1<  
` a>vPW  
<rtexprvalue>true</rtexprvalue> v=tj.Vg  
ozC!q)j  
</attribute> M N#C2 qz  
Db(_T8sU  
/BM1AV{s6  
这个定义说明了attr1能在运行期间被赋值。 ?Z>.G{Wm@  
{yR)}r  
以下的isValid方法检查attr1属性的值是否属于Boolean类型。注意由于attr1能在运行刻被赋值,那么isValid方法必须检查tag用户是否对此tag进行了运行时刻赋值。 Wq(l :W'  
R`2A-c  
L]d@D0.Z  
Public class TwaTEI extends TagExtraInfo N;'HR)  
.gGvyscdH;  
{ gE&W6z0fJ  
G%!\ p:w  
public boolean isValid(Tagdata data) vo(NB !x$  
|QLX..  
{ aMQjoamz  
A Vm{#^p[(  
Object o = data.getAttribute(“attr1”); N?;o_^C  
`mjx4Lb  
If(o != null && o != TagData.REQUEST_TIME_VALUE) 7[g;|(G0  
rxj@NwAno  
{ ^,lZ58 2  
{X<4wxeTo  
if( ( (String)o).toLowerCase().equals(“true”) || xn@0pL3B~  
*ldMr{s<R  
((String)o).toLowerCase().equals(“false”) ) U5!f++  
W@,p9=425  
return true; -Zg @D(pF  
Reu{   
else *Ca)RgM  
JA(fam~{  
return false; RX5.bVp eE  
kLt9; <L  
} ;#s}b1  
liqR#<  
else iN_D8dI  
=5~F6to  
return true; <m,yFk  
K;p<f{PE  
} {Y91vXTz7  
pXh~#o6 V  
} d-;9L56{P  
pP* ~ =?  
PCPf*G>  
带body的tag `n`"g<K)Q  
yv)nW::D(  
Hp}  
tag处理类 RP,:[}mPl  
,p!B"# ot  
HCG@#W<wc  
如果tag标签含有内容,那处理方式会略微有些不同,而且还要视tag处理类是否要与body交互的情况而定。如果要与body交互,那我们认为tag处理类要可能要对body进行操作。 F`0c?)  
wD ],{y  
Tag处理类不与body交互 #M?F^u[  
$54=gRo^  
如果tag处理类不与body交互,tag处理类应该实现Tag接口或从TagSupport中派生,如果body要被计算,那么doStartTag方法应返回 EVAL_BODY_INCLUDE,否则应返回SKIP_BODY。 6f?BltFaN  
("E!Jyc!  
如果tag处理类要对body反复运算,则它应该实现IterationTag或从TagSupport中派生。如果tag处理类认为body还未计算完的话,那它的doStartTag方法和doAfterBody方法必须返回EVAL_BODY_AGAIN。 %,,`N I{  
p x|>v8  
Tag处理类与body交互 f[Fgh@4cj  
)ojx_3j8  
如果tag处理类与body交互,那tag处理类应实现BodyTag接口或从BodyTagSupport中派生。这种tag处理类一般要实现doInitBody和doAfterBody方法。 #_?TIY:h  
hA*Z'.[  
Body允许一些方法来读写它的内容。Tag处理类可以调用body内容的getString或getReader方法来从body中提取信息,也可用 writeOut(out) 方法来将body的内容写入到out对象中。其中out对象通过tag处理类的getPreviousOut方法来获得。 C~{NKMeC/m  
OyJsz]b} M  
如果body的内容需要被计算,那么doStartTag方法必须返回EVAL_BODY_BUFFERED,否则,它将返回 SKIP_BODY。 C NfJ:e2  
%e Sm&`  
doInitBody 方法 O:;OR'N9  
`u#;MUg  
此方法在body内容已经设好,但未被计算之前被调用。你可以根据不同的body内容来制定初始化策略。 RQ^m6)BTo  
| "Jx  
doAfterBody方法 3J'73)y  
x*me'?q  
此方法在body内容已被计算后进行调用。 s]y-pZ  
<E>7>ZL  
和doStartTag方法一样,doAfterBody方法返回一个指示符指示是否要继续计算body,如果要继续计算,则doAfterBody应返回EVAL_BODY_BUFFERED,否则,它应返回SKIP_BODY。 d&[iEU  
AozmO  
release 方法 @sw9A93A  
Y^R?Q'  
tag处理类调用此方法将它的状态重置为初始状态,并释放所有的私有资源。 {gFAvMj #  
%/l-A pu  
'y4zBLY  
以下的例子读取body的内容(其中含有一条sql语句),然后将它传递给一个对象,让它进行查询。由于此处body不须重新计算,所以doAfterBody会返回SKIP_BODY。 g.I(WJX0  
#y=ZP:{:t  
R2}kz.  
Public class QueryTag extends BodyTagSupport %n05 Jitl  
@up&q  
{ 7 9Qc`3a  
5/B#)gm  
public int doAfterBody() throws JspTagException D:wnO|:  
onnI !  
{ t_jyyHxoZ:  
N[qA2+e$Z  
BodyContent bc = getBodyContent(); n1QEu"~Zj  
x37/cu  
//将body的内容以字符串的格式提取出来 s0cs'Rg  
nJFk4v4:2  
String query = bc.getString(); .E+OmJwD  
"jL1. 9%"  
//清除body u64 @"P  
#^|| ]g/N  
bc.clearBody(); (n=9c%w  
!1a}| !Zn  
try{ f).*NX  
CifA,[l34  
Statement stmt = connection.createStatement(); x3Nkp4=Xd  
4|[<e-W  
Result result = stmt.executeQuery(query); U/ ?F:QD4  
7:n?PN(p6a  
}catch(SQLException e){ SQ}S4r  
]SFWt/<  
throw new JspTagException(“queryTag: “ + e.getMessage() ); 7\mDBG  
gU l1CH&  
return SKIP_BODY; bb|}'  
807al^s x  
} b -PSm=`  
q75ky1^1:  
} `9/0J-7*  
}FrEF\}]_7  
>Q; g0\I_  
body-content元素 ?RHn @$g8M  
M~uMY+>   
jDR')ascn  
由于tag可能会有body,你必须用body-content元素来指定body内容的类型: +A@m9  
aX|g S\zx  
<body-content>JSP|tagdependent</body-content> )X/*($SuA  
$; ?c?n+  
# Mu<8`T-  
如果body的内容是定制的或内部的tag、脚本元素、或HTML广本,则归类为JSP类型。其他的类型,比如上面代码所述的?D?D将sql statement类传给 query tag的这种类型应该标为tagdependent。 `19qq]  
yq?]V7~  
注意:实际上body-content的值并不影响tag处理类对body内容的处理,它仅仅是被tag编辑工具用来描述此body的内容。 ]DO&x+Rb  
tZbFvk2  
C,fY.CeI  
用tags定义脚本变量 jgG$'|s}  
/hL\,x 2  
E, GN|l  
tag处理类 n+2%tW  
yNBv-oe5  
3A_G=WaED  
tag处理类负责创建或设置页面中定义的脚本变量,用pageContext.setAttribute(name,value,scope)或pageContext.setAttribute(name,value)方法来实现。一般来说,tag处理类通过脚本变量的名称来获取它,脚本变量的名称一般可用get方法来获得。 D93gH1z  
@Gt`Ds9=  
如果脚本变量的值依赖于tag处理类中的上下文中某一对象,那它可用pageContext.getAttribute(name,scope)方法来找到那个对象。一般的处理过程是tag处理类先找到脚本变量,再对其进行处理,然后用pageContext.setAttribute(name,object)的方法来设置它的新值。 xYPxg!  
u"`*DFjo*  
对象的生存周期(scope)如下表: 6#U^< `  
eeM?]J-  
对象的生存周期表 \Wr,<Y  
?E6^!4=,  
名字 V7EQ4Om:It  
可访问范围 [KSH~:h:NR  
生存周期 ^*0'\/N&  
&kzj?xK=(j  
page -U >y   
当前页面 ?F_)-  
一直有效,除非页面向客户提交响应或重定向到一个新页面 f"dSr  
/,2rjJ#b  
request s9@Sd  
当前页面或当前页面重定向到的页面 Od##U6e`  
一直有效,除非页面向客户提交响应 Ab2Q \+,  
"u492^  
session I-DXb M  
当前页面或在同一浏览器窗口中的页面 _[t8rl  
一直有效,除非关闭当前浏览器、超时、网络故障 GSi>l,y'  
#$E)b:xj  
application ((bTwx  
整个web应用程序的所有请求 uOd& XW  
一直有效,除非发生网络故障、服务器故障 T.ML$"f  
36vgX=}  
提供关于脚本变量的信息 nS9wb1Zl  
nL-K)G,  
以下示例定义了一个名为“book”的脚本变量,用来访问程序中关于书的信息: @1:0h9%  
sOpep  
<bean:define id=”book” name=”bookDB” property=”bookDetails” type=”database.BookDetails” /> BUsV|e\  
H43MoC  
<font color=”red” size=”+2” > $n!K6fkX%  
G8J*Wnwu[K  
<%= messages.getString(“CartRemoved”) %> {<=#*qx[Y!  
KzV 2MO-$  
<strong><jsp:getProperty name=”book” property=”title” /></strong> "@/62b  
g[[;w*;z  
</font> =d)-Fd2li  
] )}]/Qw  
当包含此tag的JSP页面被编译时,jsp引擎会自动生成关于此book的同步的代码(同步可以避免几个客户同时访问此book时造成的冲突),要生成同步代码,jsp引擎需要知道此脚本变量的如下信息: Ig6T g ?  
`5~3G2T  
· 脚本变量名称 p B;3bc  
!?!C'-ps  
· 脚本变量所属的类 ye}p~&  
Zd:Taieh@  
· 此脚本变量是否引用了一个新的或已存在的对象 .2) =vf'd  
Y>+y(ck  
· 此脚本变量的有效性 nh>K`+>co  
XB59Vm0E=  
有两种办法可以向jsp引擎提供关于脚本变量的信息:在TLD中定义variable子元素,或用tei-class子元素定义一个额外tag信息类。用variable最简单,但可能降低了一些灵活性。 "Wo,'8{v  
9f+>ix,ek*  
Variable元素 'T<iHV&  
$%R$ G`.KM  
Variable元素有如下子元素: 67SV~L#%O  
Z|" p*5O,  
· name-given ?D?D 给出的名字,是一个常量 ,#?uJTLH  
y: m_tv0~0  
· name-from-attribute?D?D 属性名,在编译时给出的属性名 e [_m< e  
E.|-?xQ6  
name-given或name-from-attribute两者必须选一,但以下子元素是可选的: c(;a=n(E#  
{ FZ=olZ  
· variable-class?D?D变量的类型,缺省为java.lang.String。 3I\n_V<  
,JU@|`  
· declare?D?D此脚本变量是否引用了一个新对象,缺省为True。 L@`ouQ"sa  
kVK/9dy-F  
· scope?D?D脚本变量的范围,缺省为NESTED。下表描述了scope的几种类型: Suk  
p~ HW5\4  
脚本变量的有效范围 D(-yjY8aG  
)9l^O  
J:&[ 59  
有效性 8#!i[UF dj  
方法 xk&Jl#v  
FFdBtB  
NESTED 0c K{  
在tag标签的开始和结束之间 7qTE('zt  
如果tag处理类实现BodyTag接口,则在doInitBody和doAfterBody中调用,否则在doStartTag中调用 E dZ\1'&/9  
U- )i+}Ng  
AT_BEGIN a:QDBS2Llv  
从tag标签的开始一直到页面结束 M%jPH  
如果tag处理类实现BodyTag接口,则在doInitBody、doAfterBody和doEndTag中调用,否则在doStartTag和doEndTag中调用 $!&*xrrNM  
UG=K|OXWJ  
AT_END Sb~MQ_  
从tag标签的结束一直到页面结束 `{qG1  
在doEndTag中调用 t%F0:SH  
p<M\U"5Ye  
以struts为例,它的bean:define标签的实现遵循JSP1.1规范,此规范要求使用额外tag信息类来定义脚本变量。Variable元素是JSP1.2规范中加入的。以bean:define标签为例,你可以定义如下variable元素: (}}S9 K  
=s<( P1|"  
<tag> HRB<Y mP@  
Z+@2"%W  
<variable> E Cyyl  
U8 nH;}i  
<name-from-attribute>id</name-from-attribute> B^g ?=|{  
r Tz$^a}/  
<variable-class>database.BookDetails</variable-class> b0oMs=uBn  
-[-wkC8a  
<declare>true</declare> /Q~i~B 2j-  
"~'b  
<scope>AT_BEGIN</scope> g)-bW+]q  
Yk=PS[f  
</variable> "I(xgx*  
i':C)7  
</tag> cTG|fdgMW  
IIbYfPiO  
额外tag信息类 h<$MyN4]g  
i[ mEi|  
如果要定义一个额外tag信息类,你要继承javax.servlet.jsp.TagExtraInfo类。一个TagExtraInfo类必须实现getVariableInfo方法,此方法返回一个叫VariableInfo的数组类,它包括如下信息: w K}T`*k  
6i}iAP|0  
· 变量名 s_mS^`P7  
yj\Nkh  
· 变量所属类名 P-9<YN  
%$b:X5$Z  
· 此变量是否引用了一个新对象 z*-2.}&U<  
A{A\RSZ0  
· 此变量的有效范围 ?!+MM&c-n  
[UH||qW  
jsp引擎将一个名为data的参数传给getVariableInfo方法,data中包括tag标签中的所有“属性名?D?D属性值”对。它可以用来向VariableInfo对象提供脚本变量的名字和类名。 NX}<*b/  
R6(oZph  
以struts为例,它在bean:define标签中定义了一个名为DefineTei的额外tag信息类,用来向脚本变量提供信息。由于脚本变量的名称(book)和类名(database.BookDetails)是通过tag标签的属性来传递的,它们一般定义在VariableInfo的构建代码中,并且可用data.getAttributeString方法来得到这些信息。如果要允许book脚本变量能在从tag开始直到整个JSP页面结束的范围内都可用的话,那它的范围应设为AT_BEGIN。如下所示: 9g<7i  
d@qsdYu-*  
*6VF $/rP  
public class DefineTei extends TagExtraInfo fZoHf\B]{  
jbAx;Xt'=M  
{ OynXkH]0T+  
<[-nF"Q  
public VariableInfo[] getVariableInfo(TagData data) pS:4CNI{  
o,)?!{k}  
{ <*qnY7c&N;  
#?S^kM-0  
String type = data.getAttributeString(“type”); 6ZP"p<xX  
Q637N|01  
If( type == null) `G}TG(  
`7r@a  
type = “java.lang.Object”; maNl^i  
3eF -8Z(f  
return new VariableInfo[] { sc}~8T  
Sn|BlXrey  
new VariableInfo(data.getAttributeString(“id”), X<I+&Zi  
/#)/;  
type, 5;YMqUkw  
Ck) * &  
true, s6@DGSJ  
ATK_DE Au  
VariableInfo.AT_BEGIN)  B\o Mn  
C)`Fv=]R  
}; 85LAY aw  
 z62;cv  
} j3{D^|0bP  
C@'h<[v`1v  
} N u<_}  
$adbCY \  
6V7B;tB  
注意:关于额外tag信息类的类名必须要在TLD中的tag标签下的tei-class子元素中定义。因此,DefineTei的tei-class中的定义看起来如下: %yv<y+yP~  
<tei-class> ]d! UJ&<?  
org.apache.struts.taglib.bean.DefineTagTei qm"rY\:  
</tei-class> Q|#W#LV,K  
q!|*oUW  
x$6^R q>2  
具有协作关系的tag vzim<;i  
Gz,i~XX  
~Vr.J}]J  
tag通过共享对象来进行协作,JSP技术支持2种方式的对象共享。 .K1FKC$C  
8@MV%MVy$  
第一种方法是使用pageContext对象进行对象的共享(可支持JSP页面和tag处理类之间的共享),如果在一个tag处理类中要调用由另一个tag处理类创建的对象,可调用pageContext.getAttribute(name, scope)方法。 vH :LQ!2  
OC BgR4I  
第二各方式的共享是对于tag之间有嵌套关系而言的,外层的tag所创建的对象对于内层的tag来说是可以共用的。这种形式的共享的好处是减少了可能存在的重名冲突。 JzQ)jdvp  
+%ee8|\  
要访问一个嵌套tag创建的对象,tag处理类必须先找到此嵌套tag对象,可用TagSupport的静态方法 TagSupport.findAncestorWithClass(from, class)或TagSupport.getParent方法。前者在当不确定此tag是否为嵌套tag对象时使用。一旦它的父类被找到,它就能访问其所有动态或静态创建的对象。静态创建的对象是父类的成员,而动态创建的对象可能是父类的私有对象。诸如此类的对象可以用tag处理类的setValue方法来保存,用getValue方法来获得。 |#]@Z)xa  
X:vghOt?  
下例阐述了以上两种共享对象的方法。在这个例子当中,一个查询tag检查一个名为connection的属性名是否在doStartTag中被设置。如果connection属性被设置,tag处理类从pageContext中得到这个connection对象。否则,此tag处理类先找到它的父tag处理类,然后从它的父tag处理类中找到connection对象。 0Ziw_S\d&s  
P\1L7%*lU  
nU7>uU  
public class QueryTag extends BodyTagSupport v>Q #B  
\1D<!k\S  
{ RO 4Z?tz  
e4? >-  
private String connectionId; RBs-_o+%  
2N: ,Q8~  
public int doStartTag() throws JspException [YlKR'_  
'"SEw w  
{ :bwjJ}F  
y1dDO2mA  
String cid = getConnection(); n*[XR`r}  
;:\<gVi:  
if(cid != null) <G|(|E1  
_`&m\Qe>  
{ 1v.c 6~  
Rwz0poG`WG  
//存在一个connection id,使用它。 *U&0<{|T  
:~Wrf8 UQ  
connection = (Connection) pageContext.getAttribute(cid); L^@'q6*}  
oX30VfT  
} 5z7U1:  
gOSJM1Mr3  
else ME46V6[LX]  
=P't(<  
{  zv0l,-o  
Yc_8r+;(  
ConnectionTag ancestorTag = (ConnectionTag)findAncestorWithClass(this, p<2L.\6"  
,,%i;  
ConnectionTag.class); gQ Fjr_IS#  
7%Gwc?[x  
if(ancestorTag == null) J?? -j  
g jDh?I  
{ 1OCeN%4]Qk  
o<BOYrS  
throw new JspTagException(“一个没有connection属性的查询标签必须被一个connection标记嵌套。”); ?!A7rb/tj  
Ve}(s?hU5  
} _(%d(E2?  
<D<4BnZ(  
connection = ancestorTag.getConnection(); "p_J8  
$rv8K j+  
} [uC ]*G]  
8xMEe:}V  
} 8m2Tk\;:  
*|%@6I(  
} =,spvy'"*C  
nAW:utTB  
%b&". mN  
p>RNPrT  
此查询标签在JSP页面中的调用形式可以从以下2种定义中任选一种: Ta ?_5  
}vxw*8d?  
~zCEpU|@N  
<tt:connection id=”con01” ...> ... </tt:connection> -JMdE_h  
n.'8A(,r3  
<tt:query id=”balances” connection=”con01” > O#:$^#j&  
\F1_lq;K  
SELECT account, balance FROM acct_table WIC/AL'  
0^I|u t4  
where customer_num = <%= request.getCustno() %> C7lH]`W|/  
'\Giv!>  
</tt:query> {> eXR?s/  
mn, =i  
}zkHJxZgE  
_<k\FU r  
dgR g>)V  
<tt:connection ...> g7}Gip}.>  
t3*wjQ3  
<x:query id=”balances”> =mS\i663  
nKPYOY8^  
SELECT account, balance FROM acct_table s )noo  
[~-9i &Z  
where customer_num = <%= request.getCustno() %> q)LMm7  
:o0JY= 5  
</x:query> ;&< {ey  
"?]{ %-u  
</tt:connection> iHeN9 cl  
z:8eEq3w  
3h;{!|-3  
与此同时,在TLD中必须指定connection属性为可选的,定义如下: = s>T;|  
Vq2y4D?  
<tag> HG^B#yX  
.{ocV#{s  
... jF ^~p9z  
msP{l^%0  
<attribute> rID#`:Hl-|  
EN$2,qf  
<name>connection</name> K-bD<X  
*W.C7=  
<required>false</required> <;vbsksZeH  
f,h J~  
</attribute> h].<t&  
]RPs|R?  
</tag>
描述
快速回复

您目前还是游客,请 登录注册
如果您在写长篇帖子又不马上发表,建议存为草稿
认证码:
验证问题:
10+5=?,请输入中文答案:十五