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

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

级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记! Qf}b3WEAI  
r@Tq-o  
一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。 8DP] C9  
E"$AOM?(*i  
在这篇文章中,我们主要讨论: %B'*eBj~fw  
ht%:e?@i  
· 什么是自定义tag标签? BiUbg6T.G  
zQQ=8#]  
· 怎么使用tag标签? w qLY \  
Dy_Za.N2  
o 声明要使用的tag库 t1)Qa(#]  
L<**J\=7M  
o 找到与之对应的tag处理类 +WYXj  
8Yq_6  
o tag标签的类型 3jB5F0^r1  
 Lx:O Dd  
· 自定义tag标签 #4e Taik  
!yQ#E2/A  
o tag处理类 3-5X^!C  
8QN#PaY  
o tag库描述 ,f;YJHEx8  
t  Tky  
o tag标签示例 d)&}% 2ku  
b xT|  
o 带属性的tag 9$pQ|e0tJ  
2.zx  
o 带body的tag prx)Cfv  
J`*!U4  
o 定义了脚本变量的tag E6  2{sA^  
7]w]i5  
o 具有协作关系的tag y JJNr]oq  
~al4`:rRx1  
· 自定义tag标签 WZ a?Xb  
GDgq 4vfj  
o 一个迭代tag的例子 dd +%d  
[h>RO55e  
o 一个模板tag库 O.%' 47A  
J~3+j6?%  
o tag处理类到底是怎样被调用的? M}]E,[  
G:HPd.ay  
4]F:QS% x  
什么是自定义的tag? _{fh/{b1  
J1Ay^*qRU  
一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。 *-gd k9  
j`GL#J[wqQ  
自定义tag标签有很多特色,诸如: nS8oSs_  
2aef[TY  
· 可以在JSP页面中自定义tag标签的属性 gn>qd6P  
l cHqg  
· 访问JSP页面中的所有对象 2nL [P#r  
' w^Md  
· 可以动态地修改页面输出  0(2r"Hi  
"w#jC ~J<W  
· 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。 %QW1?VVP  
DM3W99PWA  
· tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。 +} al_.  
66G$5  
>}tm8|IHoo  
使用tag标签 LZirw'  
:`~;~gW<  
2E Ufd\   
本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。 Z= P]UD  
MCBZq\c  
要使用tag标签,JSP程序员必须做2件事: &R? \q*  
%s}c#n)N  
· 声明此tag标签的tag库 Z%]s+V)st  
,P&.qg i=(  
· 实现此tag标签 zJhG`iWFw  
^W&qTSjh  
声明tag标签所在的tag库 U}w,$ Y  
VI{!ZD]  
如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明) e} =tUdDf  
Sn(e@|!G  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> bqmb|mD  
;7jszs.6%  
uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。 ]kXiT Yg  
6FYO5=R  
TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。 c7~+ 5  
381a(F[$e  
以下taglib指示符直接引用一个TLD: 4CUzp.S`h  
eXN\w]GE  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> 2U;6sn*e  
6:Fb>|]*PY  
以下的taglib指示符通过一个逻辑名称间接地引用一个TLD: KaEL*  
:gD=F&V  
<%@ taglib uri=”/tutorial-template” prefix=”tt” %> }XJA#@  
it Byw1/  
如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素: |ia#Elavo  
Oz3JMZe  
<taglib> WOw( -  
fVb~j;  
<taglib-uri>/tutorial-template</taglib-uri> 4^3}+cJ7j  
fD^$ y 8  
<taglib-location> V7+fNr]I  
41Y1M]`=  
/WEB-INF/tutorial-template.tld ~pv|  
! MTmG/^  
</taglib-location> i?{cB!7  
XLu Y  
</taglib> 8>\tD  
-rn%ASye  
M<nKk#!+h  
实现此tag标签 O,a1?_m8  
fJiY~mQ  
?@*hU2MTC  
为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。 0bl?dOV{  
%< ^IAMkp  
+4*3aWf`  
tag标签类型 &nKb<o  
xF/u('A  
kYW>o}J|  
自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点): jDWmI% Y.  
q(Q$lRj/I-  
<tt:tag> AmyZ9r#{  
uZ1b_e0SGu  
body jTeHI|b  
[}mx4i  
</tt:tag> IonphTcU!  
(aeS+d x  
:637MD>5lO  
一个不带body的tag标签如下: AG Ws>  
m@,u&9K  
<tt:tag /> ZC99/NWN  
y#B4m`9  
H;1_"  
简单的tag标签 ^t 2b`n60  
rk E;OU  
一个没有body和属性的tag标签如下: f>!H<4 ]  
85}S8\_u  
<tt:simple /> hy]8t1894  
_spW~"|G  
+jPJv[W  
带属性的tag标签 x+Ws lN 2a  
G`oY(2U  
r.JM!x8  
自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。 t+l{D#?a  
5qL;@Y  
你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值: u]766<Z  
Ux!q(9<_  
<loglic:present parameter = “Clear”>  >7$h  
.FdzEauVc  
而另一个标签logic:iterate是用表达式来给属性赋值: 9<|nJt  
M669G;w(K  
<logci:iterate collection=”<%= bookDB.getBooks() %>” Ai*+LSG  
Fy#7 <Hp  
id=”book” type=”database.BookDetails”> EJid@  
N f^6t1se  
i"h~QEE  
带body的tag标签 M/abd 7q  
sPP(>y( \  
一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。 x,fX mgE  
(R|_6[zy  
在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息: `gSJEq  
5L0w!q'W  
<logic:present parameter=”Clear”> sLOkLz"x  
+Y_]<  
<% cart.clear(); %> IQ $/|b/  
PN"=P2e/ 6  
<font color=”#ff0000” size=”+2”><strong> #ULzh&yO  
~5;2ni8n  
你选择了清除购物车! *G"}m/j-  
6sQY)F7p  
</strong></font> \!Wph5wA  
WX&0;Kr  
</logic:present> S rom@c  
cR6Rb[9 N  
\ ^3cNw  
到底是用属性还是用body来传递信息? 1 uJpn  
y6P-:f/&*  
如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。 Ro.br:'Bw  
J] )gXVRM  
[l*;+N+  
定义脚本变量的tag标签 xxZO{_q  
G\B:iyKl  
所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等: Z5 Tu*u=  
 q!as~{!  
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” /> CTf39R|7_  
-1%AM40j  
<% tx.begin(); %> B42qiV2/k  
5n1T7-QCL  
... 4Jk[X>I~  
*lBX/O`=  
axM(3k.n  
具有协作关系的tag标签 V5!mV_EoR@  
-cB>; f)5r  
自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。 ^TqR0a-*  
gCZm7dgo  
<tt:tag1 attr1=”obj1” value1=”value” /> uC5W1LyI  
)rbcY0q  
<tt:tag2 attr1=”obj1” /> jP )VTk_  
T5+ (Fz  
在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。 K}!YXy h  
)vD|VLV   
<tt:outerTag> I6Oc`S!L  
S20E}bS:>  
<tt:innerTag /> {KqERS& g  
DxzNg_E]  
</tt:outerTag> _ {mG\*q  
b/&{:g!B  
Vb/XT{T;b  
Tag处理类 zxy/V^mu  
,H5o/qNU`{  
(2'q~Z+>'  
Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。 _MzdbUb5,  
D)J'xG_<O  
当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。 AxiCpAS;J  
X~rHNRIU  
下表说明不同类型的tag所需要不同的处理过程: x}jiHV@=  
Rqun}v}  
Tag处理类的方法 }EJ't io]  
I#:,!vjn  
Tag标签类型 1*]@1DJt  
所调用的方法 $m0-IyXcv  
5`f\[oA  
基本标签 Kc {~Q  
doStartTag, doEndTag, release QUi=ZD1  
7=@Mn F`  
带属性的标签 W4rh7e4  
doStartTag, doEndTag, set/getAttribute1...N, release m.>y(TI  
^ZG 3{>  
带内容的标签 5dEek7wnf  
doStartTag, doEndTag, release rtk1 8U-  
9 p`|~^X  
带内容的标签,且内容重复循环 SkMBdkS9z[  
doStartTag, doAfterBody, doEndTag, release X{;3gN  
42 &m)  
带内容的标签,且内容与JSP交互 R\>=}7  
doStartTag, doEndTag, release, doInitBody, doAfterBody, release \ Q0-yNt  
m| k:wuzqK  
一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。 Tsl0$(2W  
\I~9%QJ>  
如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。 o3xfif  
tCbn B  
一般情况都将所有的tag处理类打成了JAR的包,以便于发布。 rR 3(yy0L  
S0-/9h  
,?>:Cdz4  
Tag库描述(简称TLD) O-YB +~"3Z  
7|$ H}$  
UY*[='l!)  
Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。 uY*|bD`6&  
CsW*E,|xyP  
TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。 o_DZ  
#e(P~'A0  
一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如: {;Ispx0m  
"\u_gk{g  
<?xml version="1.0" encoding="ISO-8859-1" ?> f/K:~#k  
Tq=OYJq5U  
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> B:QAG  
TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表: w`F4.e  
X4}Lg2ts  
)a'c_ 2[  
<taglib>的子元素 Kh;jiK !  
{Tym#  
Element no lLeRE1  
Description iPoDesp  
;*_U)th  
tlib-version 3~Vo]wv  
Tag库的版本 ^9PB+mz  
VvTs87  
jsp-version @ I$;  
Tag库所需要的jsp的版本 e.:SBXZ  
<!M ab}  
short-name TWFi.w4pY  
助记符,tag的一个别名(可选) ]$gBX=  
r]+N(&q  
uri h% T$m_  
用于确定一个唯一的tag库 _N-JRM m<  
PgYq=|]`  
display-name }R -azN;  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) G[=8Ko0U+n  
HX]pcX^K  
small-icon y8.(filNB  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) O-ZB4hN8  
NFQR  
large-icon JZ  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) 8+7=yN(  
jS,zdJs=  
description VD*xhuy$k  
对tag库的描述(可选) +o\s |G|l  
]8i2'x  
listener 4vk^=  
参见下面listener元素 }m6j6uAR6)  
CdN,R"V0$@  
tag pWwB<F  
参见下面tag 元素 ages-Z_X  
68^5X"OGF  
Listener元素 !hJ% :^ xL  
 #' =rv  
