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

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

级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记! U!5)5c}G  
I8Vb-YeS  
一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。 `<"m%>  
9Mm!%Hu  
在这篇文章中,我们主要讨论: yR~-k?7b  
i7[uLdQ  
· 什么是自定义tag标签? `BFIC7a  
~:Uw g+]j  
· 怎么使用tag标签? hPhZUL%  
2 +5e0/_V  
o 声明要使用的tag库 ZUXr!v/R:1  
#%3rTU  
o 找到与之对应的tag处理类 W1aa:hEf  
C.  MoKa3  
o tag标签的类型 C&\5'[*  
>XW*T5aUA  
· 自定义tag标签 + A_J1iJ<  
H( ^bC5'  
o tag处理类 $3+PbYY  
m(OvD!  
o tag库描述  r}_c  
'Yy&G\S  
o tag标签示例 !|?e7u7  
G28O%jD?  
o 带属性的tag 5 x2Ay=s  
w2(guL($  
o 带body的tag 6$Q,Y}j  
h( QYxI,|  
o 定义了脚本变量的tag 3*S{;p  
cF T 9Lnz  
o 具有协作关系的tag {4 >mc'dv  
bEuaOBc  
· 自定义tag标签 R! s6% :Yg  
oSb, :^Wl  
o 一个迭代tag的例子 N@o?b  
xh@-g|+g  
o 一个模板tag库 eBN)g^  
_#$9 y1bd  
o tag处理类到底是怎样被调用的? bucR">_p  
g\A y`.s  
YMpf+kN  
什么是自定义的tag? \6|/RFT  
,FQdtNMap  
一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。 >ndJNinV  
'8FC<=+p[  
自定义tag标签有很多特色,诸如: }S_oH9A  
w[Gh+L30=5  
· 可以在JSP页面中自定义tag标签的属性 72oWhX=M%  
1m<RwI3s  
· 访问JSP页面中的所有对象 qUF'{K   
eKZ%2|+j!7  
· 可以动态地修改页面输出 |w}w.%  
.] 4W!])9  
· 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。 em@EDMvI  
[Bb utGvj  
· tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。 XhU@W}}  
zRl~^~sY  
DLPUqKL]  
使用tag标签 +';>=hha  
E|"=. T  
=H7xD"'%R  
本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。 i?;r7>  
g8;D/  
要使用tag标签,JSP程序员必须做2件事: mo]KCi  
`RQ#.   
· 声明此tag标签的tag库 92W&x'  
DLE8+NV8   
· 实现此tag标签 1pp -=$k  
WUdKLx %F  
声明tag标签所在的tag库 e= P  
JYqSL)Ta*t  
如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明) nCg66-3A  
 EEy$w1ec  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> d4[(8} x$/  
01a-{&   
uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。 u8b2$D  
JEn3`B!*  
TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。 r WtZj}A  
=#5D(0Ab  
以下taglib指示符直接引用一个TLD: <T?oKOD ]  
OqhD7 +  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> @pV5}N[]  
z(RL<N%  
以下的taglib指示符通过一个逻辑名称间接地引用一个TLD: ~K_Uq*dCE  
<{(/E0~V/<  
<%@ taglib uri=”/tutorial-template” prefix=”tt” %> 4tA_YIv  
rk2xKm^w  
如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素: }|)R   
2 mjV~  
<taglib> lB8il2&  
p(SRjQt  
<taglib-uri>/tutorial-template</taglib-uri> kW3E =pr  
igf )Hb;5  
<taglib-location> Ha>*?`?yI  
$Byj}^;1  
/WEB-INF/tutorial-template.tld iSRpfU  
qKS;x@  
</taglib-location> C z#Z<:  
T4e\0.If  
</taglib> JF9yVE-  
\b8sG"G  
!#ri5{od  
实现此tag标签 =Yo1v=wxN  
eS/B24;*  
tU wRE|_  
为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。 G>qZxy`c  
".*x!l0y7  
co4h*?q  
tag标签类型 59uwB('|lH  
Y>."3*^  
:S@1  
自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点): #(Or|\t  
Id'RL2Kq*&  
<tt:tag> T<yP* b2E  
l|`9:H  
body zZ-wG  
]-o"}"3Ef  
</tt:tag> eg+!*>GaX  
"ceed)(:  
Yx'res4e  
一个不带body的tag标签如下: ?C0l~:j7D  
dGfVZDsr]  
<tt:tag /> gxPx&Z6jF  
O^>jdl!TZ  
_:n b&B  
简单的tag标签 Gm`}(;(A  
TOF '2&H  
一个没有body和属性的tag标签如下: vh!v MB}}  
wu<])&F  
<tt:simple /> Bc-yxjsw  
SZ![%)83  
S/vf'gj  
带属性的tag标签 v <\A%  
" }gVAAvc7  
q}uHFp/J  
自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。 W_O)~u8  
a\uie$"cr]  
你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值: /T^ JS  
F,Xo|jjj  
<loglic:present parameter = “Clear”> Hk_y/97OO  
v}G]X Z8  
而另一个标签logic:iterate是用表达式来给属性赋值: z7.|fE)<6  
_?7#MWe&  
<logci:iterate collection=”<%= bookDB.getBooks() %>” C9n}6Er=,  
jt~Qu-  
id=”book” type=”database.BookDetails”> 5pNY)>]t=  
"bg'@:4F  
g3@Rl2yQJ  
带body的tag标签 3b'tx!tFN  
~wnOV#v  
一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。 Z{IUy  
0rk]/--FGJ  
在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息: jcCoan  
\hO2p6  
<logic:present parameter=”Clear”> O/%< }3Sq  
fqz28aHh  
<% cart.clear(); %> hli|B+:m"  
Oh.ZPG=  
<font color=”#ff0000” size=”+2”><strong> *x~xWg9^  
1RLY $M  
你选择了清除购物车! WlB' YL-`g  
;P&y,:<m:  
</strong></font> ;T]d M fO  
5 v^yQ<70  
</logic:present> `?*%$>W#"  
I|oT0y &  
31^cz*V  
到底是用属性还是用body来传递信息? <q)4la  
6Q4X 6U:WB  
如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。 IJOvnZ("A  
rn@`yTw^  
U;_[b"SW%  
定义脚本变量的tag标签 X#xFFDzN  
%sh>;^58P  
所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等: &MmU  
D8{D [fJ;  
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” /> U8#xgz@  
&ej8mq"\  
<% tx.begin(); %> 3>ex5  
] U@o0  
... -!RtH |P  
@YvOoTyb  
yn AB  
具有协作关系的tag标签 vq*Q.0M+  
VO3pm6r5  
自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。 5F+APz7  
K`}{0@ilCw  
<tt:tag1 attr1=”obj1” value1=”value” /> QR?yG+VU  
)CPM7>  
<tt:tag2 attr1=”obj1” /> JG`Q;K  
<E;pgw!  
在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。 seFGJfN\?f  
=-cwXo{Q.O  
<tt:outerTag> zo{/'BnU  
EqiFy"H  
<tt:innerTag /> %z]U LEYrZ  
*YTo{~  
</tt:outerTag> =d 2r6%v  
MfF~8  
:pX`?Ew`g  
Tag处理类 _i_Q?w`  
->z54 T  
# M, 7  
Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。 )"(]Lf's  
|rw%FM{F  
当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。 /gcEw!JS  
>DM44  
下表说明不同类型的tag所需要不同的处理过程: V~DMtB7  
Xm2\0=v5;  
Tag处理类的方法 8VG!TpX/B  
-W{DxN1  
Tag标签类型 &K_)#v`|  
所调用的方法 Tl]e%A`|  
$yDWu"R8  
基本标签 vgt]:$  
doStartTag, doEndTag, release m~#!  
NvE}eA#  
带属性的标签 UEs7''6RM  
doStartTag, doEndTag, set/getAttribute1...N, release %t=kdc0=_  
+i ?S  
带内容的标签 sKz`aqI  
doStartTag, doEndTag, release >% p{38  
!1T\cS#1%  
带内容的标签,且内容重复循环 MfO:m[s  
doStartTag, doAfterBody, doEndTag, release 7`vEe 'qz  
O-]mebTvw  
带内容的标签,且内容与JSP交互 qs\2Z@;  
doStartTag, doEndTag, release, doInitBody, doAfterBody, release 9 Gy  
+:=(#Y  
一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。 (YBMsh  
%V &n*3  
如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。 T#%/s?_>.  
Sgim3):Z  
一般情况都将所有的tag处理类打成了JAR的包,以便于发布。 C`=p +2I]  
r;9 r!$d  
7*Qk`*Ii  
Tag库描述(简称TLD) .LVQx  
$CTSnlPq  
*b *G2f^  
Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。 682Z}"I0  
eg<bi@C1|  
TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。 \}6;Kf}\  
3<=,1 cU  
一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如: spU)]4P&  
0tIS Xu-  
<?xml version="1.0" encoding="ISO-8859-1" ?> d\MLOXnLq;  
` 8W*  
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> lPH%Do>K  
TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表: 2Y}?P+:%>  
h'J|K^na  
H|ozDA  
<taglib>的子元素 rrg96WD  
 $p!yhn7  
Element dca ;'$  
Description EcIE~qs  
t$2_xX  
tlib-version K]/4qH$:  
Tag库的版本 )m6M9eC  
n%h^o   
jsp-version V$0dtvGvH  
Tag库所需要的jsp的版本 I`[i;U{CK  
i| \6JpNA:  
short-name o:Qv JcB  
助记符,tag的一个别名(可选) kK 8itO  
d\e7,"L*Q  
uri d@w~[b  
用于确定一个唯一的tag库 (%iRaw7hp  
MRU7W4W-~/  
display-name s}5cSU!|  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) !$2Z-!  
$'W}aER  
small-icon &aM7T_h8  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) "G >3QL+O|  
%1pYE Hn  
large-icon "~UUx"Y  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) T0)4v-EO  
js1!9%BV  
description y"]n:M:(  
对tag库的描述(可选) y(R? ,wa=]  
YV=QF J'  
listener 2|\A7.  
参见下面listener元素 ld$i+6|   
=4GSg1Biy  
tag |6G m:jV  
参见下面tag 元素 +q6ydb,  
imQUR C  
Listener元素 }QZQ3@  
I H$0)g;s  
一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。 b~dIk5>O  
Q1V9PRZX  
Tag元素 9nu3+.&P  
J0zn-  
每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。 +C7 ~b~ %  
zMIT}$L  
每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素: **69rN  
{M,,npl  
Tag元素的子元素 ^Rm  
No2b" G@  
元素名称 t1E[uu,V8  
描述 6c0>gUQx-  
/0\ mx4u  
name @FdSFQ/9  
独一无二的元素名 #plY\0E@  
~>9_(L  
tag-class q2HYiH^L  
Tag标签对应的tag处理类 4k./(f2+  
RN=` -*E1  
tei-class R^{)D3  
javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选) =4d (b ;  
8Sz})UZ  
body-content Spt ? >sm  
Tag标签body的类型 Y8flrM2CwG  
J>d.dq>r  
display-name O-)-YVU  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) " R xP^l  
TLehdZ>^  
small-icon @cU&n6C@  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) 8enEA^  
:[;hu}!&  
large-icon [w ;kkMJAy  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) ybp -$e  
<w3!!+oK"  
description Z"unF9`"1  
此tag标签的描述 g^zs,4pPU<  
fhB}9i^]tg  
variable 0p89: I*0  
提供脚本变量的信息(同tei-class)(可选) UA|u U5Q  
1}~(Yj@f%  
attribute 4Qn$9D+?  
Tag标签的属性名 K98i[,rP  
YKQr, Now  
以下章节介绍对于不同类型的tag,如何具体地实现它们。 uw lr9nB  
iiK]l   
Sna4wkbS  
简单的tag }1IpON  
`({T]@]V  
LR" 9D  
tag处理类 YuB+k^  
S*yjee<@  
简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。 BT}&Y6  
W456!OHa  
以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下: [$[:"N_  
*hcYGLx r  
cu+FM  
public SimpleTag extends TagSupport [z 7bixN  
J4Dry<  
{ Mw9 \EhA  
V')0 Mr  
public int doStartTag() throws JspException $ImrOf^qt  
Y`?-VaY  
{ Agrk|wPK  
\6\<~UX^  
try{ qP<Lr)nUH  
v0L\0&+  
pageContext.getOut().print(“Hello.”); @IXsy  
~Jf{4*>y  
}catch(Exception e){ zXRlo]  
/hO1QT}xd  
throw new JspTagException(“SimpleTag: “ + e.getMessage()); orb_"Qw  
+ nF'a(  
} K(aJi,e>  
L@fY$Rw  
return SKIP_BODY; u]OW8rc  
z?35=%~w   
} (y^vqMz  
1)Zf3Y8  
public int doEndTag() TsTPj8GAl[  
({o'd=nO  
{ l#n,Fg3  
R4-~jgzx  
return EVAL_PAGE; m)oJFF  
[n}T|<  
} 4WK3.6GN  
6^DR0sO  
} m4*@o?Ow  
G z)NwD  
Po%(~ )S>  
注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如 3 h<,  
]kboG%Dl?9  
<body-content>empty</body-content> RD.V'`n"  
I|Gp$ uq _  
Rn@# d}  
带属性的tag标签
评价一下你浏览此帖子的感受

