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

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

级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记! \nxt\KD  
K90Zf  
一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。 oMMU5sm  
m41n5T`  
在这篇文章中,我们主要讨论: ""WZpaw  
AvV.faa  
· 什么是自定义tag标签? 1bj75/i<6  
1U"Y'y2  
· 怎么使用tag标签? !' sDqBZ&7  
-@J;FjrXmP  
o 声明要使用的tag库 *O 0*  
)k7`!@ID  
o 找到与之对应的tag处理类 & 6}vvgz  
BY \p?79  
o tag标签的类型 ?58pkg J  
CQtd%'rt6  
· 自定义tag标签 4Nq n47|>e  
y8<,>  
o tag处理类 Wm3H6o*  
{z.}u5N  
o tag库描述 MuO>O97  
;W+.]_$6)T  
o tag标签示例 gXH89n  
{[Yv@CpN  
o 带属性的tag X.272q<.  
qt;6CzL C  
o 带body的tag H_*]Vg  
f-{[ushj  
o 定义了脚本变量的tag IndNR:"g  
Rj E,Wn  
o 具有协作关系的tag =#+Z KD  
1eb1Lvn  
· 自定义tag标签 aMz%H|/$  
".w*_1G7U  
o 一个迭代tag的例子 *`l>1)B>  
UT^t7MY#O  
o 一个模板tag库 3'.OghI  
Dri1A%  
o tag处理类到底是怎样被调用的? txL5' mK  
oY0*T9vv+  
 |u$AzI  
什么是自定义的tag? ueWG/`ig  
%[p[F~Z^Z  
一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。 c6lEWC:  
&.4lhfI+(Q  
自定义tag标签有很多特色,诸如: (bT\HW%m  
>ueJ+sgH  
· 可以在JSP页面中自定义tag标签的属性 *#2`b%qh\M  
q_ 5xsTlTR  
· 访问JSP页面中的所有对象 q2hZ1o  
x b_C1n  
· 可以动态地修改页面输出 :+R ||q i  
:*oI"U*f  
· 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。 A: @=?(lI3  
W)9KYI9u  
· tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。 {) .=G  
@9c^{x\4  
Ok*:;G@  
使用tag标签 PGw"\-F  
WV&BZ:H  
}%jb/@~  
本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。 }_gq vgI>p  
s]2k@3|e  
要使用tag标签,JSP程序员必须做2件事: + S%+Ku  
+h9CcBd  
· 声明此tag标签的tag库 ,,G0}N@7s  
|]`+@K,S  
· 实现此tag标签 {fGi:b\[ 8  
sJ0y3)PQ  
声明tag标签所在的tag库 # =322bnO  
^qk$W? pX  
如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明) \T[*|"RFZ  
chiQ+  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> c9'#G>&h~^  
/Fv1Z=:r  
uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。 glv(`cQ  
| z('yy$  
TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。 'Lm.`U  
$9l3 DJ  
以下taglib指示符直接引用一个TLD: hyTi':  
p jrA:;  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> G A7  
VvltVYOZA  
以下的taglib指示符通过一个逻辑名称间接地引用一个TLD: B\("08x  
dj]sr!q+  
<%@ taglib uri=”/tutorial-template” prefix=”tt” %> Nf;vUYP  
m|-O/6~  
如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素: %ZQl.''ISa  
6dinC <[}  
<taglib> E?FPxs  
@*c+`5)_  
<taglib-uri>/tutorial-template</taglib-uri> x[>A'.m@)  
8XY4  
<taglib-location> Q% dpGI  
(Bmjz*%M  
/WEB-INF/tutorial-template.tld )v|a:'%K_  
De^is^{  
</taglib-location> #~#_) \l'F  
Cw+ (,1  
</taglib> 4 bJ3uIP#  
$h$+EE!  
(te \!$  
实现此tag标签 nrf%/L  
j$L<9(DoR  
xw=B4u'z  
为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。 A2+t`[ w  
6}|vfw  
jV7q)\uu^  
tag标签类型 ^QnVYTM  
+0=RC^   
F.\]Hqq  
自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点): C&;'Pw9H  
F^a D!O ~  
<tt:tag> 5Pr<%}[S^  
9Qkww&VEk  
body JEP"2MN,  
iF 67  
</tt:tag> N..u<06j/  
Y8AU<M  
%V+,#  
一个不带body的tag标签如下: k?";$C}#  
-(59F  
<tt:tag /> _WSJg1  
X0U6:  
M P3E]T~:  
简单的tag标签 JTb<uC  
ct]5\g?U'  
一个没有body和属性的tag标签如下: =9)ypI-2  
4+W}TKw  
<tt:simple /> V3`*LU  
Onc!5L  
@.g4?c  
带属性的tag标签 SOUA,4  
d+IPa<N  
l s_i)X  
自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。 ;wN.RPE_^  
R]r~TJ o  
你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值: 2HTZ, W  
B;-oa;m:E=  
<loglic:present parameter = “Clear”> '<Vvv^Er  
6 =kd4'yV  
而另一个标签logic:iterate是用表达式来给属性赋值: ]c5Shj5|p  
;N j5NB7  
<logci:iterate collection=”<%= bookDB.getBooks() %>” 2+^#<Uok  
&=/.$i-w$  
id=”book” type=”database.BookDetails”> 5(F!* 6i>  
kPxEGuL'  
z^oi15D|{  
带body的tag标签 .CYq+^  
{-E{.7  
一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。 \(z)]D  
4s"HO/  
在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息: O-G@To3\  
Fj5^_2MU:  
<logic:present parameter=”Clear”> eIEcj<f  
lS,Hr3Lz  
<% cart.clear(); %> c '(]n]a%  
J L Z  
<font color=”#ff0000” size=”+2”><strong> \Js9U|lY  
 /!9949XV  
你选择了清除购物车! t=pG6U  
#uH1!UQb  
</strong></font> i@p?.%K{  
{:rU5 !n  
</logic:present> ogPfz/ hw  
oZ=e/\[K  
G>!"XK:fB  
到底是用属性还是用body来传递信息? J:Qp(s-N^:  
7f(UbO@BD  
如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。 QvqBT  
~+d]yeDrhx  
ybB}|4d&   
定义脚本变量的tag标签 IGp-`%9  
:2?'mKa7  
所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等: !^N/n5eoz  
!#X^nlc  
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” /> 6^wiEnA  
!",@,$  
<% tx.begin(); %>  CZuxH  
7i'vAOnw^  
... +I/P5OGRN  
aE;!mod  
&d*9#?9  
具有协作关系的tag标签 k!%HcU%J  
xWlB!r<}Gz  
自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。 ]]]7"a  
-x RsYYw  
<tt:tag1 attr1=”obj1” value1=”value” /> UIyOn` d"  
|M0TG  
<tt:tag2 attr1=”obj1” /> c#rbyx?5  
`t8e2?GH  
在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。 6qw_|A&g  
[Y:HVr,  
<tt:outerTag> - -]\z*x  
~#-`Qh  
<tt:innerTag /> 5}By2Tx  
K@d`jb4T  
</tt:outerTag> ElYHA  
fG.w;Aemv5  
jb*#!m.l  
Tag处理类 HPgMVp'  
WUxr@0  
-7yX>Hjl  
Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。 :<jf}[w!  
J6Kf z~%  
当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。 D@3|nS  
hqE#BnQxP,  
下表说明不同类型的tag所需要不同的处理过程: co12\,aD  
69L s"e  
Tag处理类的方法 QKF2_Acc   
yn=1b:kid  
Tag标签类型 fW\u*dMMZE  
所调用的方法 5Q^~Z},  
Q647a}  
基本标签 }x8fXdd  
doStartTag, doEndTag, release 6Z'zB&hM}  
p;'vOb  
带属性的标签 )WzCUYE1/  
doStartTag, doEndTag, set/getAttribute1...N, release qVY\5`f@  
w68qyG|wM  
带内容的标签 wbpxJtJB  
doStartTag, doEndTag, release tC&y3!k2jR  
X)|%[aX}q  
带内容的标签,且内容重复循环 o3`Z@-.G  
doStartTag, doAfterBody, doEndTag, release 5jV]{ZV#  
T xN5K`q  
带内容的标签,且内容与JSP交互 (+ >n/I6  
doStartTag, doEndTag, release, doInitBody, doAfterBody, release 7eq;dNB@gq  
. XY'l  
一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。 Oq.) 8E.  
E+>;tLw3j  
如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。 C= Zuy^  
Nd0Wt4=  
一般情况都将所有的tag处理类打成了JAR的包,以便于发布。 FKzqJwT  
}\irr9,  
y"]> Rr  
Tag库描述(简称TLD) U%#=d@?  
(z.Vwl5  
2ru6 bIb;  
Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。 Ex Qld  
j9qN!.~mM  
TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。 b/G0EcRw+  
s}A]lY  
一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如: ,iHt*SZ,*  
g>Z1ZK0;M  
<?xml version="1.0" encoding="ISO-8859-1" ?> XrvrN^'  
LD5'4,%-  
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> <.AIV p  
TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表: 4C2 D wj  
WH/a#F  
?^7~|?v  
<taglib>的子元素 D~ {)\;w^!  
BE U[M  
Element 1"k +K~:  
Description w8on3f;6n#  
UC0 yrV  
tlib-version O-|3k$'\z  
Tag库的版本 ~q9RZ#g13J  
m760K*:i\  
jsp-version T&h|sa(   
Tag库所需要的jsp的版本 q8p 'bibY  
FqiK}K.~/  
short-name J) (pGS@  
助记符,tag的一个别名(可选)  Ne4A  
^.4<#Qs  
uri NfSe(rd  
用于确定一个唯一的tag库 D?E5p.!A  
Wl,yznT  
display-name S }|ea2  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) a( qw  
3)7'dM  
small-icon 1n,JynJ  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选)  "3v%|  
d,>l;l  
large-icon V2bod=&Lc  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) E6US  
zL{KK9Or  
description x^ Wgo`v)  
对tag库的描述(可选) ~jPe9  
=*'` \}];"  
listener F8k1fmM]Y  
参见下面listener元素 isN"7y|r:X  
FYi<+]HZ  
tag -8TLnl~[  
参见下面tag 元素 Di L@NU!$q  
@tP,l$O&  
Listener元素 n b{8zo  
yf$7<gwX  
一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。 4f1*?HX&  
ND`~|6yb  
Tag元素 2vur _`c V  
oi!E v_h  
每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。 1]qhQd-u  
C{,nDa?|  
每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素: d9^h YS{  
`Ffn:=Do  
Tag元素的子元素 \t(/I=E8/  
xE}q(.]  
元素名称 R{WG>c  
描述 t & ucq Y  
B.{yf4a#L  
name :jhJp m1Xq  
独一无二的元素名 D4S>Pkv  
%++q+pa  
tag-class ;TR.UUT  
Tag标签对应的tag处理类 a7CJ~8-1K  
^ o{O5&i]  
tei-class w,P2_xk`  
javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选) :8rqTBa`  
/!LfEO  
body-content lKa}Bcd  
Tag标签body的类型 'Kq%t M26!  
mjw:Z,  
display-name `fL$t0 "  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) Ms$kL'/  
sQ_{zOUPh  
small-icon zi5;>Iv0}  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) TN0d fba[  
avT>0b:  
large-icon U_!6pqFc  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) {:? -)Xq  
=A,i9Z&  
description S |B7HS5  
此tag标签的描述 >Rr]e`3wG  
LsLsSV  
variable jKtbGVZ 7r  
提供脚本变量的信息(同tei-class)(可选) VfQSfNsi  
5ecqJ  
attribute uh GL1{  
Tag标签的属性名 k muF*0Bjk  
g.veHh|;_  
以下章节介绍对于不同类型的tag,如何具体地实现它们。 O/FQ'o1F  
KI# hII[Q.  
.-o$ IQsS  
简单的tag :_vf1>[  
R[9[lQ'vR  
5` Q#2  
tag处理类 }96^OQPE  
Q2+e`  
简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。 ,H|V\\  
1|Fukx<@J<  
以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下: 9iGJYMWf  
<8'}H`w%  
l.&6|   
public SimpleTag extends TagSupport 0uj3kr?cv  
k<AnTboa  
{ WyO10yvR  
k6$.pCH6  
public int doStartTag() throws JspException v_b%2;<1  
OpiN,>;  
{ **oN/5  
"EA%!P:d,  
try{ d^,u"Z9P  
UD .$C  
pageContext.getOut().print(“Hello.”); b2ZKhS8  
V RT| OUq  
}catch(Exception e){ |J8c|h<  
5I@< 6S&X  
throw new JspTagException(“SimpleTag: “ + e.getMessage()); vQ 5 p  
ZX'/[wAN)  
} 1YQ|KJ*K  
>8QLo8)3C  
return SKIP_BODY; t.3b\RV[  
l.FkX  
} $_NVy>\&  
@ UX'(W  
public int doEndTag() -MeGJX:^I  
{Z$Aw4a"d  
{ dMYDB  
-cOLg rmp  
return EVAL_PAGE; N5o jXX!l%  
0<fN<iR`  
} qA5tMZ^w  
RtN5\  
} ^ @sg{_.~l  
=%p0r z|b  
<&Y7Q[  
注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如 eR =P  
Hh,q)(Wo  
<body-content>empty</body-content> ]^E<e!z={$  
g&X$)V4C  
YGNO]Q~A  
带属性的tag标签
评价一下你浏览此帖子的感受

精彩

感动

搞笑

开心

愤怒

无聊

灌水
级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
只看该作者 1 发表于: 2007-01-01
tag处理类 KHI-m9(  
r_F\]68  
对于tag标签的每个属性,你必须依照JavaBeans规范来定义其属性,以及get和set方法。以struts的logic:present 标签为例, COZ<^*=A#p  
;&oS=6$  
<logic:present parameter=”Clear”> P|l62!m<   
I^emH+!MW  
与此相应,此tag处理类应有如下方法和定义: j!F5gP-l  
[}|x@ v9  
!Qy%sY  
protected String parameter = null; nd}[X[ay  
w9G (^jS6  
public String getParameter() `$Z:j;F  
C%vR!Az  
{ % tTL  
Q9Sh2qF^2  
return this.parameter; Y({&} \o  
xk7 MMRb  
} [vrM,?X  
;=fOyg  
public void setParameter(String parameter) I<Wp,E9G#  
Op0n.\>  
{ p(=}Qqdr8  
yb\T< *  
this.parameter = parameter; sIJl9  
dG2k4 O  
} 2<q>]G-nN  
=^\yE"a  
H,u{zU')  
注意:如果你的属性名为id,而且你的tag处理类是从TagSupport类继承的,那你就不需要定义它的属性和set和get方法,因为他们早已在TagSupport被定义过了。 ?0*,x)t  
&{-r 5d23  
Attribute元素 zk#"n&u0  
r~nD%H:}P  
对于tag标签的每个属性,你必须定义它是否必须的,它的值是否可以用诸如<%= …%>的表达式来获得,以及它的类型(可选),如果不指定它的类型,那就默认为是java.lang.String类型。如果rtexprvalue元素被定义为true或yes,那么在type元素中就定义了attribute的返回类型。 `tw[{Wb  
B:J([@\'  
<attribute> <Nwqt[.  
JFewOt3  
<name>attr1</name> Vsw] v  
C9OEB6  
<required>true|false|yes|no</required> e ?sMOBPlv  
Y7vUdCj  
<rtexprvalue>true|false|yes|no</rtexprvalue> MVP|l_2!  
_Wg?H:\  
<type>attribute的返回类型(只用当rtexprvalue为真是才有效)</type> v#c'p^T  
Td(eNe_4T  
</attribute> X$BN &DD  
= p{55dR  
如果tag的某个属性不是必须的,那tag处理类会自动提供一个缺省值。 Pu>jECcz  
>>bsr#aJ  
例如,在logic:present这个tag标签中定义了一个属性叫parameter,但它不是必须的,而且它可以被诸如<%= …%>的表达式来赋值。 +-2o b90_m  
: 8h\x  
<tag> B8.a#@R  
&YpViC4K.  
<name>present</name> &rs   
( f]@lNmx  
<tag-class>org.apache.struts.taglib.logic.PresentTag</tag-class> Jui:Ms  
}$%j}F{  
<body-content>JSP</body-content> J'}G~rB<<  
~?#>QN\\c  
F \0>/  
n#$sLXVy  
<attribute> 5ir Ffr  
)SU\s+"M  
<name>parameter</name> ] MP*5U>;  
. ,h>2;f  
<required>false</required> f.)z_RyGd  
Jt ++3]  
<rtexprvalue>true</rtexprvalue> -d>2&)5  
`)y<X#[8  
</attribute> 00SYNG!  
>^:*x_a9  
WoV"&9y  
Z=ZTSl   
</tag> {'#1do}{  
H2kib4^i  
`D-P}hDm!  
属性元素的校验 2JdzeJb  
\rj>T6  
d6^:lbj  
有关于tag标签的有效值可以从tag库的说明文档中获得,当JSP页面被编译时,jsp引擎会强制性地参照TLD中定义的规则进行检查。 eR3v=Q  
k I?+\k\V`  
还有一个方法也可以进行属性元素的校验,就是先继承类TagExtraInfo,然后调用它的isValid方法。这个类同时也起到提供tag中定义的脚本变量信息的作用。 u*}ltR~/  
atiyQuT6Wh  
IsValid方法通过TagData对象来传递属性信息,它包括着tag的所有的属性名-值的信息。由于校验发生在运行时刻,因此这个属性的值将被赋值为TagData.REQUEST_TIME_VALUE。 h*>%ou   
/O[<"Wcz  
例如tag标签<tt:twa attr1=”value1” />在TLD中定义如下: \+M6R<Qw  
o|kiwr}Y  
<attribute> yE&WGpT  
-.@dA'j[  
<name>attr1</name> /PZx['g  
 Zh  
<required>true</required> g ?.y7!m  
]SC|%B_*  
<rtexprvalue>true</rtexprvalue> R?t_tmKXC!  
<uYrYqN  
</attribute> 4%B0H>  
#Z. QMWq  
&=^YN"=Z  
这个定义说明了attr1能在运行期间被赋值。 pKtN$Fd  
J8'1 ~$6  
以下的isValid方法检查attr1属性的值是否属于Boolean类型。注意由于attr1能在运行刻被赋值,那么isValid方法必须检查tag用户是否对此tag进行了运行时刻赋值。 ?kIyo  
"hmLe(jo}  
'@/1e\-y  
Public class TwaTEI extends TagExtraInfo K<rv|bJ  
'Z*`~,Q  
{ WKAG)4  
;9CbioO  
public boolean isValid(Tagdata data) a,|Hn  
I q?n*P$  
{ 9])Id;+91  
,<=gPs;x  
Object o = data.getAttribute(“attr1”); )2 lB  
$l $p|  
If(o != null && o != TagData.REQUEST_TIME_VALUE) t zShds  
:5sjF:@  
{ g#k@R'7E  
2YDD`:R  
if( ( (String)o).toLowerCase().equals(“true”) || x2,;ar\D  
h2-v.Tjf  
((String)o).toLowerCase().equals(“false”) ) h#p[6}D  
(|\%)v H-  
return true; C$0rl74Wi  
2qdc$I&$  
else sYhHh$mwA  
O _ C<h  
return false; ,\?s=D{  
6gabnW3  
} v2IcDz`}7  
CcTdLq  
else :7M%/#Fy  
Q45gC28x  
return true; QQ`tSYgex  
m@Dra2Cv'@  
} o~<jayqU  
D<hX%VJ%M  
} TMGYNb%<bX  
ihJ!]#Fbm  
ch2m Ei(  
带body的tag {)iiu  
Im?/#tX  
k8\ KCKql  
tag处理类 3@nIoN'z  
Q<NQ9lX  
]4ck)zlv   
如果tag标签含有内容,那处理方式会略微有些不同,而且还要视tag处理类是否要与body交互的情况而定。如果要与body交互,那我们认为tag处理类要可能要对body进行操作。 x<`^4|<  
Y<IuwS  
Tag处理类不与body交互 Ee_?aG e&  
/6rQ.+|).  
如果tag处理类不与body交互,tag处理类应该实现Tag接口或从TagSupport中派生,如果body要被计算,那么doStartTag方法应返回 EVAL_BODY_INCLUDE,否则应返回SKIP_BODY。 h<V,0sZ&:  
o|u4C{j  
如果tag处理类要对body反复运算,则它应该实现IterationTag或从TagSupport中派生。如果tag处理类认为body还未计算完的话,那它的doStartTag方法和doAfterBody方法必须返回EVAL_BODY_AGAIN。 G1-r$7\  
T6b~uE  
Tag处理类与body交互 F Uz1P  
nuDu  
如果tag处理类与body交互,那tag处理类应实现BodyTag接口或从BodyTagSupport中派生。这种tag处理类一般要实现doInitBody和doAfterBody方法。 u -)ED  
$EHF f$M  
Body允许一些方法来读写它的内容。Tag处理类可以调用body内容的getString或getReader方法来从body中提取信息,也可用 writeOut(out) 方法来将body的内容写入到out对象中。其中out对象通过tag处理类的getPreviousOut方法来获得。 ub!l Hl  
.820~b0  
如果body的内容需要被计算,那么doStartTag方法必须返回EVAL_BODY_BUFFERED,否则,它将返回 SKIP_BODY。 tU$n3Bg  
*<:6A&'D9  
doInitBody 方法 /0cm7[a?  
zB`J+r;LU  
此方法在body内容已经设好,但未被计算之前被调用。你可以根据不同的body内容来制定初始化策略。 pP#D*hiP-g  
W\($LD"X  
doAfterBody方法 Yecdw'BW?  
{sxdDl  
此方法在body内容已被计算后进行调用。 2}7_Y6RS*  
_k : BY  
和doStartTag方法一样,doAfterBody方法返回一个指示符指示是否要继续计算body,如果要继续计算,则doAfterBody应返回EVAL_BODY_BUFFERED,否则,它应返回SKIP_BODY。 '4 It>50b  
ePZ Ai"k  
release 方法 'gXD?ARW  
]&;In,z  
tag处理类调用此方法将它的状态重置为初始状态,并释放所有的私有资源。 TQ:h[6v  
0i"2s}^+_  
{\`y)k 7  
以下的例子读取body的内容(其中含有一条sql语句),然后将它传递给一个对象,让它进行查询。由于此处body不须重新计算,所以doAfterBody会返回SKIP_BODY。 uF|Up]Z G  
kOdA8X RY  
"N ">RjJ"  
Public class QueryTag extends BodyTagSupport !4!qHJISa  
mZXtHFMu  
{ </Y(4Xwf=  
ps?su`  
public int doAfterBody() throws JspTagException ~%lA! tsek  
m,"-/)  
{  }D+ b`,  
s?s ,wdp  
BodyContent bc = getBodyContent(); $9j>oUG  
BW6Ox=sr<  
//将body的内容以字符串的格式提取出来 ?(U;T!n  
JU;`c>8=)  
String query = bc.getString(); @ ;@~=w  
-T;^T1  
//清除body Q=>5@sZB  
3M(*q4A$"  
bc.clearBody(); YD@Z}NE v"  
F Z RnIg  
try{ u  Fw1%  
XZ{rKf2  
Statement stmt = connection.createStatement(); CJh,-w{wJ"  
8ki3>"!A  
Result result = stmt.executeQuery(query); mR|5$1[b  
4!OGNr$V@  
}catch(SQLException e){ pEz^z9  
WtKKdL  
throw new JspTagException(“queryTag: “ + e.getMessage() ); w N`Nj m9!  
FfxD=\  
return SKIP_BODY; &SPY'GQ!  
)t3`O$J  
} C-)d@LWI  
PH&Qw2(Sx  
} TDbSK&w :s  
>itNa.K  
;~L,Aqn7  
body-content元素 5073Q~  
6$:Q]zR#'H  
h)fsLzn]Tf  
由于tag可能会有body,你必须用body-content元素来指定body内容的类型: x#&_/oqAk  
(J.Z+s$:2  
<body-content>JSP|tagdependent</body-content> pZK 1G  
 [B`4I  
]cv|dc=  
如果body的内容是定制的或内部的tag、脚本元素、或HTML广本,则归类为JSP类型。其他的类型,比如上面代码所述的?D?D将sql statement类传给 query tag的这种类型应该标为tagdependent。 B6;>V`!  
&o7PB` (l  
注意:实际上body-content的值并不影响tag处理类对body内容的处理,它仅仅是被tag编辑工具用来描述此body的内容。 (3$DUvx7  
^fe,A=k~1  
_68vSYr  
用tags定义脚本变量 XkkzY5rxOc  
!;mn]wR>a  
TmftEw>u  
tag处理类 z;P#  
F!g1.49""  
rNJU & .]  
tag处理类负责创建或设置页面中定义的脚本变量,用pageContext.setAttribute(name,value,scope)或pageContext.setAttribute(name,value)方法来实现。一般来说,tag处理类通过脚本变量的名称来获取它,脚本变量的名称一般可用get方法来获得。 o~e_M-  
]T|$nwQ  
如果脚本变量的值依赖于tag处理类中的上下文中某一对象,那它可用pageContext.getAttribute(name,scope)方法来找到那个对象。一般的处理过程是tag处理类先找到脚本变量,再对其进行处理,然后用pageContext.setAttribute(name,object)的方法来设置它的新值。 ;-JFb$m  
!ht2*8$lQ  
对象的生存周期(scope)如下表: Wu<;QY($5  
@k)J i!7  
对象的生存周期表 P7zUf  
u?fM.=/N  
名字 Dq<DW2It>  
可访问范围 ?H,f|nc  
生存周期 vf@j d}?  
1$.svR  
page ||*F. p  
当前页面 wu eDedz\  
一直有效,除非页面向客户提交响应或重定向到一个新页面 l'_]0%o]  
IDJ2epW*;  
request ^X+qut+~  
当前页面或当前页面重定向到的页面 [e ztu9  
一直有效,除非页面向客户提交响应 *P9"1K +  
,wM}h  
session Vt3*~Beb  
当前页面或在同一浏览器窗口中的页面 ?wlRHVZ  
一直有效,除非关闭当前浏览器、超时、网络故障 yQ[;.<%v  
9XtO#!+48  
application -`{W~yz  
整个web应用程序的所有请求 h!JyFc  
一直有效,除非发生网络故障、服务器故障 _EP]|DTfr  
~Gmt,l! b  
提供关于脚本变量的信息 82ixv<B  
o6;  
以下示例定义了一个名为“book”的脚本变量,用来访问程序中关于书的信息: Z2yO /$<  
4H,c;g=!  
<bean:define id=”book” name=”bookDB” property=”bookDetails” type=”database.BookDetails” /> :L+ xEL  
Rc{R^5B  
<font color=”red” size=”+2” > zj] g^c;  
8<T~AU8'*  
<%= messages.getString(“CartRemoved”) %> sRZ<c  
F(."nUrf  
<strong><jsp:getProperty name=”book” property=”title” /></strong> _0gdt4  
,g}$u'A+d  
</font> "= %"@"<)  
=H23eOS_#  
当包含此tag的JSP页面被编译时,jsp引擎会自动生成关于此book的同步的代码(同步可以避免几个客户同时访问此book时造成的冲突),要生成同步代码,jsp引擎需要知道此脚本变量的如下信息: J ;z`bk^  
l3ogMRq@  
· 脚本变量名称 Kw;gQk~R!  
"0Z /|&  
· 脚本变量所属的类 =y@0i l+V  
$\vNST E  
· 此脚本变量是否引用了一个新的或已存在的对象 ,{S $&g*  
Rvu5#_P  
· 此脚本变量的有效性 %Rf9 KQ  
60{DR >S  
有两种办法可以向jsp引擎提供关于脚本变量的信息:在TLD中定义variable子元素,或用tei-class子元素定义一个额外tag信息类。用variable最简单,但可能降低了一些灵活性。 cf$ hIB)Oi  
csLbzDg  
Variable元素 1Dc6v57  
KMkD6g  
Variable元素有如下子元素: d9U)O6=  
kZF<~U  
· name-given ?D?D 给出的名字,是一个常量 CUG"2K9  
L[9Kh&c  
· name-from-attribute?D?D 属性名,在编译时给出的属性名 R31Z(vY  
Yb<:1?76L  
name-given或name-from-attribute两者必须选一,但以下子元素是可选的: { V(~  
"5k 6FV  
· variable-class?D?D变量的类型,缺省为java.lang.String。 o938!jML_  
\WTKw x  
· declare?D?D此脚本变量是否引用了一个新对象,缺省为True。 6@/k|t>OT  
7- LjBlH  
· scope?D?D脚本变量的范围,缺省为NESTED。下表描述了scope的几种类型: MG.c`t/w  
s+fxv(,"c  
脚本变量的有效范围 <yEApWd;  
7<)  
&xB9;v3  
有效性 xrBM`Bj0@  
方法 Kf[.@_TD<1  
j2IK\~W?-  
NESTED BI-'&kPk  
在tag标签的开始和结束之间 o[ks-C>jw  
如果tag处理类实现BodyTag接口,则在doInitBody和doAfterBody中调用,否则在doStartTag中调用 k*6"!J%A  
WvJ:yUb2  
AT_BEGIN b:~#;$g  
从tag标签的开始一直到页面结束 .'H$|"( v  
如果tag处理类实现BodyTag接口,则在doInitBody、doAfterBody和doEndTag中调用,否则在doStartTag和doEndTag中调用 }PBL  
[sk n9$  
AT_END ({C[RsY=6  
从tag标签的结束一直到页面结束 p.8  
在doEndTag中调用 # }}6JM  
xSM1b5=Pu  
以struts为例,它的bean:define标签的实现遵循JSP1.1规范,此规范要求使用额外tag信息类来定义脚本变量。Variable元素是JSP1.2规范中加入的。以bean:define标签为例,你可以定义如下variable元素: nj;3U^  
'a JE+  
<tag> c;"e&tW  
KFO K%vbM  
<variable> <Fx%P:d  
T{^mh(3/"  
<name-from-attribute>id</name-from-attribute> Qb)c>r  
~/JS_>e#6P  
<variable-class>database.BookDetails</variable-class> gfIS  
Z&iW1  
<declare>true</declare> pL[3,.@WA  
$G)HU6hF*  
<scope>AT_BEGIN</scope> *My9r.F5o  
d oEuKT  
</variable> yFmy  
o^(I+<el  
</tag> uK(]@H7~!c  
`^^t#sT   
额外tag信息类 2(~Zl\  
..nVViZ  
如果要定义一个额外tag信息类,你要继承javax.servlet.jsp.TagExtraInfo类。一个TagExtraInfo类必须实现getVariableInfo方法,此方法返回一个叫VariableInfo的数组类,它包括如下信息: wy:Gy9\  
'-N 5F  
· 变量名 3o>JJJ=]  
^W@8KB  
· 变量所属类名 ;P juO  
sxRKWM@4  
· 此变量是否引用了一个新对象 GJQ>VI2cY  
fDW:|%{Y,  
· 此变量的有效范围 ]ke9ipj]:  
d(V4;8a0  
jsp引擎将一个名为data的参数传给getVariableInfo方法,data中包括tag标签中的所有“属性名?D?D属性值”对。它可以用来向VariableInfo对象提供脚本变量的名字和类名。 Bnk<e  
*JFkqbf  
以struts为例,它在bean:define标签中定义了一个名为DefineTei的额外tag信息类,用来向脚本变量提供信息。由于脚本变量的名称(book)和类名(database.BookDetails)是通过tag标签的属性来传递的,它们一般定义在VariableInfo的构建代码中,并且可用data.getAttributeString方法来得到这些信息。如果要允许book脚本变量能在从tag开始直到整个JSP页面结束的范围内都可用的话,那它的范围应设为AT_BEGIN。如下所示: B-KMlHe  
`'XN2-M8  
O"o|8 l}M/  
public class DefineTei extends TagExtraInfo tl~ZuS/  
oidK_mU9q  
{ n!8W@qhew  
i4k [#x  
public VariableInfo[] getVariableInfo(TagData data) Btzes.  
8pr toCB  
{ 0`WFuFi^o  
$n!5JS@40  
String type = data.getAttributeString(“type”); z>,tP  
W(Sni[c{  
If( type == null) JtMl/h  
Hq<4G:#  
type = “java.lang.Object”; iQ2}*:Jc$  
RkF^V(  
return new VariableInfo[] { $*N(feAs  
a;IOL  
new VariableInfo(data.getAttributeString(“id”), NV(jp'i~  
$]};EI#  
type, SKNHLE}  
Rsq EAdZw[  
true, kjsj~jwvv  
- (((y)!  
VariableInfo.AT_BEGIN) k1yqe rA  
IOC$jab@  
}; `5Z'8^  
,38M6yD  
} 3$P  
}TZM@{;  
} "m6G;cv  
mDv<d=p!  
@f|~$$k=  
注意:关于额外tag信息类的类名必须要在TLD中的tag标签下的tei-class子元素中定义。因此,DefineTei的tei-class中的定义看起来如下: c C) <Y#1  
<tei-class> n<FUaR>q}  
org.apache.struts.taglib.bean.DefineTagTei G;wh).jG5  
</tei-class> N Czabl  
@@\px66  
 HRbv%  
具有协作关系的tag _!,2"dS  
XHKLl?-  
V"K.s2U^  
tag通过共享对象来进行协作,JSP技术支持2种方式的对象共享。 `DSFaBj,  
|unvDXx-  
第一种方法是使用pageContext对象进行对象的共享(可支持JSP页面和tag处理类之间的共享),如果在一个tag处理类中要调用由另一个tag处理类创建的对象,可调用pageContext.getAttribute(name, scope)方法。 ,/V~T<FI  
pnx^a}|px  
第二各方式的共享是对于tag之间有嵌套关系而言的,外层的tag所创建的对象对于内层的tag来说是可以共用的。这种形式的共享的好处是减少了可能存在的重名冲突。 adri02C/  
H<ovIMd  
要访问一个嵌套tag创建的对象,tag处理类必须先找到此嵌套tag对象,可用TagSupport的静态方法 TagSupport.findAncestorWithClass(from, class)或TagSupport.getParent方法。前者在当不确定此tag是否为嵌套tag对象时使用。一旦它的父类被找到,它就能访问其所有动态或静态创建的对象。静态创建的对象是父类的成员,而动态创建的对象可能是父类的私有对象。诸如此类的对象可以用tag处理类的setValue方法来保存,用getValue方法来获得。 IaRwPDj6  
F|!=]A<  
下例阐述了以上两种共享对象的方法。在这个例子当中,一个查询tag检查一个名为connection的属性名是否在doStartTag中被设置。如果connection属性被设置,tag处理类从pageContext中得到这个connection对象。否则,此tag处理类先找到它的父tag处理类,然后从它的父tag处理类中找到connection对象。 9mXmghoCO  
vyWx{ @  
ALO/{:l(  
public class QueryTag extends BodyTagSupport _D{FQRU<YD  
t(PA+~sIp  
{ }#E]efjs  
nwfu@h0G  
private String connectionId; 0(u}z  
d { P$}b  
public int doStartTag() throws JspException {0fQE@5@  
ZR|s]'  
{ :?z @T[-  
W]bytsl  
String cid = getConnection(); AEWrrE  
D(|+z-}M  
if(cid != null) 9+<A7PM1T  
q2`mu4B  
{ Ny`SE\B+/  
3@O/#CP+  
//存在一个connection id,使用它。 ~Hg*vCd ?  
@Q nKaZ8jW  
connection = (Connection) pageContext.getAttribute(cid); }LX!dDuwA  
e~># M $  
} ~X<$ l+5  
]Y->EME:W  
else :TKx>~`  
Uh1UZ r  
{ tp!eF"v=  
+G!# /u1  
ConnectionTag ancestorTag = (ConnectionTag)findAncestorWithClass(this, !J{[XT  
/?Y4C)G  
ConnectionTag.class); w&es N$2  
Mkt_pr  
if(ancestorTag == null) %M8Q6  
#a|r ^%D  
{ k'e1ZAn  
#^|2PFh5  
throw new JspTagException(“一个没有connection属性的查询标签必须被一个connection标记嵌套。”); N^F5J  
m@D :t 5  
} kDRxu!/  
wM;=^br  
connection = ancestorTag.getConnection(); gwB0/$!4"  
1_9Ka V  
} y9@j-m&  
5=9Eb  
} oL>o*/  
d%q&[<'jf  
} m`xYd  
"5N$u(: b  
4wEkxCWp/  
V5 9Vf[i|  
此查询标签在JSP页面中的调用形式可以从以下2种定义中任选一种: `s=Z{bw  
MX!N?k#KhP  
;<0~^,Xm  
<tt:connection id=”con01” ...> ... </tt:connection> #\xy,C'Y  
4v5qK  
<tt:query id=”balances” connection=”con01” > SjA'<ZX>TM  
4pcIH5)z  
SELECT account, balance FROM acct_table u~'_Uqp  
p R`nQM-D  
where customer_num = <%= request.getCustno() %> d:]ZFk_*  
T(cpU,Q  
</tt:query> ,PKUgL}w  
v-!Spf  
1Zo3K<*J  
U =g&c `  
0d~?|Nv -  
<tt:connection ...> e!C,<W&B\  
[{`&a#Q  
<x:query id=”balances”> jzi^ OI7  
Yyw3+3  
SELECT account, balance FROM acct_table j#p3<V S4  
23bTCp.d  
where customer_num = <%= request.getCustno() %> A~0yMww:$  
k"/}9[6:U5  
</x:query> ,CqGO %DY  
Lke!VS!P&  
</tt:connection> 2*n~r  
Ib/e\+H\  
z<yqQ[  
与此同时,在TLD中必须指定connection属性为可选的,定义如下: 7o*~zDh@fH  
/6 x[C  
<tag> PCc{0Rp\vk  
k#V\O2lb  
... "1DlusmCCB  
-B7X;{  
<attribute> #&K}w 0}k  
)7E7K%:b,  
<name>connection</name> (CYQ>)a  
E( *CEW.V*  
<required>false</required> v806f8  
3Dj>U*fP  
</attribute> mv/ Nz?  
k&u5`F  
</tag>
描述
快速回复

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