一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。 mf>cv2+  
;uC +5g`  
Tag元素 gTp){  
kM`!'0kt  
每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。 Y C uuj$  
:%?\Wj5HW  
每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素: mne=9/sE"  
,DT =(  
Tag元素的子元素  /_r g*y*  
Z-!W#   
元素名称 > qSaF  
描述 kXq*Jq  
G([!(8&2Y  
name -k19BDJ,W  
独一无二的元素名 '42P=vzo  
[akyCb  
tag-class q?=eD^]  
Tag标签对应的tag处理类 4K@`>Y5g*  
%0PZZl5b  
tei-class S:UtmS+K  
javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选) 7b_Ihv   
fU+A~oL%I  
body-content ZcXqH7`r  
Tag标签body的类型 FshQ OFW  
5O9Oi:-!c  
display-name *n)3y.s  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) _BcYS  
G;+hc%3y  
small-icon P^%.7C  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) }{^i*T5rl  
|4i,Vkfhe  
large-icon >mT< AQ  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) `'u|4pRFs  
wR;_x x  
description -IR9^)  
此tag标签的描述 <dTo-P  
^Slwg|t*~P  
variable j.GpJDq  
提供脚本变量的信息(同tei-class)(可选) =;{vfjj  
K5Fzmo a  
attribute Kfc(GL?  
Tag标签的属性名 Q:]F* p2  
C!SB5G>OH  
以下章节介绍对于不同类型的tag,如何具体地实现它们。 'M\ou}P  
+:2(xgOP.V  
cI3uH1;#  
简单的tag AM}-dKei|  
A+j~oR  
;o\0:fzr  
tag处理类 EIl _QV6  
j0sR]i  
简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。 VGBL<X  
P%smX`v  
以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下: R|{6JsjG10  
d}b# "A  
YTq>K/  
public SimpleTag extends TagSupport ^HKxaW9W  
kX {c+qHM  
{ {S\cpCI`  
.N] ^g#  
public int doStartTag() throws JspException hNFMuv  
Hu x#v>e  
{ tiwhG%?2  
A0S6 4(  
try{ :$[m[y7i  
2:i`,  
pageContext.getOut().print(“Hello.”); Vm&fw".J  
=#1iio&  
}catch(Exception e){ K ^H=E  
G\TyXq_4  
throw new JspTagException(“SimpleTag: “ + e.getMessage()); /NLpk7r[\q  
=Ze~6vS,  
} T:wd3^.CG  
(XT^<#Ga  
return SKIP_BODY; pz?.(AmU\  
HI']{2p2}t  
} 05nG |  
" I`<s<  
public int doEndTag() y S7[=S  
V# w$|B\  
{ /5suyM=U  
4jis\W}%L3  
return EVAL_PAGE; :?jOts>uP  
S! ,.#e(Y  
} ^5u}   
e|AJxn]  
} Vjj30f  
|? ?uVA)\X  
R$(,~~MH  
注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如 b)$<aFl  
lGjmw"/C  
<body-content>empty</body-content> v.\1-Q?  
7u\^$25+h  
;% !'K~  
带属性的tag标签
评价一下你浏览此帖子的感受