精彩

感动

搞笑

开心

愤怒

无聊

灌水
级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
只看该作者 1 发表于: 2007-01-01
tag处理类 LcE+GC  
e>AE8T  
对于tag标签的每个属性,你必须依照JavaBeans规范来定义其属性,以及get和set方法。以struts的logic:present 标签为例, {` w;39$+  
t2"FXTAq  
<logic:present parameter=”Clear”> y a_<^O 9  
nqf,4MR  
与此相应,此tag处理类应有如下方法和定义: Ox@P6|m  
^I+)o1%F  
*2GEnAZb7n  
protected String parameter = null; J4\qEO  
h5K$mA5  
public String getParameter() CoA6  
Y5j]Z^^v  
{ xL" |)A =  
I&YSQK:b  
return this.parameter; :GJ &_YHf  
&@3H%DP}Ql  
} |p-t%xDdr  
C/-63O_  
public void setParameter(String parameter) [VWUqlNt>  
uDZT_c'Y  
{ y  TDNNK  
Kde9 $  
this.parameter = parameter; 3@]SKfoo1  
>i6yl5s  
} 9WR6!.y#f  
&%/7E_j7  
b2FO$Os  
注意:如果你的属性名为id,而且你的tag处理类是从TagSupport类继承的,那你就不需要定义它的属性和set和get方法,因为他们早已在TagSupport被定义过了。 gatB QwJb9  
cA:*V|YV `  
Attribute元素 mbueP.q[?  
>&U,co$>  
对于tag标签的每个属性,你必须定义它是否必须的,它的值是否可以用诸如<%= …%>的表达式来获得,以及它的类型(可选),如果不指定它的类型,那就默认为是java.lang.String类型。如果rtexprvalue元素被定义为true或yes,那么在type元素中就定义了attribute的返回类型。 H8On<C=  
Z@$8I{}G  
<attribute> l(#)WWr+  
dYgXtl=#j  
<name>attr1</name> fX|Y;S-@+  
>_LDMs[-p  
<required>true|false|yes|no</required> Tq4-wE+  
=*LS%WI  
<rtexprvalue>true|false|yes|no</rtexprvalue> %x} O1yV  
n9xAPB }  
<type>attribute的返回类型(只用当rtexprvalue为真是才有效)</type> tmtT (  
s S7c!  
</attribute> vZBc !AW  
-bU oCF0  
如果tag的某个属性不是必须的,那tag处理类会自动提供一个缺省值。 /ID?DtJ  
x>Jr_A(  
例如,在logic:present这个tag标签中定义了一个属性叫parameter,但它不是必须的,而且它可以被诸如<%= …%>的表达式来赋值。 GbaEgA'fa  
Y"wUt &  
<tag> x UD-iSY  
qZA).12qS  
<name>present</name> `FC(  
Kc^;vT>3  
<tag-class>org.apache.struts.taglib.logic.PresentTag</tag-class> LoGVwRmoC  
Y(cGk#0  
<body-content>JSP</body-content> #&7}-"Nd  
2m2;t0  
=7o"u3hG  
?%y?rk <  
<attribute> ) v,:N.@Q  
Ck|8qUz-  
<name>parameter</name> !U~WK$BP  
$ <#KA3o\  
<required>false</required> 8M`#pN^  
HF.^ysI  
<rtexprvalue>true</rtexprvalue> >:|q&|x-  
E}tqQ*u  
</attribute> ' >rw(3  
q+vx_4  
I=NZokfS  
xcf%KXJf6  
</tag> oGRhnP'PF+  
M )2`+/4  
mFZ?hOyP.  
属性元素的校验 ]V#M%0:Q82  
9^p;UA  
4BKI-;v$  
有关于tag标签的有效值可以从tag库的说明文档中获得,当JSP页面被编译时,jsp引擎会强制性地参照TLD中定义的规则进行检查。 \<)9?M :  
4zo5}L `Y  
还有一个方法也可以进行属性元素的校验,就是先继承类TagExtraInfo,然后调用它的isValid方法。这个类同时也起到提供tag中定义的脚本变量信息的作用。 6<ZkJ:=  
2j[&=R/.  
IsValid方法通过TagData对象来传递属性信息,它包括着tag的所有的属性名-值的信息。由于校验发生在运行时刻,因此这个属性的值将被赋值为TagData.REQUEST_TIME_VALUE。 aWY gR  
!! ? Mw  
例如tag标签<tt:twa attr1=”value1” />在TLD中定义如下: BFOq8}fX2  
jE/AA!DC#  
<attribute> }-sdov<<  
+qwjbA+  
<name>attr1</name> Pw61_ZZ4B\  
@>U-t{W  
<required>true</required> KSN Pkd6  
N D2L_!g:(  
<rtexprvalue>true</rtexprvalue> H?X|(r|+  
<>aw 1WM+  
</attribute> ={xE!"  
7 !JQB  
WV_.Tiy<  
这个定义说明了attr1能在运行期间被赋值。 *N<&GH(j  
O|M{-)  
以下的isValid方法检查attr1属性的值是否属于Boolean类型。注意由于attr1能在运行刻被赋值,那么isValid方法必须检查tag用户是否对此tag进行了运行时刻赋值。 BjzPz  
.ODR]7{  
>\Ww;1yV  
Public class TwaTEI extends TagExtraInfo O6G0  
SV~~Q_U9  
{ T]=r Co  
+lMX{es\O  
public boolean isValid(Tagdata data) Y1J=3Y  
A"rfZ`  
{ E`uY1B[c  
e!=kWc  
Object o = data.getAttribute(“attr1”); 4Q6mo/=H  
d*%`!G  
If(o != null && o != TagData.REQUEST_TIME_VALUE) 9uA>N  
]h %Wiw  
{ R'@9]99  
#odIEC/  
if( ( (String)o).toLowerCase().equals(“true”) || 20nP/ e  
 O2%?  
((String)o).toLowerCase().equals(“false”) ) :1bWVM)  
DRi<6Ob  
return true; LBa[:j2  
3 C<L  
else cZ2kYn 8  
[CXrSST")E  
return false; b KN@j'M  
<yH4HY  
} J.xPv)1'  
*=I}Qh(1  
else #/<&*Pu5t  
U5.LDv;  
return true; >^*+iEe  
M 4?ig}kh  
} 5MtLT#C3r  
vbC\?\_  
} W1|0Yd ;P  
jGpN,/VQa  
Tw;3_Lj  
带body的tag ([m mPyp>L  
O4V.11FnW  
ne_TIwfw-  
tag处理类 e(GP^oK  
9E"vN  
O%5 r[  
如果tag标签含有内容,那处理方式会略微有些不同,而且还要视tag处理类是否要与body交互的情况而定。如果要与body交互,那我们认为tag处理类要可能要对body进行操作。 &N\jG373  
qfMo7e@6*  
Tag处理类不与body交互 [8*jw'W|[  
^!<BQP7  
如果tag处理类不与body交互,tag处理类应该实现Tag接口或从TagSupport中派生,如果body要被计算,那么doStartTag方法应返回 EVAL_BODY_INCLUDE,否则应返回SKIP_BODY。 j;-1J_e5  
?-dX`n  
如果tag处理类要对body反复运算,则它应该实现IterationTag或从TagSupport中派生。如果tag处理类认为body还未计算完的话,那它的doStartTag方法和doAfterBody方法必须返回EVAL_BODY_AGAIN。 6&!PmKFO.  
Pu*6"}#~  
Tag处理类与body交互 lY?QQ01D  
Ne[7gxpu  
如果tag处理类与body交互,那tag处理类应实现BodyTag接口或从BodyTagSupport中派生。这种tag处理类一般要实现doInitBody和doAfterBody方法。 K|hjEQRv  
F|e1"PkeoA  
Body允许一些方法来读写它的内容。Tag处理类可以调用body内容的getString或getReader方法来从body中提取信息,也可用 writeOut(out) 方法来将body的内容写入到out对象中。其中out对象通过tag处理类的getPreviousOut方法来获得。 #\ X#w<\?  
rp!oO>F  
如果body的内容需要被计算,那么doStartTag方法必须返回EVAL_BODY_BUFFERED,否则,它将返回 SKIP_BODY。 4hTMbS_;  
noml8o  
doInitBody 方法 HiR[(5vnf  
{^7Hgg  
此方法在body内容已经设好,但未被计算之前被调用。你可以根据不同的body内容来制定初始化策略。 5BlR1*  
?7.7`1m !v  
doAfterBody方法 eOs)_?}  
H?&Mbw d  
此方法在body内容已被计算后进行调用。 ~l]ve,W[  
mR?5G: W~R  
和doStartTag方法一样,doAfterBody方法返回一个指示符指示是否要继续计算body,如果要继续计算,则doAfterBody应返回EVAL_BODY_BUFFERED,否则,它应返回SKIP_BODY。 9NQlI1W z4  
5#+^E{  
release 方法 !y@NAa0  
XH}\15X  
tag处理类调用此方法将它的状态重置为初始状态,并释放所有的私有资源。 |ZRagn30  
lFV N07hG  
6i.-6></  
以下的例子读取body的内容(其中含有一条sql语句),然后将它传递给一个对象,让它进行查询。由于此处body不须重新计算,所以doAfterBody会返回SKIP_BODY。 j/_ s"}m{  
o4K ~  
e :%ieH<  
Public class QueryTag extends BodyTagSupport w1OI4C)~  
5 ft`zf  
{ 117EZg]O  
&3J_^210  
public int doAfterBody() throws JspTagException uao0_swW5  
o7sT=x9  
{ ->y J5smtY  
}NzpiY9  
BodyContent bc = getBodyContent(); ZaV8qAsP  
['B?i1 .  
//将body的内容以字符串的格式提取出来 &:dH,  
Q;43[1&3w  
String query = bc.getString(); gy 3i+J  
 a1t4Dd  
//清除body P3)Nl^/  
X\@C.H2ttY  
bc.clearBody(); YkniiB[/  
w35J.zn  
try{ {f2S/$q  
w[S pw<Z  
Statement stmt = connection.createStatement(); ^=RffrlZU  
=u2l. CX  
Result result = stmt.executeQuery(query); ]yx$(6_U  
@` 1Ds  
}catch(SQLException e){ *E/`KUG]  
{=!b/l;@  
throw new JspTagException(“queryTag: “ + e.getMessage() ); QLEKsX7p>  
ktFhc3);!  
return SKIP_BODY; k@f g(}6  
OwH81#   
} t<z`N-5*  
c#Sa]n  
} q_g+Jf P-D  
)4gJd? 8R  
6@{(;~r  
body-content元素 LcSX *MC  
[y'f|XN  
723bkJw V  
由于tag可能会有body,你必须用body-content元素来指定body内容的类型: 3=FZ9>by  
snf~}:&   
<body-content>JSP|tagdependent</body-content> rV R1wsaL  
A: 5x|  
.TND  a&  
如果body的内容是定制的或内部的tag、脚本元素、或HTML广本,则归类为JSP类型。其他的类型,比如上面代码所述的?D?D将sql statement类传给 query tag的这种类型应该标为tagdependent。 mpI5J'>]  
^S UPi  
注意:实际上body-content的值并不影响tag处理类对body内容的处理,它仅仅是被tag编辑工具用来描述此body的内容。 b&~4t/Vq  
]b7zJUz  
Bm.:^:&k  
用tags定义脚本变量 #fM#p+v  
`e}bdj  
ftvG\Tf  
tag处理类 ~sl{|E  
=vDEfO/T  
w+#C-&z  
tag处理类负责创建或设置页面中定义的脚本变量,用pageContext.setAttribute(name,value,scope)或pageContext.setAttribute(name,value)方法来实现。一般来说,tag处理类通过脚本变量的名称来获取它,脚本变量的名称一般可用get方法来获得。 a(kg/s  
@SJL\{_  
如果脚本变量的值依赖于tag处理类中的上下文中某一对象,那它可用pageContext.getAttribute(name,scope)方法来找到那个对象。一般的处理过程是tag处理类先找到脚本变量,再对其进行处理,然后用pageContext.setAttribute(name,object)的方法来设置它的新值。 tiB_a}5IB  
4)h]MOZ  
对象的生存周期(scope)如下表: )Dw,q~xgg0  
8\^}~s$$A  
对象的生存周期表 V5sg#|&  
=j5MFX.-o  
名字 -Zf@VW,NI  
可访问范围 ;aI[=?<x  
生存周期 6*B19+-  
 [F0s!,P  
page ~$:|VHl  
当前页面 &x[E;P*Fg  
一直有效,除非页面向客户提交响应或重定向到一个新页面 }!"A!~&  
P&9Gga^I  
request v 1z  
当前页面或当前页面重定向到的页面 \K@'Z  
一直有效,除非页面向客户提交响应 Cjqklb/  
iop2L51eJ  
session C([phT;  
当前页面或在同一浏览器窗口中的页面 3L833zL  
一直有效,除非关闭当前浏览器、超时、网络故障 e+$p9k~  
+$C 4\$t  
application 8jd;JPz@\  
整个web应用程序的所有请求 P `}zlml  
一直有效,除非发生网络故障、服务器故障 %QH)'GJQ  
|Y$uqRdV  
提供关于脚本变量的信息 *)ardZV${  
M m[4yP%  
以下示例定义了一个名为“book”的脚本变量,用来访问程序中关于书的信息: 8oUpQcim  
.y_/Uwu  
<bean:define id=”book” name=”bookDB” property=”bookDetails” type=”database.BookDetails” /> R:e<W/P"  
hd>aZ"nm1  
<font color=”red” size=”+2” > _/uFsYC  
K/tRe/t }  
<%= messages.getString(“CartRemoved”) %> SB1upTn  
@.b+av4J  
<strong><jsp:getProperty name=”book” property=”title” /></strong> ])|d"[ur=  
//T>G_1  
</font> )PG6gZYW  
T]t+E'sQ  
当包含此tag的JSP页面被编译时,jsp引擎会自动生成关于此book的同步的代码(同步可以避免几个客户同时访问此book时造成的冲突),要生成同步代码,jsp引擎需要知道此脚本变量的如下信息: A )^`?m3  
 J7=+  
· 脚本变量名称 IE;~?W"  
_hRcc"MS`  
· 脚本变量所属的类 f!oT65Vmi  
%+8F'&X  
· 此脚本变量是否引用了一个新的或已存在的对象 P_?gq>E8  
';TT4$(m  
· 此脚本变量的有效性 b8V~S'6VqO  
tZ} v%3  
有两种办法可以向jsp引擎提供关于脚本变量的信息:在TLD中定义variable子元素,或用tei-class子元素定义一个额外tag信息类。用variable最简单,但可能降低了一些灵活性。 w[9|cgCY  
Bg&i63XL$$  
Variable元素 /2UH=Q!x4E  
;A|-n1e>Hc  
Variable元素有如下子元素: |B'9\OkP[=  
qUjmB sB  
· name-given ?D?D 给出的名字,是一个常量 ;3d"wW]}7K  
FME3sa$  
· name-from-attribute?D?D 属性名,在编译时给出的属性名 >TOu|r  
+W:= e,=  
name-given或name-from-attribute两者必须选一,但以下子元素是可选的:  {Or;  
%MrWeYd1  
· variable-class?D?D变量的类型,缺省为java.lang.String。 0'V5/W  
)2V:  
· declare?D?D此脚本变量是否引用了一个新对象,缺省为True。 KNS.Nw7  
jX3,c%aQ5e  
· scope?D?D脚本变量的范围,缺省为NESTED。下表描述了scope的几种类型: *of3:w  
JRSSn]pw  
脚本变量的有效范围 19O,a#{KHf  
$^OvhnL/  
=+U `-J} g  
有效性 ue4Vcf  
方法 0J?~N`#O|  
Y' %^NP}o  
NESTED G?E oPh^m  
在tag标签的开始和结束之间 ~aMlr6;  
如果tag处理类实现BodyTag接口,则在doInitBody和doAfterBody中调用,否则在doStartTag中调用 :uWw8`  
v}1QH  
AT_BEGIN eZ|%<Wpu  
从tag标签的开始一直到页面结束 \hBG<nH{0  
如果tag处理类实现BodyTag接口,则在doInitBody、doAfterBody和doEndTag中调用,否则在doStartTag和doEndTag中调用 NdL,F;^  
}._eIx"  
AT_END A6:es_  
从tag标签的结束一直到页面结束 3pv4B:0  
在doEndTag中调用 jp0<pw_  
r30 <(nF  
以struts为例,它的bean:define标签的实现遵循JSP1.1规范,此规范要求使用额外tag信息类来定义脚本变量。Variable元素是JSP1.2规范中加入的。以bean:define标签为例,你可以定义如下variable元素: <\NY<QIwFw  
-j73Wz  
<tag> G]+&!4  
k`0>36  
<variable> A%`[mc]4#  
( M7pT  
<name-from-attribute>id</name-from-attribute> x|mqL-Q f  
<_3b1VhZ  
<variable-class>database.BookDetails</variable-class> |&FkksNAl\  
wQe_vY  
<declare>true</declare> c lNkph  
R{ a"Y$  
<scope>AT_BEGIN</scope> Q^ pmQ  
lTd #bN  
</variable> x 7~r,x(xM  
rW+ =,L  
</tag> H-~6Z",1  
=&,]Z6{ >  
额外tag信息类 +pR[U4$  
kuol rfGB  
如果要定义一个额外tag信息类,你要继承javax.servlet.jsp.TagExtraInfo类。一个TagExtraInfo类必须实现getVariableInfo方法,此方法返回一个叫VariableInfo的数组类,它包括如下信息: ;?8_G%va  
tS|(K=$  
· 变量名 fjU8gV  
N'g>MBdI  
· 变量所属类名 c2&q*]?l;  
<)u`~$n2  
· 此变量是否引用了一个新对象 5qr'.m  
b]x4o#t  
· 此变量的有效范围 W0l,cOOZJ  
WN01h=1J_  
jsp引擎将一个名为data的参数传给getVariableInfo方法,data中包括tag标签中的所有“属性名?D?D属性值”对。它可以用来向VariableInfo对象提供脚本变量的名字和类名。 %KmiH ;U  
u/M+u;  
以struts为例,它在bean:define标签中定义了一个名为DefineTei的额外tag信息类,用来向脚本变量提供信息。由于脚本变量的名称(book)和类名(database.BookDetails)是通过tag标签的属性来传递的,它们一般定义在VariableInfo的构建代码中,并且可用data.getAttributeString方法来得到这些信息。如果要允许book脚本变量能在从tag开始直到整个JSP页面结束的范围内都可用的话,那它的范围应设为AT_BEGIN。如下所示: So0f)`A  
qMLD)rL  
yls ^cyX  
public class DefineTei extends TagExtraInfo v#.r.{t  
7 T1=q{#M  
{ -?mfE+kt  
Z/t+8;TMR,  
public VariableInfo[] getVariableInfo(TagData data)  #`o2Z  
qNYN-f~@,  
{ 4"(<X  
S" xKL{5  
String type = data.getAttributeString(“type”); R:#k%}W  
C}_ ojcR  
If( type == null) hRs&t,{&  
 CCL   
type = “java.lang.Object”; QKr,g  
^~3SSLS4"  
return new VariableInfo[] { a>GyO&+Dkg  
4|CtRF<L  
new VariableInfo(data.getAttributeString(“id”), %`r?c<P}  
=zKhz8B(  
type, ApAO/q  
:E:38q,hG  
true, yt.F\[1  
y~F,0"N\r  
VariableInfo.AT_BEGIN) *XT/KxLa7  
FQqI<6;  
}; 4<k9?)~(J  
/+@p7FqlE  
} }Q=!Y>Tc  
X4 A<[&F/  
} q U]gj@R  
kzt(i Y_6  
<})2#sZO!  
注意:关于额外tag信息类的类名必须要在TLD中的tag标签下的tei-class子元素中定义。因此,DefineTei的tei-class中的定义看起来如下: 9Hf9VC3   
<tei-class> v"#mzd.tW  
org.apache.struts.taglib.bean.DefineTagTei )?X-(4  
</tei-class> yF"1#{*y  
4`!Z$kt  
Jo@|"cE=  
具有协作关系的tag no< ^f]33  
@>W(1mRi  
Z@]e{zO  
tag通过共享对象来进行协作,JSP技术支持2种方式的对象共享。 [3{W^WSOz  
cd$m25CxC  
第一种方法是使用pageContext对象进行对象的共享(可支持JSP页面和tag处理类之间的共享),如果在一个tag处理类中要调用由另一个tag处理类创建的对象,可调用pageContext.getAttribute(name, scope)方法。 a{ ?`t|  
{TX]\ufG  
第二各方式的共享是对于tag之间有嵌套关系而言的,外层的tag所创建的对象对于内层的tag来说是可以共用的。这种形式的共享的好处是减少了可能存在的重名冲突。 %F-ZN^R  
!V i@1E  
要访问一个嵌套tag创建的对象,tag处理类必须先找到此嵌套tag对象,可用TagSupport的静态方法 TagSupport.findAncestorWithClass(from, class)或TagSupport.getParent方法。前者在当不确定此tag是否为嵌套tag对象时使用。一旦它的父类被找到,它就能访问其所有动态或静态创建的对象。静态创建的对象是父类的成员,而动态创建的对象可能是父类的私有对象。诸如此类的对象可以用tag处理类的setValue方法来保存,用getValue方法来获得。 ">y%iE  
[Pq}p0cD  
下例阐述了以上两种共享对象的方法。在这个例子当中,一个查询tag检查一个名为connection的属性名是否在doStartTag中被设置。如果connection属性被设置,tag处理类从pageContext中得到这个connection对象。否则,此tag处理类先找到它的父tag处理类,然后从它的父tag处理类中找到connection对象。 |MFF7z{%  
a2 Y;xe  
o]; [R  
public class QueryTag extends BodyTagSupport ;#oie< Vit  
`Ye\p6v!+  
{ <8d^^0  
<N_+=_  
private String connectionId; IE9 XU9Kd  
W9D86]3Y  
public int doStartTag() throws JspException j( RWO  
j^^Ap  
{ DDPxmuNG  
hvDNz"ec{  
String cid = getConnection(); `kZ@Zmj#  
DGAX3N;r6{  
if(cid != null) c6X}2a'  
l zYnw)Pv  
{ 6P5Ih  
?34 e-  
//存在一个connection id,使用它。 iVy7elT;R  
V`bi&1?6\  
connection = (Connection) pageContext.getAttribute(cid); 5A sP5  
,!7 H]4Qx  
} 1e&QSzL  
$`z)~6'  
else (UU(:/  
iy14mh\ ~  
{ ?i06f,-  
`eIenA  
ConnectionTag ancestorTag = (ConnectionTag)findAncestorWithClass(this, X&0 uI*r  
RV5n,J  
ConnectionTag.class); 1Dv R[Lx%  
p' +  
if(ancestorTag == null) ds?v'|  
lJE93rXU  
{ 59O?_F9  
WIv?}gi: X  
throw new JspTagException(“一个没有connection属性的查询标签必须被一个connection标记嵌套。”); =y/8 ^^  
i1>- QDYnJ  
} a^=-Mp  
3WUTI(  
connection = ancestorTag.getConnection(); ($}`R xj1@  
Vzwc}k*Y  
}  Fl1;;F  
= Wu *+paQ  
} bZ|FnY}FB  
UmQ?rS8d  
} 6bBB/yd  
t=-SH^$SR  
1$%V{4bJ  
^sVX)%  
此查询标签在JSP页面中的调用形式可以从以下2种定义中任选一种: 76Vl6cPu>  
Er+nk`UR_  
@ ]/AjjLt  
<tt:connection id=”con01” ...> ... </tt:connection> %Mk0QKzUo  
/ew Ukc8,  
<tt:query id=”balances” connection=”con01” > }w1~K'ck}>  
QoG cWJ  
SELECT account, balance FROM acct_table 1;mW,l'`  
72oF,42y  
where customer_num = <%= request.getCustno() %> p\JfFfC  
%5A+V0D0'  
</tt:query> mL_j4=ER@  
%YSu8G_t  
C@bm  
o]p|-<I Q  
|Tm!VFd  
<tt:connection ...> ]Yvga!S"C  
H<}^'#"p  
<x:query id=”balances”> ;uW}`Q<  
tPGJ<30  
SELECT account, balance FROM acct_table \l.-eu'O  
vh*U]3@  
where customer_num = <%= request.getCustno() %> 4qYUoCR&  
I;Bjfv5  
</x:query> UGuxV+Nwf  
x >^Si/t  
</tt:connection> QCX8IIHG  
cdG |m[  
kjtjw1\o  
与此同时,在TLD中必须指定connection属性为可选的,定义如下: OBP1B@|l$+  
w );6K[+;  
<tag> aOiR l,  
tc!wLnhG  
... m/qbRk68s  
/Ne<V2AX  
<attribute> W@Lu;g.Yc  
?HV`| Cw  
<name>connection</name> !Z5[QNVaV  
h<SQL97N  
<required>false</required> Ko/ I#)  
]s GHG^I6  
</attribute> K%X^n>O7C  
D*YM[sN`  
</tag>
描述
快速回复

您目前还是游客,请 登录注册
欢迎提供真实交流,考虑发帖者的感受
认证码:
验证问题:
10+5=?,请输入中文答案:十五