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

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

级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记! fgcI55&jV{  
u hW @ Y+  
一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。 w64/$  
YTP6m9hA+  
在这篇文章中,我们主要讨论: 8L]em&871  
>Z@^R7_W  
· 什么是自定义tag标签? F)rU* i7  
,)-7f|  
· 怎么使用tag标签? I,J*\)-%J  
d;1%Ei3K  
o 声明要使用的tag库 z2p@d1  
yzJ VU0s  
o 找到与之对应的tag处理类 \1x<bx/1  
M_asf7|v  
o tag标签的类型 }j9V0`Q  
d/oxRzk'L  
· 自定义tag标签 J<J_yRg2  
!;EG<ji,gj  
o tag处理类 zQvp<IUq  
CJ0{>?  
o tag库描述 5R"My^G  
2w6 y  
o tag标签示例 67<Ym0+ =  
Qxb5Y)/jn  
o 带属性的tag GR6BpV7  
t<~$?tuZ  
o 带body的tag >HMuh)  
IjJO;  
o 定义了脚本变量的tag x xMV2&,Jq  
it?l! ~  
o 具有协作关系的tag 2eNA#^T=  
#J&45  
· 自定义tag标签 \H <k  
p1^k4G  
o 一个迭代tag的例子 X@`kuWIUw  
8:s" ^YLN  
o 一个模板tag库 mc37Y.  
M;s r1C  
o tag处理类到底是怎样被调用的? 6XU1w  
(<y~]igy  
\Eqxmo  
什么是自定义的tag? P,1[NW  
`x%( n@g  
一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。 N0`v;4gF$]  
!\D[lh}rL  
自定义tag标签有很多特色,诸如: ;oL`fQyr  
8bl&-F `  
· 可以在JSP页面中自定义tag标签的属性 Y [8~M8QX  
F/1B>2$`  
· 访问JSP页面中的所有对象 J~dk4D\  
zg)-RCG  
· 可以动态地修改页面输出 7ip$#pzo  
v(PwE B]  
· 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。 dG5p`N %  
ca~nfo  
· tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。 'L$%)`;e  
sJA` A  
jvGGIb"&1  
使用tag标签 )8ub1,C  
x""gZzJ$L  
jN. '%5Q?H  
本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。 Qv~KGd9  
yCk9Xc  
要使用tag标签,JSP程序员必须做2件事: >;|~ z\8  
Ih_2")d  
· 声明此tag标签的tag库 9WE_9$<V  
~cHpA;x9<^  
· 实现此tag标签 !cblmF;0  
zT _  
声明tag标签所在的tag库 l]:nncpns  
2|2'?  
如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明) 0xv@l^B  
!aylrJJ  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> u7L!&/6On  
>\J({/ #O  
uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。 O+ ].'  
QPL6cU$&R  
TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。 d"h*yH@  
8HL$y-F  
以下taglib指示符直接引用一个TLD: i6)7)^nG  
6Ja } N  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> {[Bo"a>%  
s+9q`k^  
以下的taglib指示符通过一个逻辑名称间接地引用一个TLD: V(/ @$&  
(7v]bqfw  
<%@ taglib uri=”/tutorial-template” prefix=”tt” %> AHa%?wb  
x}acxu 2H7  
如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素: }ZPO^4H;-  
HfQZRDH  
<taglib> >b6!*Lrhs  
T ~=r*4  
<taglib-uri>/tutorial-template</taglib-uri> "YW&,X5R  
A:{PPjs%LA  
<taglib-location> +@n8DM{b  
P;B<R"  
/WEB-INF/tutorial-template.tld >j&+mii  
 _tl  
</taglib-location> 6I5,PB  
ED0Vlw+1  
</taglib> f=$w,^)M  
$>Y2N5  
l'Oz-p.@  
实现此tag标签 B;k3YOg  
HLD8W8  
6R.%I{x'  
为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。 l+%2kR  
16;r+.FB'  
n2e#rn  
tag标签类型 V5]}b[X  
q\0CS>.  
"'# 18&N  
自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点): wNNInS6  
WAd5,RZ?  
<tt:tag> G[;GP0\N  
@/(\YzQvp]  
body ?p&CR[  
]j=Eof%Rc  
</tt:tag> nTy8:k']  
nU^-D1s{  
Jf#Ika&px  
一个不带body的tag标签如下: A }(V2  
*y6zwe !M  
<tt:tag /> S-^:p5{r  
q:}Q5gzZ  
DQ#rZi3I  
简单的tag标签 H<Ne\zAv  
8[PD`*w  
一个没有body和属性的tag标签如下: 3e)W_P*0?  
{~L{FG)O  
<tt:simple /> ;7;=)/-  
+-s$Htx  
[UP-BX(  
带属性的tag标签 ]RBT9@-:U  
MXVQ90  
pZVT:qFF  
自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。 6\9 Zc-%  
v--Qbu  
你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值: WNO|ziy  
2r zOh},RS  
<loglic:present parameter = “Clear”> vS@;D7ep  
9A7LDHst7  
而另一个标签logic:iterate是用表达式来给属性赋值: *h <_gn  
[osIQ!u;:  
<logci:iterate collection=”<%= bookDB.getBooks() %>” ~g#$'dS  
LBcnBo</v  
id=”book” type=”database.BookDetails”> Ht{Q=w/ 9  
%ZKP d8  
?QJS6i'k  
带body的tag标签 [Yi;k,F:  
IasWm/  
一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。 @zQ.d{  
d ynq)lf  
在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息: 5{PT  
yA+ NRWWj  
<logic:present parameter=”Clear”> 88]4 GVi  
ekR/X  
<% cart.clear(); %> r bfIH":  
B_kjy=]O.  
<font color=”#ff0000” size=”+2”><strong> 6I<^wS9j_  
3 |se]~  
你选择了清除购物车! Xur{nk~?  
{E 'go]  
</strong></font> hOOkf mOM  
? "+g6II  
</logic:present> y;GwMi $KI  
g,k} nkIT  
)R+26wZ|n*  
到底是用属性还是用body来传递信息? tCF,KP?  
aSGZF w  
如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。 N I*x):bx  
yPn!1=-(  
B$\,l.h E  
定义脚本变量的tag标签 6r]l8*3 4;  
u&E$(  
所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等: :j<ij]rsI  
Ic<J]+Xq  
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” /> +46m~" ]  
F%-KY$%  
<% tx.begin(); %> /b;GC-"v  
j#f7-nHyz8  
... U!TSAg21P  
crDm2oA~t  
R(1N]>  
具有协作关系的tag标签 rLKwuZ  
~43T$^<w;  
自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。 `[(.Q  
.='hYe.  
<tt:tag1 attr1=”obj1” value1=”value” /> dlf nhf  
_rN1(=J  
<tt:tag2 attr1=”obj1” /> ;_nV*G.y#^  
o8ERU($/  
在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。 L>ruNw'-K  
_u] S/X-  
<tt:outerTag> <@](uWu  
n>o0PtGxC  
<tt:innerTag /> o4U[;.?c  
e,X {.NS  
</tt:outerTag> yu.N>[=  
O:J;zv\  
Cqra\  
Tag处理类 (rT1wup  
-#y^$$i0  
Z /*X)mBuB  
Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。 !A|ayYBb\  
 %&81xAt  
当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。 8 Buus  
M3EB=tU  
下表说明不同类型的tag所需要不同的处理过程: D=!T,p=  
aSEzh7 8  
Tag处理类的方法 Iq% 0fX  
^}{`bw{  
Tag标签类型 ]nQC  
所调用的方法 DxvD 1u   
<uf,@N5m  
基本标签 I7-6|J@#^  
doStartTag, doEndTag, release k3- 7Vyg  
+8zC ol?j  
带属性的标签 BXx l-x  
doStartTag, doEndTag, set/getAttribute1...N, release G,-x+e"  
66Tx>c"H  
带内容的标签 cg| C S?  
doStartTag, doEndTag, release $%Kyz\;7/  
h+ggrwg'  
带内容的标签,且内容重复循环 hlO,mU  
doStartTag, doAfterBody, doEndTag, release U8]BhJr$Q  
%gbvX^E?  
带内容的标签,且内容与JSP交互 wc~k4B9"  
doStartTag, doEndTag, release, doInitBody, doAfterBody, release ][[\!og  
CY?19Ak-xd  
一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。 :&-j{8p-  
|WUm;o4E`U  
如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。 ln&9WF\I  
g+zfa.wQ  
一般情况都将所有的tag处理类打成了JAR的包,以便于发布。 Afao Fn+  
&`}8Jz=S  
J69B1Yi  
Tag库描述(简称TLD) yu9 8d1  
.8~zgpK  
dp=#|!jc  
Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。 G@+AB*Eu  
Lk8NjK6  
TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。 YYi:d=0<SO  
+=JJ=F)  
一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如: W>2m %q U  
AfqthI$*m  
<?xml version="1.0" encoding="ISO-8859-1" ?> ?]Wg{\NC6  
=.9uuF:  
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> /)LI1\ o  
TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表: r)/nx@x  
IuOY.c2.u  
w.9'TR  
<taglib>的子元素 m{ VC1BkZ  
9i`sSi8   
Element iL\eMa  
Description <`Q*I Y  
n^+rxG6 L  
tlib-version j{: >"6  
Tag库的版本 _N2tf/C&=  
/2jw]ekQ'  
jsp-version Y?b4* me  
Tag库所需要的jsp的版本 0<4Sw j3s7  
m! H7;S-(  
short-name #>[5NQ;$'  
助记符,tag的一个别名(可选) p(`?y:.3  
2[e^mm&.   
uri YjTA+1}  
用于确定一个唯一的tag库 n+94./Mh  
MET"s.v  
display-name 0!(BbQnWI  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) uNS ]n}  
c_+y~X)i  
small-icon [(D^`K<b  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) 15L0B5(3  
u''~nSR3&  
large-icon k\wcj^"cb  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) ^a?H "  
$Eh8s(  
description \UR/tlw+/  
对tag库的描述(可选) |d0,54!  
cUPC8k.1  
listener <RPy   
参见下面listener元素 .V'=z|   
~V?3A/]  
tag #fTPo:*t  
参见下面tag 元素 +i1\],7  
_=d X01  
Listener元素 0s+pcqOd^  
Zyx92z9Y  
一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。 I6B4S"Q5<  
Rb=8(#  
Tag元素 hq[RU&\  
>~)IsQ*%  
每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。 \8HLQly|@  
U%)m [zAw  
每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素: * U#@M3g.  
>Vl8ZQ8  
Tag元素的子元素 {%cm;o[7o  
gXThdNU4G  
元素名称 o;\c$|TNU  
描述 {24Y1ohK  
@w]z"UCwV@  
name di,?`  
独一无二的元素名 Xj+oV  
n>-"\cjV  
tag-class ^+)q@{\8Y  
Tag标签对应的tag处理类 $4Ko  
I'$}n$UvZ  
tei-class Mq [|w2.  
javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选) `E4OgO  
1;$8=j2  
body-content $,v[<T`  
Tag标签body的类型 F')fi0=  
sM0o,l(5  
display-name "2FI3M =  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) QTKN6P  
8ta`sNy9  
small-icon sKU?"|G81G  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) ]0yYMnqvr  
|fTWf}Jx  
large-icon 5Rc^5Nv  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) ;p U=>  
u>U4w68  
description :lGH31GG  
此tag标签的描述 3$hbb6N%6.  
k=o>DaEh(  
variable SFdSA4D"  
提供脚本变量的信息(同tei-class)(可选) =O?#>3A}  
sHwn,4|iY  
attribute .xIu  
Tag标签的属性名 oy?>e1Sy*  
)rP)-op|A  
以下章节介绍对于不同类型的tag,如何具体地实现它们。 Q[U_ 0O,A9  
|loo ^!I  
Nr(3!-  
简单的tag _/iw=-T  
/Wqx@#  
jj&4Sv#>  
tag处理类 FID4@--  
|>2IgTh1a  
简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。 zLa3Q\T  
FYtf<C+  
以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下: ED kxRfY2/  
z%pD3J?>  
9^5D28y  
public SimpleTag extends TagSupport 7KzMa%=  
rW&# Xw/a  
{ ZO!  
B,Gt6c Uq  
public int doStartTag() throws JspException |0jmOcZF  
!^ /Mn  
{ ZX Sl+k .  
(3;dtp>Xx  
try{ .}V&*-ep  
cx(W{O"Jb  
pageContext.getOut().print(“Hello.”); nfV32D|3  
mGK-&|gq  
}catch(Exception e){ 5v uB87`  
qXQ/M]  
throw new JspTagException(“SimpleTag: “ + e.getMessage()); I )LO@  
+[sZE X  
} 3nJd0E  
U =G^w L  
return SKIP_BODY; J^G#x}y  
+-B`Fya  
} %%w/;o!c  
jW G=k#WN  
public int doEndTag() / W,K% s]  
i(k]}Di:  
{ R1%2]?  
{MaFv  
return EVAL_PAGE; l6C^,xU~IX  
$j\UD8Hj'-  
} ~GWn>  
(Wm4JmX%  
} <%2A, Vz"  
EpO5 _T_  
t#0/_tD  
注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如 D3>;X=1  
j+_pF<$f:  
<body-content>empty</body-content> 4&+;n[D  
B:pIzCP  
2+Tu"oG;rB  
带属性的tag标签
评价一下你浏览此帖子的感受

精彩

感动

搞笑

开心

愤怒

无聊

灌水
级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
只看该作者 1 发表于: 2007-01-01
tag处理类 Z{|U!tn  
BK_x5mGu3  
对于tag标签的每个属性,你必须依照JavaBeans规范来定义其属性,以及get和set方法。以struts的logic:present 标签为例, +Y^_1  
O-M4NKl]6  
<logic:present parameter=”Clear”> \(C_t1  
]/p)XHKo  
与此相应,此tag处理类应有如下方法和定义: osJ;"B36  
r`THOj\cM  
j|u6TG  
protected String parameter = null; 3']yjj(gHr  
_Vs\:tygs  
public String getParameter() Nz ,8NM]  
\y-Lt!}  
{ T|h/n\fx)a  
IkU:D"n7  
return this.parameter; }wJDHgt]-p  
SX{6L(  
} tsFwFB*  
#NAlje(7  
public void setParameter(String parameter) 95,{40;X7  
N|,6<|  
{ |$r|DX1[  
;btH[a iV  
this.parameter = parameter; z k[%YG&  
0nF>E@j^[  
} mxYsP6&  
O^D$ ~ ]  
LN8V&'>  
注意:如果你的属性名为id,而且你的tag处理类是从TagSupport类继承的,那你就不需要定义它的属性和set和get方法,因为他们早已在TagSupport被定义过了。 O1.a=O  
Om% 9 x  
Attribute元素 +M+ht  
;)^eDJ<  
对于tag标签的每个属性,你必须定义它是否必须的,它的值是否可以用诸如<%= …%>的表达式来获得,以及它的类型(可选),如果不指定它的类型,那就默认为是java.lang.String类型。如果rtexprvalue元素被定义为true或yes,那么在type元素中就定义了attribute的返回类型。 CL^MIcq?  
FuZ7xM,  
<attribute> (]|rxmycA  
# !?5^O  
<name>attr1</name> {-sy,EYcw  
>qJRpO  
<required>true|false|yes|no</required> He4sP` &I  
uLw$`ihw  
<rtexprvalue>true|false|yes|no</rtexprvalue> w,\#)<boyb  
o,!r t1&0  
<type>attribute的返回类型(只用当rtexprvalue为真是才有效)</type> b@OL !?JP  
y7 I')}SC  
</attribute> |]5g+sd  
V}#2pP  
如果tag的某个属性不是必须的,那tag处理类会自动提供一个缺省值。  H4HWr6  
/"t*gN=wrF  
例如,在logic:present这个tag标签中定义了一个属性叫parameter,但它不是必须的,而且它可以被诸如<%= …%>的表达式来赋值。 x,\PV>   
a*}ZT,V  
<tag> GdqT4a\S  
oEHUb?(p  
<name>present</name> -ISI!EU$  
bF88F_  
<tag-class>org.apache.struts.taglib.logic.PresentTag</tag-class> mCtuR*z_  
xGQ958@  
<body-content>JSP</body-content> MorR&K  
^X%{]b K  
[~;#]az  
)fz)Rrr  
<attribute> x}G["ZU}v]  
zMT0ToG  
<name>parameter</name> 1;p'2-x  
 0u4:=Z}W  
<required>false</required> Z2Bl$ \  
;as4EqiK  
<rtexprvalue>true</rtexprvalue> m8Q6ESg<*u  
d jeax  
</attribute> c~0YIk>]  
:^DuB_  
ellj/u61bj  
V4GcW|P4y  
</tag> eKlh }v  
s4 o-*1R*`  
8>TDrpT}  
属性元素的校验 & p 1Et  
9-DDly [)4  
$cri"G  
有关于tag标签的有效值可以从tag库的说明文档中获得,当JSP页面被编译时,jsp引擎会强制性地参照TLD中定义的规则进行检查。 }>cQ}6n.  
sKhX0,s&  
还有一个方法也可以进行属性元素的校验,就是先继承类TagExtraInfo,然后调用它的isValid方法。这个类同时也起到提供tag中定义的脚本变量信息的作用。 .(tga&]  
S1pikwB  
IsValid方法通过TagData对象来传递属性信息,它包括着tag的所有的属性名-值的信息。由于校验发生在运行时刻,因此这个属性的值将被赋值为TagData.REQUEST_TIME_VALUE。 7E$ e1=  
P`HE3?r  
例如tag标签<tt:twa attr1=”value1” />在TLD中定义如下: ~_P,z?  
.~0A*a  
<attribute> (( 0%>HJ{~  
xp%,@] p  
<name>attr1</name> mnM#NT5]  
8t!/O p ?  
<required>true</required> ^tIi;7k  
~Dw.3P:-  
<rtexprvalue>true</rtexprvalue> CUB=T]  
M3j_sd'N  
</attribute> >3 Q%Yn  
7p&%0'BO1z  
H4 }^6><V  
这个定义说明了attr1能在运行期间被赋值。 Ij hC@5qk  
DCv~^  
以下的isValid方法检查attr1属性的值是否属于Boolean类型。注意由于attr1能在运行刻被赋值,那么isValid方法必须检查tag用户是否对此tag进行了运行时刻赋值。 3&kHAXzM  
$-m`LF@  
6elmLDMni\  
Public class TwaTEI extends TagExtraInfo *5iNw_&  
B98&JoS  
{ ]<mXf~zg  
dm1W C:b  
public boolean isValid(Tagdata data) _e AZ_@  
N5 SK_+  
{ 5V\\w~&/  
n83,MV?-  
Object o = data.getAttribute(“attr1”); }E+}\&  
Bry\"V"'g  
If(o != null && o != TagData.REQUEST_TIME_VALUE) +(VHnxNQs  
eN@V?G26K  
{ N<$U:!Z  
F{\MIuoy  
if( ( (String)o).toLowerCase().equals(“true”) || -.: [a3c?  
;"=a-$vm  
((String)o).toLowerCase().equals(“false”) ) ,Y EB?HA  
+1Oi-$ 2-  
return true; ?<\ K!dA  
~p{.4n2:  
else Q_'3}:4  
zFh JLH*C  
return false;  :\1:n  
\3(d$_:b  
} 7vRJQe)  
iCCY222:  
else +5Yc/Qp  
2~+_T  
return true; |?0Cm|?  
*Z=K9y,IC  
} 4flyV -  
]Kb  
} ygr[5Tl  
8 ~.|^no  
Y9ueE+6  
带body的tag S+A'\{f  
Af5O;v\  
zlIXia5  
tag处理类 dL'hC#!h  
L)JpMf0  
.w^M?}dx  
如果tag标签含有内容,那处理方式会略微有些不同,而且还要视tag处理类是否要与body交互的情况而定。如果要与body交互,那我们认为tag处理类要可能要对body进行操作。 /u{ 9UR[g  
 L3P_  
Tag处理类不与body交互 =NwmhV  
Me[T=Tt`@w  
如果tag处理类不与body交互,tag处理类应该实现Tag接口或从TagSupport中派生,如果body要被计算,那么doStartTag方法应返回 EVAL_BODY_INCLUDE,否则应返回SKIP_BODY。 Ub%+8 M  
C)/uX5  
如果tag处理类要对body反复运算,则它应该实现IterationTag或从TagSupport中派生。如果tag处理类认为body还未计算完的话,那它的doStartTag方法和doAfterBody方法必须返回EVAL_BODY_AGAIN。 K:fK! /  
RG|]Kt8  
Tag处理类与body交互 8'?V5.6?|~  
W'6~`t  
如果tag处理类与body交互,那tag处理类应实现BodyTag接口或从BodyTagSupport中派生。这种tag处理类一般要实现doInitBody和doAfterBody方法。 :^FOh*H  
1SeDrzLA  
Body允许一些方法来读写它的内容。Tag处理类可以调用body内容的getString或getReader方法来从body中提取信息,也可用 writeOut(out) 方法来将body的内容写入到out对象中。其中out对象通过tag处理类的getPreviousOut方法来获得。 (UPkb$Qc  
3}}~(  
如果body的内容需要被计算,那么doStartTag方法必须返回EVAL_BODY_BUFFERED,否则,它将返回 SKIP_BODY。 d paZ6g  
TLzg*  
doInitBody 方法 r Ip84}  
ET1/oG<@  
此方法在body内容已经设好,但未被计算之前被调用。你可以根据不同的body内容来制定初始化策略。 P 0,) Gw  
8SK}#44Xz  
doAfterBody方法 0\O*\w?  
lq=| =  
此方法在body内容已被计算后进行调用。 fD#|C~:=  
:; \>jxA  
和doStartTag方法一样,doAfterBody方法返回一个指示符指示是否要继续计算body,如果要继续计算,则doAfterBody应返回EVAL_BODY_BUFFERED,否则,它应返回SKIP_BODY。 (L_txd4  
{`BC$V  
release 方法 B\A2Vm`&  
kPF[E5  
tag处理类调用此方法将它的状态重置为初始状态,并释放所有的私有资源。 &}31q`  
RekTWIspT/  
Q^4j  
以下的例子读取body的内容(其中含有一条sql语句),然后将它传递给一个对象,让它进行查询。由于此处body不须重新计算,所以doAfterBody会返回SKIP_BODY。 !r$?66q/  
Z{7lyEzBg  
;AK;%  
Public class QueryTag extends BodyTagSupport fQc2K|V  
6T0E'kv S  
{ 7$'%*|C.  
$w`QQ^\  
public int doAfterBody() throws JspTagException h7<Zkf  
lG,/tMy  
{ pzmm cjEC  
\](IBI:  
BodyContent bc = getBodyContent(); O{rgx~lLJt  
[R-4e; SRh  
//将body的内容以字符串的格式提取出来 h.FC:ym"  
*IUw$|Z6z)  
String query = bc.getString(); B) J.(k`p  
u}hQF $a"  
//清除body ZvEcExA-  
P|YBCH  
bc.clearBody(); z|[#6X6tT  
x&7% U  
try{ LS@[O])$'  
1C(6.7l  
Statement stmt = connection.createStatement(); =wHHR1e  
LivPk`[  
Result result = stmt.executeQuery(query); T1m'+^?"  
t QkEJ pj  
}catch(SQLException e){ $>1 'pV  
mz;S*ONlV  
throw new JspTagException(“queryTag: “ + e.getMessage() ); ?#idmb}(  
6rP[*0[  
return SKIP_BODY; )[Bwr bn  
rMAH YH9  
} >HO{gaRM  
3UgusH3  
} epp ;~(xr  
w-\U;&8  
iD,iv  
body-content元素 LyO, ]  
J"'2zg1&  
[?VYxX@  
由于tag可能会有body,你必须用body-content元素来指定body内容的类型: ;xaOve;9  
[vb>5EhL!  
<body-content>JSP|tagdependent</body-content> {ve86 POY  
L8n1p5 gx3  
9H:5XR  
如果body的内容是定制的或内部的tag、脚本元素、或HTML广本,则归类为JSP类型。其他的类型,比如上面代码所述的?D?D将sql statement类传给 query tag的这种类型应该标为tagdependent。  ZeD;  
4mSL*1j  
注意:实际上body-content的值并不影响tag处理类对body内容的处理,它仅仅是被tag编辑工具用来描述此body的内容。 vUl5%r2O4  
HubSmbS1  
ei'=%r8~  
用tags定义脚本变量 'jWd7w~(  
c0jdZ#H  
&WAO.*:y  
tag处理类 n~N>c*p  
e_s9E{(  
*f|9A/*B3  
tag处理类负责创建或设置页面中定义的脚本变量,用pageContext.setAttribute(name,value,scope)或pageContext.setAttribute(name,value)方法来实现。一般来说,tag处理类通过脚本变量的名称来获取它,脚本变量的名称一般可用get方法来获得。 TtEc~m  
fI(u-z~,  
如果脚本变量的值依赖于tag处理类中的上下文中某一对象,那它可用pageContext.getAttribute(name,scope)方法来找到那个对象。一般的处理过程是tag处理类先找到脚本变量,再对其进行处理,然后用pageContext.setAttribute(name,object)的方法来设置它的新值。 +N1oOcPC>C  
?F'gh4  
对象的生存周期(scope)如下表: y]Q G;  
hWpn~q  
对象的生存周期表 {Buoo~  
&\8.y2=9p  
名字 ""l_& 3oz  
可访问范围 ]z`Y'wSxd  
生存周期 xMJF1O?3  
+cv7]  
page ;Vc@]6Ck  
当前页面 6J0HaL  
一直有效,除非页面向客户提交响应或重定向到一个新页面 6He7A@Eh  
2/S~l;x  
request 0HK03&  
当前页面或当前页面重定向到的页面 (UmoG  
一直有效,除非页面向客户提交响应 iOz<n z  
yo*c& >  
session MN\/F4Io  
当前页面或在同一浏览器窗口中的页面 g/,fjM_  
一直有效,除非关闭当前浏览器、超时、网络故障 JG&`l{c9  
*u.6,jw  
application Wh[+cH"M  
整个web应用程序的所有请求 OQ"%(w>Hb  
一直有效,除非发生网络故障、服务器故障 Z0T{1YEJ  
b3}928!D-@  
提供关于脚本变量的信息 jeF1{%  
mN3}wJ}J  
以下示例定义了一个名为“book”的脚本变量,用来访问程序中关于书的信息: h+F@apUS  
M$ g%kqa  
<bean:define id=”book” name=”bookDB” property=”bookDetails” type=”database.BookDetails” /> (;YO]U4  
jq(3y|6,  
<font color=”red” size=”+2” > CBdS gHA3>  
7 y}b (q=  
<%= messages.getString(“CartRemoved”) %> W Da;wt  
I7b(fc-r  
<strong><jsp:getProperty name=”book” property=”title” /></strong> ZxkX\gl91  
)}L*8 LV  
</font> *9)7.} uY  
'Y3>+7bI  
当包含此tag的JSP页面被编译时,jsp引擎会自动生成关于此book的同步的代码(同步可以避免几个客户同时访问此book时造成的冲突),要生成同步代码,jsp引擎需要知道此脚本变量的如下信息: _.0c~\VA  
6W$ #`N>  
· 脚本变量名称 `84pql,  
-'+|r]  
· 脚本变量所属的类 eCdx(4(\a  
@ fm\ H  
· 此脚本变量是否引用了一个新的或已存在的对象 fVv#|   
}CZ,WJz=  
· 此脚本变量的有效性 <\Nf6>_qEM  
<b"ynoM.A  
有两种办法可以向jsp引擎提供关于脚本变量的信息:在TLD中定义variable子元素,或用tei-class子元素定义一个额外tag信息类。用variable最简单,但可能降低了一些灵活性。 P;0tI;  
c.jq?Q k  
Variable元素 VaZ+TE  
=MO2M~e!  
Variable元素有如下子元素: FV^CSaN[R  
;`g\Tu  
· name-given ?D?D 给出的名字,是一个常量 Pi::cf>3  
Yu=4j9e_mG  
· name-from-attribute?D?D 属性名,在编译时给出的属性名 -H~g+i*J  
>R3~P~@30  
name-given或name-from-attribute两者必须选一,但以下子元素是可选的: _H^Ij  
6~GaFmW=  
· variable-class?D?D变量的类型,缺省为java.lang.String。 vFY/o,b \  
pW O-YZ#+  
· declare?D?D此脚本变量是否引用了一个新对象,缺省为True。 =Xzqp,  
f ^mxj/%L  
· scope?D?D脚本变量的范围,缺省为NESTED。下表描述了scope的几种类型: 8,2l >S  
d}tn/Eu?B  
脚本变量的有效范围 9x.vz  
OqUEj 0X  
OO_{ o  
有效性 LA$uD?YA  
方法 1Lwi?~!LI  
0K7]<\)  
NESTED pVn 6>\xa  
在tag标签的开始和结束之间 f]"][!e!,  
如果tag处理类实现BodyTag接口,则在doInitBody和doAfterBody中调用,否则在doStartTag中调用 pcNVtp 'V  
kbBD+*  
AT_BEGIN ^ cN-   
从tag标签的开始一直到页面结束 xtf]U:c  
如果tag处理类实现BodyTag接口,则在doInitBody、doAfterBody和doEndTag中调用,否则在doStartTag和doEndTag中调用 uxk&5RY  
=]oBBokV  
AT_END _dppUUm  
从tag标签的结束一直到页面结束 D h]+HF  
在doEndTag中调用 L5%~H?K(  
>`= '~y8  
以struts为例,它的bean:define标签的实现遵循JSP1.1规范,此规范要求使用额外tag信息类来定义脚本变量。Variable元素是JSP1.2规范中加入的。以bean:define标签为例,你可以定义如下variable元素: FOpOS?Cr'  
PYr#vOH  
<tag> {r.#R| 4v  
kac@yQD  
<variable> 6}R^L(^M  
vrn I Eur  
<name-from-attribute>id</name-from-attribute> TveCy&  
:Oo  
<variable-class>database.BookDetails</variable-class> "-XL Y_  
0*V RFd4  
<declare>true</declare> C.@R#a'  
KL*ZPKG  
<scope>AT_BEGIN</scope> N^q*lV#kob  
oTo'? E#  
</variable> 3O%[k<S\VO  
liFNJd`|o+  
</tag> : Ey  
Nt67Ye3;  
额外tag信息类 = sedkrM  
4nkH0dJQ  
如果要定义一个额外tag信息类,你要继承javax.servlet.jsp.TagExtraInfo类。一个TagExtraInfo类必须实现getVariableInfo方法,此方法返回一个叫VariableInfo的数组类,它包括如下信息: k='sI^lF  
D9e"E1f+"  
· 变量名 e%x$Cb:znn  
0 sVCTJ@  
· 变量所属类名 MdU_zY(c  
tc@v9`^_  
· 此变量是否引用了一个新对象 $;7?w-.  
aGNt?)8WPZ  
· 此变量的有效范围 *j><a  
VJD$nh #M5  
jsp引擎将一个名为data的参数传给getVariableInfo方法,data中包括tag标签中的所有“属性名?D?D属性值”对。它可以用来向VariableInfo对象提供脚本变量的名字和类名。 k]Y+C@g  
>!A&@1[M  
以struts为例,它在bean:define标签中定义了一个名为DefineTei的额外tag信息类,用来向脚本变量提供信息。由于脚本变量的名称(book)和类名(database.BookDetails)是通过tag标签的属性来传递的,它们一般定义在VariableInfo的构建代码中,并且可用data.getAttributeString方法来得到这些信息。如果要允许book脚本变量能在从tag开始直到整个JSP页面结束的范围内都可用的话,那它的范围应设为AT_BEGIN。如下所示: !l~tBJr*sB  
/MsXw/],  
^C>i(j&  
public class DefineTei extends TagExtraInfo Lcplc"C  
9C[3w[G~C  
{ MR%M[SK1  
Rb<aCX  
public VariableInfo[] getVariableInfo(TagData data) 3s\2 9gq  
hnL"f[p@gC  
{ s!Y>\3rMW  
V!c{%zd  
String type = data.getAttributeString(“type”);  {"y{V  
QV+('  
If( type == null) )gvX eJ  
\%&QIe;:k  
type = “java.lang.Object”; B9iH+ ]W  
4 u X<sJ*  
return new VariableInfo[] { /-E>5wU  
Slq=;TDp  
new VariableInfo(data.getAttributeString(“id”), //Ioh (N  
=NAL*4c+  
type, O-wR48Q  
CY)Wuv ^  
true, tNbCO+rZ  
f|?i6.N> f  
VariableInfo.AT_BEGIN) L GK0V!W  
[[JwHM8H&  
}; ^qiTO`lg  
LB? evewu  
} T'\ lntN  
(o{QSk\  
} vb9G_Pfz  
"pdG%$  
_zJY1cr  
注意:关于额外tag信息类的类名必须要在TLD中的tag标签下的tei-class子元素中定义。因此,DefineTei的tei-class中的定义看起来如下: "6 dC  
<tei-class> rv;w`f  
org.apache.struts.taglib.bean.DefineTagTei 0Z2![n  
</tei-class> D!J ("~[3  
?.|qRzWL  
vrGRZa  
具有协作关系的tag @s2z/ h0H  
y M , hF  
|w6:mtaS  
tag通过共享对象来进行协作,JSP技术支持2种方式的对象共享。 eXnMS!g%Z  
7 -gt V#  
第一种方法是使用pageContext对象进行对象的共享(可支持JSP页面和tag处理类之间的共享),如果在一个tag处理类中要调用由另一个tag处理类创建的对象,可调用pageContext.getAttribute(name, scope)方法。 ~?E x?!\9R  
J.?6a:#bU/  
第二各方式的共享是对于tag之间有嵌套关系而言的,外层的tag所创建的对象对于内层的tag来说是可以共用的。这种形式的共享的好处是减少了可能存在的重名冲突。 nE Qw6q~je  
DB:Ia5|*i  
要访问一个嵌套tag创建的对象,tag处理类必须先找到此嵌套tag对象,可用TagSupport的静态方法 TagSupport.findAncestorWithClass(from, class)或TagSupport.getParent方法。前者在当不确定此tag是否为嵌套tag对象时使用。一旦它的父类被找到,它就能访问其所有动态或静态创建的对象。静态创建的对象是父类的成员,而动态创建的对象可能是父类的私有对象。诸如此类的对象可以用tag处理类的setValue方法来保存,用getValue方法来获得。 i4'?/UPc  
.2!'6;K  
下例阐述了以上两种共享对象的方法。在这个例子当中,一个查询tag检查一个名为connection的属性名是否在doStartTag中被设置。如果connection属性被设置,tag处理类从pageContext中得到这个connection对象。否则,此tag处理类先找到它的父tag处理类,然后从它的父tag处理类中找到connection对象。 /V46:`V  
Nk86Y2h  
p[hA?dXn  
public class QueryTag extends BodyTagSupport n8A*Y3~R  
+_06{7@h  
{ Z)|*mJ  
E$4\Yc)(AL  
private String connectionId; _4owxYSDke  
<2diO=  
public int doStartTag() throws JspException }c| Xr^  
6~&4>2b0f  
{ `WC~cb\  
b0tr)>d  
String cid = getConnection(); ;-n+=@]7  
~ ${. sD\  
if(cid != null) KxGK`'E'r  
n_)d4d zl  
{ f`RcfYt  
Uj0DX >I  
//存在一个connection id,使用它。 r?\hZ*|M  
@wYuc{%S  
connection = (Connection) pageContext.getAttribute(cid); P[8`]=  
[US.n +G6  
} fwf]1@#   
;l &mA1+  
else HMS9_#[kE  
72&xEx  
{ M!,$i  
PD:" SfV,G  
ConnectionTag ancestorTag = (ConnectionTag)findAncestorWithClass(this, 7zgU>$i  
.^l;3*X@  
ConnectionTag.class); -_%n\#  
.B"h6WMz  
if(ancestorTag == null) BB|w-W=Kd  
+ 3aAL&  
{ 4rw<C07Z  
^WVH z;  
throw new JspTagException(“一个没有connection属性的查询标签必须被一个connection标记嵌套。”); (4>k+ H  
S3P;@Rm  
} zK}$W73W^  
!HY+6!hk  
connection = ancestorTag.getConnection(); 9H" u\t|?  
x a7x 2]~-  
} 06]J]  
kRTT ~  
} Hp8)-eT  
SE;Jl[PgcL  
} Z[FSy-;"  
kZ[E493bV  
v5;c} n  
)<UNiC   
此查询标签在JSP页面中的调用形式可以从以下2种定义中任选一种: S$=])^dur  
7-'!XD!  
b9%hzD,MR  
<tt:connection id=”con01” ...> ... </tt:connection> A>bo Xcr  
%_(e{Mf)  
<tt:query id=”balances” connection=”con01” > k,0JW=Vh>|  
cIw)ScY  
SELECT account, balance FROM acct_table =Mc*~[D/  
MJt?^G (w?  
where customer_num = <%= request.getCustno() %> ^^{K[sLB  
k129)79  
</tt:query> =xw) [  
54-sb~]  
&+xNR2";  
p4fU/  
K!).QB'  
<tt:connection ...> (VI4kRj  
*A@~!@XE4  
<x:query id=”balances”> /Pxt f~$  
';^VdR]fk  
SELECT account, balance FROM acct_table dArg'Dc4  
bf VKf}  
where customer_num = <%= request.getCustno() %> DKPX_::  
O< v0{z09*  
</x:query> l7ZqkGG]  
]KA|};>ow  
</tt:connection> ^$FHI_  
AcwLs%'sx  
%{Kp#R5E  
与此同时,在TLD中必须指定connection属性为可选的,定义如下: .Qyq*6T3&  
:Z- = 1b~  
<tag> 4@u*#Bp`|  
Ty}'A(U  
... %|I~8>m  
2>Xgo%  
<attribute> *_}ft-*w  
/3Zo8.  
<name>connection</name> A% -*M 'J  
ey_3ah3x  
<required>false</required> ,ZHIXylZ  
7YV}F9h4  
</attribute> dAh&Z:86\  
eBFsKOtu  
</tag>
描述
快速回复

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