精彩

感动

搞笑

开心

愤怒

无聊

灌水
级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
只看该作者 1 发表于: 2007-01-01
tag处理类 /S\P=lcb  
`dn|n I2  
对于tag标签的每个属性,你必须依照JavaBeans规范来定义其属性,以及get和set方法。以struts的logic:present 标签为例, id&;  
=<iK3bPkU  
<logic:present parameter=”Clear”> CdatN$/*  
5sFp+_``  
与此相应,此tag处理类应有如下方法和定义: #s)6u?N  
<.s[x~b\`  
& 2>W=h  
protected String parameter = null; ArbfA~jXB  
e6QUe.S  
public String getParameter()  9'\18_w  
j5G8IP_Wx  
{ -fT]}T6=  
DE^{8YX,  
return this.parameter; x<~ pqq8]  
#l+U(zH:JG  
} *Jmy:C<>  
k^S=i_ U  
public void setParameter(String parameter) ujmO'blO  
,N?~je.  
{ JN$v=Ox{  
"qIO,\3T  
this.parameter = parameter; AWi~qzTZ  
9`$fU)K[Pl  
} L#M9!  
@'/\O-  
>|/NDF=\s  
注意:如果你的属性名为id,而且你的tag处理类是从TagSupport类继承的,那你就不需要定义它的属性和set和get方法,因为他们早已在TagSupport被定义过了。  #dtYa  
4=%Uv^M  
Attribute元素 im Zi7o  
'0p 5|[ZD  
对于tag标签的每个属性,你必须定义它是否必须的,它的值是否可以用诸如<%= …%>的表达式来获得,以及它的类型(可选),如果不指定它的类型,那就默认为是java.lang.String类型。如果rtexprvalue元素被定义为true或yes,那么在type元素中就定义了attribute的返回类型。 bT|a]b:  
(es+VI2!&C  
<attribute> ?76Wg::  
}f+If{  
<name>attr1</name> ]Vln5U   
G{pfyfF  
<required>true|false|yes|no</required> N)RyRR.x1.  
`kpX}cKK}  
<rtexprvalue>true|false|yes|no</rtexprvalue> (vB aem9  
1j`-lD  
<type>attribute的返回类型(只用当rtexprvalue为真是才有效)</type> kn^RS1m  
+\fr3@Yc  
</attribute> k?;A#L~  
N/p9Ws  
如果tag的某个属性不是必须的,那tag处理类会自动提供一个缺省值。 TUw^KSa  
ryB^$Kh,,  
例如,在logic:present这个tag标签中定义了一个属性叫parameter,但它不是必须的,而且它可以被诸如<%= …%>的表达式来赋值。 X};m\Bz  
8V`NQS$  
<tag> v~H1Il_+  
%[u6<  
<name>present</name> zH0%; o}  
9%S{fd\#  
<tag-class>org.apache.struts.taglib.logic.PresentTag</tag-class> WS/^WxRY  
X,C&nqVFm8  
<body-content>JSP</body-content> 5Q#;4  
0&mo1 k_U  
# =V%S 2~  
r Lg(J|^  
<attribute> MUhC6s\F  
)@09Y_9r  
<name>parameter</name>  }fpK{db  
,24NMv7  
<required>false</required> b'Pq [ )  
]( V+ qj  
<rtexprvalue>true</rtexprvalue> 1L]7*NJe  
!rZO~a0  
</attribute> g]EDL<b  
Gtd!Y x  
vA2@Db}  
%C\Q{_AS  
</tag> @kvgq 0ab  
#~3x^ 4Y  
d)1)/Emyj  
属性元素的校验 o,[~7N  
blNE$X+0|  
t j&+HC  
有关于tag标签的有效值可以从tag库的说明文档中获得,当JSP页面被编译时,jsp引擎会强制性地参照TLD中定义的规则进行检查。 R $HI JM  
LTj;e[  
还有一个方法也可以进行属性元素的校验,就是先继承类TagExtraInfo,然后调用它的isValid方法。这个类同时也起到提供tag中定义的脚本变量信息的作用。 ^.5 L\  
,Xs%Cg_Ig  
IsValid方法通过TagData对象来传递属性信息,它包括着tag的所有的属性名-值的信息。由于校验发生在运行时刻,因此这个属性的值将被赋值为TagData.REQUEST_TIME_VALUE。 0#lw?sv  
[t*m$0[:  
例如tag标签<tt:twa attr1=”value1” />在TLD中定义如下: )A:2y +  
ML'4 2z Y  
<attribute> vpcHJ^19  
9r-]@6;  
<name>attr1</name> gYVk5d|8@4  
Qj5~ lX`W  
<required>true</required> G;_QE<V~_  
aehGT|  
<rtexprvalue>true</rtexprvalue> [hTGWT3  
Rn~FCj,-  
</attribute> @P#uH5U  
oJe9H<  
=]&?(Gq  
这个定义说明了attr1能在运行期间被赋值。 [/hS5TG|7  
K-IXAdx  
以下的isValid方法检查attr1属性的值是否属于Boolean类型。注意由于attr1能在运行刻被赋值,那么isValid方法必须检查tag用户是否对此tag进行了运行时刻赋值。 rLs)*A!  
4J0{$Xuu 0  
}dw`[{cm  
Public class TwaTEI extends TagExtraInfo [R CUP.  
<9 lZ%j;  
{ [?x9NQ{  
4b=hFwr[?  
public boolean isValid(Tagdata data) fN~kd m.  
kF.!U/C  
{ %^[45e  
e `zEsLs@  
Object o = data.getAttribute(“attr1”); ((^jyQ  
@'L/]  
If(o != null && o != TagData.REQUEST_TIME_VALUE) wLC!vX.S  
{Md xIp[  
{  G7 >  
WXu:mv,'e  
if( ( (String)o).toLowerCase().equals(“true”) || V#[I/D  
"<ow;ciJF  
((String)o).toLowerCase().equals(“false”) ) J~KWn.  
I"Y d6M% ;  
return true; }uo5rB5D  
(rO_ Vfaa  
else Uov%12  
0}Rxe  
return false; \kcJF'JFA0  
H+vONg  
} _6"vPN  
_Z+tb]  
else }Uki)3(  
#\N?ka}!  
return true; t^ L XGQ  
EQ`;=I3J9y  
} qJ|ByZ.N+  
IK5FSN]s/  
} W"S,~y  
! utgo/n  
;~T)pG8IS  
带body的tag q"ba~@<BEl  
;KJJK#j  
"Pi\I9M3  
tag处理类 5MV4N[;  
^;+lsEW  
!Sr^4R+Z  
如果tag标签含有内容,那处理方式会略微有些不同,而且还要视tag处理类是否要与body交互的情况而定。如果要与body交互,那我们认为tag处理类要可能要对body进行操作。 ha  
75i M_e\  
Tag处理类不与body交互 #<f}.P.Uc  
X<@ytHBv  
如果tag处理类不与body交互,tag处理类应该实现Tag接口或从TagSupport中派生,如果body要被计算,那么doStartTag方法应返回 EVAL_BODY_INCLUDE,否则应返回SKIP_BODY。 6G6Hg&B  
hh}%Z=  
如果tag处理类要对body反复运算,则它应该实现IterationTag或从TagSupport中派生。如果tag处理类认为body还未计算完的话,那它的doStartTag方法和doAfterBody方法必须返回EVAL_BODY_AGAIN。 }'$6EgX  
58zs% +F  
Tag处理类与body交互 A[J9v{bD  
h`+Gs{1qw  
如果tag处理类与body交互,那tag处理类应实现BodyTag接口或从BodyTagSupport中派生。这种tag处理类一般要实现doInitBody和doAfterBody方法。 x&sT )=#  
{%D!~,4Ht  
Body允许一些方法来读写它的内容。Tag处理类可以调用body内容的getString或getReader方法来从body中提取信息,也可用 writeOut(out) 方法来将body的内容写入到out对象中。其中out对象通过tag处理类的getPreviousOut方法来获得。 1<A+.W  
L(TO5Y]  
如果body的内容需要被计算,那么doStartTag方法必须返回EVAL_BODY_BUFFERED,否则,它将返回 SKIP_BODY。 jENarB^As  
g! ~&PT)*  
doInitBody 方法 GDw4=0u-  
H^xrFXg~z  
此方法在body内容已经设好,但未被计算之前被调用。你可以根据不同的body内容来制定初始化策略。 o O%!P<D  
*LcLYxWo  
doAfterBody方法 VOwt2&mZ  
"BjQs<]%sF  
此方法在body内容已被计算后进行调用。 k/AcXU%O+  
!_E E|#`n  
和doStartTag方法一样,doAfterBody方法返回一个指示符指示是否要继续计算body,如果要继续计算,则doAfterBody应返回EVAL_BODY_BUFFERED,否则,它应返回SKIP_BODY。 Na: M1Uhb  
?15k~1nA  
release 方法 %\N.m/5  
A}C&WT~  
tag处理类调用此方法将它的状态重置为初始状态,并释放所有的私有资源。 (ii 5pnq  
seY0"ym&e  
WIOV  
以下的例子读取body的内容(其中含有一条sql语句),然后将它传递给一个对象,让它进行查询。由于此处body不须重新计算,所以doAfterBody会返回SKIP_BODY。 yd "|HHx  
%_u*5,w  
p9R`hgx  
Public class QueryTag extends BodyTagSupport Rg)\o(J  
9 U1)sPH;  
{ KQi9qj  
OQ#gQ6;?0  
public int doAfterBody() throws JspTagException oV ?tp4&  
B;4hI?  
{ o;FjpZ  
I5'^tBf[{  
BodyContent bc = getBodyContent(); n-,~Bp [  
8"wA8l.  
//将body的内容以字符串的格式提取出来 Q !5Tw  
Xfx(X4$9  
String query = bc.getString(); g-mK(kY4p  
M7yJ2u<Ty  
//清除body H;*:XLPF  
x)G/YUv76  
bc.clearBody(); [=e61Z  
T1PWFw\GH  
try{ +<:p`%  
*[ Wh9 ,H  
Statement stmt = connection.createStatement(); r!Eo8C  
9rB^)eV  
Result result = stmt.executeQuery(query); ~FZLA}  
r-]R4#z>  
}catch(SQLException e){ |:!#k A  
qfC9 {gu  
throw new JspTagException(“queryTag: “ + e.getMessage() ); s`C#=l4  
XT>e/x9'  
return SKIP_BODY; TuIeaH%x  
b_V)]>v+  
} wgLS9.  
RfN5X}&A  
} 1Od: I}@  
Btpx[T  
}E>2U/wpXY  
body-content元素 5 F^,7A4I0  
q>Px   
iCAd7=o  
由于tag可能会有body,你必须用body-content元素来指定body内容的类型: C+5^[V  
Syp|s3u;  
<body-content>JSP|tagdependent</body-content> "%f>/k;!h.  
KN}[N+V>  
JB%6G|Z  
如果body的内容是定制的或内部的tag、脚本元素、或HTML广本,则归类为JSP类型。其他的类型,比如上面代码所述的?D?D将sql statement类传给 query tag的这种类型应该标为tagdependent。 G#dpSNV3|  
GmAE!+"  
注意:实际上body-content的值并不影响tag处理类对body内容的处理,它仅仅是被tag编辑工具用来描述此body的内容。 DMf^>{[  
9\Xl 3j!  
!\awT  
用tags定义脚本变量 G>:l(PW:  
c |C12b[  
}=f}@JlFB  
tag处理类 pQVi&(M  
r4D66tF  
Jr''S}@|x  
tag处理类负责创建或设置页面中定义的脚本变量,用pageContext.setAttribute(name,value,scope)或pageContext.setAttribute(name,value)方法来实现。一般来说,tag处理类通过脚本变量的名称来获取它,脚本变量的名称一般可用get方法来获得。 cK-!Evv  
2tWUBt\,g  
如果脚本变量的值依赖于tag处理类中的上下文中某一对象,那它可用pageContext.getAttribute(name,scope)方法来找到那个对象。一般的处理过程是tag处理类先找到脚本变量,再对其进行处理,然后用pageContext.setAttribute(name,object)的方法来设置它的新值。 ~Dy0HVE   
r<|\4zIo/  
对象的生存周期(scope)如下表: m};_\Db`  
}U^9(  
对象的生存周期表 c,D'Hl6(%  
H}U&=w'  
名字 b7>;UX  
可访问范围 >_F& oA#  
生存周期 t?0=;.D  
CJu;X[6  
page X&p-Ge1>z  
当前页面 Sl$dXB@  
一直有效,除非页面向客户提交响应或重定向到一个新页面 OOk53~2id  
uq 6T|Zm  
request O'wN4qb=F  
当前页面或当前页面重定向到的页面 lA]u8+gXd  
一直有效,除非页面向客户提交响应 pt0H*quwI  
V_ ]4UE  
session yRgo1ow]  
当前页面或在同一浏览器窗口中的页面 -8pHjry'q  
一直有效,除非关闭当前浏览器、超时、网络故障 p}Gk|Kjlq,  
\2+xMv)8  
application g{D&|qWj  
整个web应用程序的所有请求 V)a6H^l  
一直有效,除非发生网络故障、服务器故障 +s S*EvF  
M"_XaVl  
提供关于脚本变量的信息 5#fLGXP  
@DUdgPA  
以下示例定义了一个名为“book”的脚本变量,用来访问程序中关于书的信息: Maxnk3n  
QyN~Crwo  
<bean:define id=”book” name=”bookDB” property=”bookDetails” type=”database.BookDetails” /> ,F *e^#>  
C>MoR3]  
<font color=”red” size=”+2” > wR4P0 [  
BF_k~  
<%= messages.getString(“CartRemoved”) %> IIu3mXAw  
q2 f/#"k  
<strong><jsp:getProperty name=”book” property=”title” /></strong> nQP0<_S  
O%)9t FT  
</font> <r\)hx0ov  
21WqLgT3 4  
当包含此tag的JSP页面被编译时,jsp引擎会自动生成关于此book的同步的代码(同步可以避免几个客户同时访问此book时造成的冲突),要生成同步代码,jsp引擎需要知道此脚本变量的如下信息: xH f9N?  
g9 yCd(2<5  
· 脚本变量名称 KC]Jbm{y  
%-*vlNC)  
· 脚本变量所属的类 &6:,2W&s  
KW;xlJz(j  
· 此脚本变量是否引用了一个新的或已存在的对象 ^twv0>vEo  
|knP  
· 此脚本变量的有效性 q#778  
b:3hKW  
有两种办法可以向jsp引擎提供关于脚本变量的信息:在TLD中定义variable子元素,或用tei-class子元素定义一个额外tag信息类。用variable最简单,但可能降低了一些灵活性。 H@3+K$|v  
*.+>ur?t  
Variable元素 p/5!a~1'xN  
z84W{! P  
Variable元素有如下子元素: i&3 0n#  
C0fA3y72  
· name-given ?D?D 给出的名字,是一个常量 XVLuhw i  
n=SZ8Rj7  
· name-from-attribute?D?D 属性名,在编译时给出的属性名 lcP@5ZW  
87Uv+((H  
name-given或name-from-attribute两者必须选一,但以下子元素是可选的: B~aOs>1 S]  
2(rZ@Wl  
· variable-class?D?D变量的类型,缺省为java.lang.String。 -#o+x Jj  
6f>l~$  
· declare?D?D此脚本变量是否引用了一个新对象,缺省为True。 }ri*e2y)  
LAKZAi%O0  
· scope?D?D脚本变量的范围,缺省为NESTED。下表描述了scope的几种类型: X|QCa@Foe  
qN0#=X  
脚本变量的有效范围 pkU e|V  
wW<"l"x,  
Wu4Nq+  
有效性 PVU"oz&T  
方法 i]-gO  
uy9B8&Sr  
NESTED <D dHP  
在tag标签的开始和结束之间 {l11WiqQH  
如果tag处理类实现BodyTag接口,则在doInitBody和doAfterBody中调用,否则在doStartTag中调用 Vtg/,1KQ  
w.Vynb  
AT_BEGIN :I'Ezxv|  
从tag标签的开始一直到页面结束 (rG1_lUDu  
如果tag处理类实现BodyTag接口,则在doInitBody、doAfterBody和doEndTag中调用,否则在doStartTag和doEndTag中调用 {^kG<v.vV  
%1@<),  
AT_END Q kZM(pG  
从tag标签的结束一直到页面结束 5An0D V5  
在doEndTag中调用 i@CMPz-h&  
$i@EfujY  
以struts为例,它的bean:define标签的实现遵循JSP1.1规范,此规范要求使用额外tag信息类来定义脚本变量。Variable元素是JSP1.2规范中加入的。以bean:define标签为例,你可以定义如下variable元素: Tb= {g;0 @  
y9L#@   
<tag> ;F""}wzn  
tv OAN|+F  
<variable> 9f^PR|F  
|3,V%>z  
<name-from-attribute>id</name-from-attribute> 7ILa H|eN  
KY`96~z  
<variable-class>database.BookDetails</variable-class> MH.,s@  
B -~&6D,  
<declare>true</declare> VDKS_n  
Z&w^9;30P  
<scope>AT_BEGIN</scope> iHn!KV  
NoO+xLHw8  
</variable> >NRz*h#  
)6Q0f  
</tag> @sHw+to|p)  
n+qVT4o  
额外tag信息类 vNt>ESPB  
K) `:v|d  
如果要定义一个额外tag信息类,你要继承javax.servlet.jsp.TagExtraInfo类。一个TagExtraInfo类必须实现getVariableInfo方法,此方法返回一个叫VariableInfo的数组类,它包括如下信息: | NU0tct^  
bjBeiKH  
· 变量名 pRwGv  
K`,d$  
· 变量所属类名 &@HNz6KO  
^dnz=FB  
· 此变量是否引用了一个新对象 ) , ]2`w&k  
r^A#[-VyNP  
· 此变量的有效范围 '95E;RV&  
Yc82vSG'  
jsp引擎将一个名为data的参数传给getVariableInfo方法,data中包括tag标签中的所有“属性名?D?D属性值”对。它可以用来向VariableInfo对象提供脚本变量的名字和类名。 K@P`_yxN  
N 2"3~  #  
以struts为例,它在bean:define标签中定义了一个名为DefineTei的额外tag信息类,用来向脚本变量提供信息。由于脚本变量的名称(book)和类名(database.BookDetails)是通过tag标签的属性来传递的,它们一般定义在VariableInfo的构建代码中,并且可用data.getAttributeString方法来得到这些信息。如果要允许book脚本变量能在从tag开始直到整个JSP页面结束的范围内都可用的话,那它的范围应设为AT_BEGIN。如下所示: _ML~c&9jv  
,![Du::1  
V`\f+Uu  
public class DefineTei extends TagExtraInfo hO/5>Zv?  
v0C;j (2zb  
{ lW$&fuDHF  
^+as\  
public VariableInfo[] getVariableInfo(TagData data) D*cyFAF  
28R>>C=R  
{ Dk`4bYK  
'}Wu3X  
String type = data.getAttributeString(“type”); GwQZf|  
lU $4NU wM  
If( type == null) ``$%L=_m  
H=&/Q  
type = “java.lang.Object”; vK6ibl0  
ojx'g8yO  
return new VariableInfo[] { {jhmp\PN  
^m_^  
new VariableInfo(data.getAttributeString(“id”), `~ _H=l9{  
I f3{E  
type, -XVEV  
<!~1{`n%9J  
true, c6,s+^^  
G#e9$!  
VariableInfo.AT_BEGIN) UZje>. ~?  
d&|z=%9xl  
}; _ktK+8*6`  
%j'G.*TD  
} 2W3NL|P  
_8Nw D_"  
} kmlG3hOR,  
0]T.Lh$3  
k0|`y U  
注意:关于额外tag信息类的类名必须要在TLD中的tag标签下的tei-class子元素中定义。因此,DefineTei的tei-class中的定义看起来如下: F qeV3 N  
<tei-class> A%Bgp?B  
org.apache.struts.taglib.bean.DefineTagTei s\'y-UITi1  
</tei-class> khU6*`lQ  
zoZ<)x=;  
C.J`8@a]?  
具有协作关系的tag ~;M)qR?]W  
rv9B}%e  
T'ED$}N>~  
tag通过共享对象来进行协作,JSP技术支持2种方式的对象共享。 FXP6zHsV  
"]VDY)  
第一种方法是使用pageContext对象进行对象的共享(可支持JSP页面和tag处理类之间的共享),如果在一个tag处理类中要调用由另一个tag处理类创建的对象,可调用pageContext.getAttribute(name, scope)方法。 @$qOW  
aUH\Ee^M:R  
第二各方式的共享是对于tag之间有嵌套关系而言的,外层的tag所创建的对象对于内层的tag来说是可以共用的。这种形式的共享的好处是减少了可能存在的重名冲突。 sl/=g   
GX4QaT%  
要访问一个嵌套tag创建的对象,tag处理类必须先找到此嵌套tag对象,可用TagSupport的静态方法 TagSupport.findAncestorWithClass(from, class)或TagSupport.getParent方法。前者在当不确定此tag是否为嵌套tag对象时使用。一旦它的父类被找到,它就能访问其所有动态或静态创建的对象。静态创建的对象是父类的成员,而动态创建的对象可能是父类的私有对象。诸如此类的对象可以用tag处理类的setValue方法来保存,用getValue方法来获得。 Y^52~[w~  
NO-k-  
下例阐述了以上两种共享对象的方法。在这个例子当中,一个查询tag检查一个名为connection的属性名是否在doStartTag中被设置。如果connection属性被设置,tag处理类从pageContext中得到这个connection对象。否则,此tag处理类先找到它的父tag处理类,然后从它的父tag处理类中找到connection对象。 I eG=J4:*  
r&}(9Cq&"y  
I2f?xJ2/Z  
public class QueryTag extends BodyTagSupport j-7u>s-l  
Kv(z4z  
{ .VT;H1#  
\K}-I  
private String connectionId; ?4XnEDA m  
9O;cJ)tXY  
public int doStartTag() throws JspException V=pMq?Nr  
p SHSgd ~&  
{ .%=V">R  
f-;$0mTQ  
String cid = getConnection(); ! Tx&vtq  
U{6oLqwq3Y  
if(cid != null) 33Jd!orXU  
@@I7$*  
{ HPrq1QpK  
uG!:Z6%p  
//存在一个connection id,使用它。 {7*>Cv}  
#05jC6  
connection = (Connection) pageContext.getAttribute(cid); j^flwk  
{_?rh,9q  
} 'JieIKu  
? B@&#E!/f  
else rcV-_+KE(B  
='Q{R*u  
{ ~ 3^='o  
Mp~y0e  
ConnectionTag ancestorTag = (ConnectionTag)findAncestorWithClass(this, ?38lHn`FyQ  
* z'8j  
ConnectionTag.class); -w1@!Sdd  
*O,H5lwU  
if(ancestorTag == null) Y34/+Fi  
}Ov ^GYnn  
{ r> k-KdS  
|?d#eQ9a  
throw new JspTagException(“一个没有connection属性的查询标签必须被一个connection标记嵌套。”); <A >)[u  
{ox2Tg?  
} Qck| #tc  
.f:n\eT):  
connection = ancestorTag.getConnection(); V8WFQdXc  
aZ Xmlq  
} ~gE:-  
'OkGReKt  
} lhH`dG D  
z0%\OhuCcf  
} \(~wZd  
r@U3sO#N  
hB9Ee@  
3*ixlO:qGk  
此查询标签在JSP页面中的调用形式可以从以下2种定义中任选一种: zce`\ /:  
a(IY\q[Wh  
HDVW0QaMu  
<tt:connection id=”con01” ...> ... </tt:connection> #>[a{<;Kn  
&Lm-()wb  
<tt:query id=”balances” connection=”con01” > ^03j8Pc-c  
2 PqS%`XiS  
SELECT account, balance FROM acct_table 59r_#(uo  
vxFTen{-F  
where customer_num = <%= request.getCustno() %> Bc7V)Y K  
mYxyWB  
</tt:query> P 1XK*GZ  
H 3@Z.D  
B9R(&<4  
Rk6deI]  
0NDftcB]  
<tt:connection ...> =,y |00l  
dS2G}L^L  
<x:query id=”balances”> /E;y,o75  
^3VR-u<O  
SELECT account, balance FROM acct_table XV3C`:b  
B* kcN lW  
where customer_num = <%= request.getCustno() %> VhL{'w7f  
rxn Frx  
</x:query> H}hFFI)#Oo  
_VE^/;$"l  
</tt:connection> Tm}rH]F&  
{n#k,b&9B  
S$TmZk=  
与此同时,在TLD中必须指定connection属性为可选的,定义如下: Fm\"{)V:b  
uvDzKMw~R  
<tag> {7u[1[L1  
c 'uhK8|  
... Snp|!e  
l^GP3S  
<attribute> ]aP= Ks%  
<+MyZM(z>  
<name>connection</name> :y*NM,s  
j /=i Mq  
<required>false</required> De7T s  
_Zk{!  
</attribute> O[tvR:Nh  
1b=lpw 1}  
</tag>
描述
快速回复

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