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

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

级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记! 2;Ij~~  
#}/YnVk  
一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。 3fS+,>s\O  
gEVN;G'B<=  
在这篇文章中,我们主要讨论: _I$\O5  
7~2b4"&  
· 什么是自定义tag标签? (vq0Gl  
tgy= .o]  
· 怎么使用tag标签? @a08*"lbp  
2yu\f u  
o 声明要使用的tag库 _vQtV]  
%SG**7  
o 找到与之对应的tag处理类 z|w@eQ",  
dM%#DN8 l  
o tag标签的类型 39xAh*}G]  
)ZU)$dJ>V  
· 自定义tag标签 K3uNR w  
#kO.'oIl  
o tag处理类 z=}@aX[  
BT|5"b}  
o tag库描述 Q>jx`68'KI  
~uF%*  
o tag标签示例 Htg,^d 5  
O]"3o,/]G  
o 带属性的tag =J2\"6BnzA  
:ET05MFs\#  
o 带body的tag cR/-FR  
K,uTO7Mk[  
o 定义了脚本变量的tag wT;3>%Mtr  
3?x4+ b  
o 具有协作关系的tag 6}Se$XMl  
]bjXbbHd  
· 自定义tag标签 FtaO@5pS54  
k<1BE^[V  
o 一个迭代tag的例子 DB1GW,  
0q|.]:][Eo  
o 一个模板tag库 Fap@cW3?8  
BoJYP  
o tag处理类到底是怎样被调用的? >k:BG{$Kae  
IO,ddVO  
v!\\aG/  
什么是自定义的tag? <M(Jqb cWa  
{o2pCH  
一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。 AOT +4*)%  
p$>e{-u  
自定义tag标签有很多特色,诸如: _/@VV5Mq  
F\' ^DtB  
· 可以在JSP页面中自定义tag标签的属性 mN5`Fct*A>  
WD wW`  
· 访问JSP页面中的所有对象 <78]OZ] Z  
X67.%>#3  
· 可以动态地修改页面输出 ]}4{|& e  
wv.FL$f[@  
· 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。 udRum7XW 3  
u/`jb2eEU:  
· tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。 yc./:t1at>  
 3kAmRU  
?^F*M#%?  
使用tag标签 K k 5 vC{  
H+^93  
4'&j<Ah[#  
本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。 ]zGgx07d  
X bF;  
要使用tag标签,JSP程序员必须做2件事: OYcf+p"<\  
JfJUOaL  
· 声明此tag标签的tag库 +-b:XeHSZ  
?y.q<F)  
· 实现此tag标签 h8IjTd]z{$  
"qL4D4  
声明tag标签所在的tag库 [iJU{W  
Hwr# NKz-  
如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明) kbqG)  
t;[L-|^  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> RR2Q  
k=t\  
uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。 5F@7A2ZR  
)XB31^  
TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。 O]ZP- WG  
' 0iXx   
以下taglib指示符直接引用一个TLD: nWTo$*>W  
W$&kOdD!$  
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %> Au+SCj  
g[VVxp!C<  
以下的taglib指示符通过一个逻辑名称间接地引用一个TLD: R5`"~qP-  
it=4cHT  
<%@ taglib uri=”/tutorial-template” prefix=”tt” %> }*WNrS">S  
ftVA  
如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素: %bM^/7  
rlj @ '  
<taglib> ;]ojfR=?%  
"=cWcztiP  
<taglib-uri>/tutorial-template</taglib-uri> SU0K#:  
L nQm2uF  
<taglib-location> B{fPj9Y0  
ldjypEa}  
/WEB-INF/tutorial-template.tld T[mo PD5  
!PN;XZ~{  
</taglib-location> *?/9lAm  
^i3~i?\,P  
</taglib> K".\QF,:  
GF6c6TXF@  
2?3D` `  
实现此tag标签 ;^5d^-T  
yNY *Fl!  
C$X )I~M  
为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。 @(XX68  
 &Gp~)%  
x+j5vzhG)  
tag标签类型 t`b>iX%(1t  
->DfT*)  
IUX~dO  
自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点): Vp =  
1}#(4tw)  
<tt:tag> kV@*5yc?R  
cswX?MN  
body FhJ8}at+e  
l26DPtWi  
</tt:tag> j M%qv  
Cm:&n|  
lO482l_t  
一个不带body的tag标签如下: ,vBi)H  
SK2nxZOH  
<tt:tag /> #q{i<E 07  
az7<@vSXi  
9Y:JA]U&8  
简单的tag标签 GO@pwq<  
iz'#K?PF_  
一个没有body和属性的tag标签如下: z/bJDSQ  
#(o 'G4T  
<tt:simple /> !!Tk'=t9"3  
0 S3~IeJ  
gi::?ET/.  
带属性的tag标签 \>0F{-cR$  
pg3B^  
?!H <V@a  
自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。 \tc`Aj%K  
&FrW(>2  
你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值: ;IhkGPpWP  
Fs q=u-= :  
<loglic:present parameter = “Clear”> QJFx/zU  
6&(gp(F  
而另一个标签logic:iterate是用表达式来给属性赋值: M[5zn  
<y${Pkrj  
<logci:iterate collection=”<%= bookDB.getBooks() %>” ien >Ou  
@:$zReS2  
id=”book” type=”database.BookDetails”> |CME:;{T  
lf3:Z5*&>  
@;>TmLs  
带body的tag标签 uVoM2n?D%^  
5MJ`B: He+  
一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。 w7Nb+/,sg  
.Z=D|&!  
在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息: h,Y MR3:X  
L]{ 1"`#  
<logic:present parameter=”Clear”> A8JEig 3Ix  
7p"" 5hw  
<% cart.clear(); %> s&S8P;K|  
l" y==y  
<font color=”#ff0000” size=”+2”><strong> AL/`Pqlk  
1nh2()QI[  
你选择了清除购物车! HjTK/x'_'L  
/kLX f_  
</strong></font> ;EP]A3  
@F_#d)+%>  
</logic:present> RYMOLX84  
J-lQPMI,  
ARYqX\-e  
到底是用属性还是用body来传递信息? 5q[0;`J  
q_Td!?2?  
如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。 2Up1 FFRx  
;$W/le"Xr  
+O23@G?x  
定义脚本变量的tag标签 jyF0asb  
(;=:QjaoZ  
所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等: X&._<2  
LP bZ.  
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” /> (j-[m\wF  
L{$ZL&  
<% tx.begin(); %> >b;fhdd:4  
E^S[8=  
... jnFCt CB  
B\&;eZY'G  
~:ddTv?F  
具有协作关系的tag标签 Sc "J5^  
S5ka;g  
自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。 Xz5 aTJ&  
gP.Q_/V  
<tt:tag1 attr1=”obj1” value1=”value” /> T{M~*5$  
DB'pRo+U  
<tt:tag2 attr1=”obj1” /> }J t( H  
4cK6B)X  
在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。 UJkg|eu  
d,au&WZ;_  
<tt:outerTag> c_xtwdkL9  
TDg#O!DUF  
<tt:innerTag /> }~dXz?{p8  
' >[KVvm  
</tt:outerTag> Mn+;3qo{6  
BDY@&vF  
}x4,a6^  
Tag处理类 ,J?Hdy:R  
-}k'a{sj=  
Ee>P*7*jB  
Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。 h+|3\>/@9{  
DsY-JBDvoz  
当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。 MGIpo[  
TEOV>Tt  
下表说明不同类型的tag所需要不同的处理过程: ~*D)L'`2M  
e!yUA!x`u  
Tag处理类的方法 v=?U{{xQ  
MjC;)z  
Tag标签类型 Ky`rf}cI>  
所调用的方法 +=%13cA*U  
[w l:"rm  
基本标签 ^z3-$98=A  
doStartTag, doEndTag, release Ltpd:c  
C,C%1  
带属性的标签 qOz,iR?}  
doStartTag, doEndTag, set/getAttribute1...N, release F?'=iY<h  
zmy94Y5PE  
带内容的标签 J=>?D@K  
doStartTag, doEndTag, release eSXt"t  
I ,Q"<? &  
带内容的标签,且内容重复循环 >L/Rf8j&  
doStartTag, doAfterBody, doEndTag, release !o &+  
k%#`{#n i  
带内容的标签,且内容与JSP交互 VtF^; f  
doStartTag, doEndTag, release, doInitBody, doAfterBody, release }(O/y-  
!_s|h@  
一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。 hNUAwTH6  
^[XxE Lx  
如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。 5gW`;Cdbyc  
hb9X<N+p  
一般情况都将所有的tag处理类打成了JAR的包,以便于发布。 u8 14ZN}  
%*P59%  
o#E 3{zM  
Tag库描述(简称TLD) L7mN&Xr  
\Q{@AC<?i  
qEKTSet?  
Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。 R|H9AM ~E  
<5/r  
TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。 h{.KPK\  
2}]6~i  
一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如: AY:3o3M  
8 f%@:}H  
<?xml version="1.0" encoding="ISO-8859-1" ?> ` 1DJwe2  
?RvXO'ml  
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> )F&@ M;2p'  
TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表: =If% m9  
 }5bh,'  
{rGq|Bj  
<taglib>的子元素 Vn? %w~0!  
I"@X~Y7}  
Element y|q4d(P.  
Description d9|dHJf  
#/@U|g  
tlib-version ([UuO}m-  
Tag库的版本 AL! ^1hCF  
c&)H   
jsp-version $G5m/[KDI  
Tag库所需要的jsp的版本 `|wH=  
,Ihuo5>/z  
short-name [6BL C{2  
助记符,tag的一个别名(可选) /7*jH2  
lO8.Q"mxo  
uri F1R91V|  
用于确定一个唯一的tag库 5/DTE:M<  
k);z}`7  
display-name 8,YF>O&  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) ]R}#3(]1  
&T]+g8''  
small-icon b>E%&sf  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) o^4qY  
KM 4w{  
large-icon ~X5yHf3  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) +,7dj:0S  
c a_N76o!  
description m{!BSl  
对tag库的描述(可选) )V JAs|  
?+GbPG~  
listener +-'qI_xo  
参见下面listener元素 C!XI0d  
rfYu8-  
tag c }ivYH?`w  
参见下面tag 元素 ,oIZ5u{#,  
+@]1!|@(  
Listener元素 n<8$_?-  
mLk@&WxG  
一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。 H#k"[eZ  
9 f-T>}  
Tag元素 swG^L$r`  
xj{X#[q):  
每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。 "Na9Xea  
O 4N_lr~  
每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素: J><O 51  
L;nRI.  
Tag元素的子元素 52m^jT Sx  
?Li^XONz  
元素名称 ]?-56c,  
描述 T =3te|fv  
jp8=>mk  
name m<8j' [+  
独一无二的元素名 Jl Q%+$  
yr&oJYM  
tag-class YC&iH>jO3  
Tag标签对应的tag处理类 ~D@ V@sX  
% %c0UaV  
tei-class kBIF[.v(\  
javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选) 0o At=S  
fj0+a0h  
body-content i0-!!  
Tag标签body的类型 j6Jz  
=t@m:  
display-name ~0ZEnejy  
被可视化工具(诸如Jbuilder)用来显示的名称(可选) D\(,:_ge  
78+H|bH8  
small-icon *IGxa  
被可视化工具(诸如Jbuilder)用来显示的小图标(可选) =d~]*[8  
ifTVTd7O  
large-icon |rdG+ >  
被可视化工具(诸如Jbuilder)用来显示的大图标(可选) &-<"HW  
wuzz Wq  
description $@x3<}X;  
此tag标签的描述 aZ@4Z=LK  
s%GiM  
variable 68FxM#xR  
提供脚本变量的信息(同tei-class)(可选) 6xdu}l=%  
"1%<IqpU+  
attribute "x\3`Qk  
Tag标签的属性名 _QvyFKAM  
gK(E0p"  
以下章节介绍对于不同类型的tag,如何具体地实现它们。 XYod>[.x  
l]WV?^*  
hNDhee`%6  
简单的tag (N;Jw^C@  
(&x~pv"+  
?[RG8,B  
tag处理类 vR,HCI  
hp-< 8Mf  
简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。 ,z1# |Y  
W:(:hT6`j9  
以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下: MF 5w.@62X  
@KOa5-u  
82$By]Y9  
public SimpleTag extends TagSupport eoEb\zJ  
{6 #3`  
{ x ?^c:`.  
$nn~K  
public int doStartTag() throws JspException <g*rTqT'  
M|n)LyL  
{ %M}zi'qQ?  
rFx2 S  
try{ /4_}wi\  
*N>Qj-KAM_  
pageContext.getOut().print(“Hello.”); =7e8N&-nv  
^]U2Jd  
}catch(Exception e){ !-N!8 0  
iS=T/<|?  
throw new JspTagException(“SimpleTag: “ + e.getMessage()); @;rVB  
/;OJ=x3i  
} N"r ;d+LTL  
_'I9rGlx3  
return SKIP_BODY; '')G6-c/  
7y[B[$P  
} _Fz )2h,3  
Ku&(+e  
public int doEndTag() ,1~Zqprn  
//J:p,AF  
{ ]G1j\wnF  
t<`ar@}  
return EVAL_PAGE; HhqqJEp0  
DVB:8"Bu  
} (S2<6Nm8  
hJ}G5pX  
} !?l 23(d  
+vU.#C_2  
>p<( CVX[  
注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如 OW-+23)sj  
F)gL=6h  
<body-content>empty</body-content> Qb(CH  
Rw/G =zV@2  
ED?s[K  
带属性的tag标签
评价一下你浏览此帖子的感受

精彩

感动

搞笑

开心

愤怒

无聊

灌水
级别: 终身会员
发帖
3743
铜板
8
人品值
493
贡献值
9
交易币
0
好评度
3746
信誉值
0
金币
0
所在楼道
只看该作者 1 发表于: 2007-01-01
tag处理类 BMdr.0  
mdZELRu  
对于tag标签的每个属性,你必须依照JavaBeans规范来定义其属性,以及get和set方法。以struts的logic:present 标签为例, qnA:[H;F  
#-@{rgH  
<logic:present parameter=”Clear”> JfVay I=  
<;XJ::d  
与此相应,此tag处理类应有如下方法和定义: ] !A;-m  
K[ \z'9Q  
hV,3xrm?P  
protected String parameter = null; *jJ62-o  
VLO>{"{'  
public String getParameter() kEXcEF_9P  
p0tv@8C>  
{ v4v+;[a%  
\;?\@vo<  
return this.parameter; t{ 7l.>kf  
b~Ruhi[E  
} ]Yj>~k:K  
Gg!))I+  
public void setParameter(String parameter) jNyC%$  
.Yf h*  
{ 9.@(&  
fC-^[Af)  
this.parameter = parameter; p;5WLAF  
b9Y pUm7#  
} +p[~hM6?  
gO/(/e>P  
eyE&<:F#J  
注意:如果你的属性名为id,而且你的tag处理类是从TagSupport类继承的,那你就不需要定义它的属性和set和get方法,因为他们早已在TagSupport被定义过了。 uVk8KMYU  
\ bhok   
Attribute元素 QB.7n&u  
]u,~/Gy  
对于tag标签的每个属性,你必须定义它是否必须的,它的值是否可以用诸如<%= …%>的表达式来获得,以及它的类型(可选),如果不指定它的类型,那就默认为是java.lang.String类型。如果rtexprvalue元素被定义为true或yes,那么在type元素中就定义了attribute的返回类型。 /Mk)H d  
YL. z|{\e  
<attribute> y H'\<bT  
~"wD4Ue  
<name>attr1</name> nY8UJy}<oL  
J~}UG]j n  
<required>true|false|yes|no</required> )s8r(.W  
F#PJ+W*h  
<rtexprvalue>true|false|yes|no</rtexprvalue> ,qfa,O  
y{"E) YY  
<type>attribute的返回类型(只用当rtexprvalue为真是才有效)</type> vr  vzV  
RasoOj$  
</attribute> U;nC)'~YW9  
Ax%BnkU  
如果tag的某个属性不是必须的,那tag处理类会自动提供一个缺省值。 NV gLq@F  
~mp$P+M(%p  
例如,在logic:present这个tag标签中定义了一个属性叫parameter,但它不是必须的,而且它可以被诸如<%= …%>的表达式来赋值。 3(&.[o Z  
K]u|V0c  
<tag> Lg?'1dg  
~h@tezF  
<name>present</name> U<t-LF3  
5_`}$"<~  
<tag-class>org.apache.struts.taglib.logic.PresentTag</tag-class> em]K7B=  
K$ &wO.  
<body-content>JSP</body-content> W"*R#:Q  
f8 ja Mn9o  
-hzza1DP  
4 * OU  
<attribute> Gw./qu-W  
\1!k)PZdTW  
<name>parameter</name> ;1dz?'%V  
/'1y`j<  
<required>false</required> ZFON]$Zk  
! lF^~x  
<rtexprvalue>true</rtexprvalue> :qbG%_PJ  
VMWg:=~$  
</attribute> }"-r;i  
|rvrSab)  
A!D:Kc3  
jQb D2x6(  
</tag> Z C93C7lJ  
/kz&9FM  
d.AjH9 jg  
属性元素的校验 9yh@_~rZ  
r83~o/T@  
!7oy%{L  
有关于tag标签的有效值可以从tag库的说明文档中获得,当JSP页面被编译时,jsp引擎会强制性地参照TLD中定义的规则进行检查。 {X$Mwqhpp;  
 SoX V  
还有一个方法也可以进行属性元素的校验,就是先继承类TagExtraInfo,然后调用它的isValid方法。这个类同时也起到提供tag中定义的脚本变量信息的作用。 mig3.is  
X W)A~wPBs  
IsValid方法通过TagData对象来传递属性信息,它包括着tag的所有的属性名-值的信息。由于校验发生在运行时刻,因此这个属性的值将被赋值为TagData.REQUEST_TIME_VALUE。 78)^vvn5~  
k~#|8eLv  
例如tag标签<tt:twa attr1=”value1” />在TLD中定义如下: Q8x{V_Pot  
a%!XLyq  
<attribute> ^{s0d+@{  
~Z2eQx jtM  
<name>attr1</name> =dBrmMh  
:#}`uR,D/  
<required>true</required> a,~P_B|@  
m'tk#C  
<rtexprvalue>true</rtexprvalue> 50&F#v%YB  
+][P*/Ek  
</attribute> $at|1+bQ  
udFju&!W  
pG @iR*?  
这个定义说明了attr1能在运行期间被赋值。 vI'>$  
~-`02  
以下的isValid方法检查attr1属性的值是否属于Boolean类型。注意由于attr1能在运行刻被赋值,那么isValid方法必须检查tag用户是否对此tag进行了运行时刻赋值。 Bs?F*,zDJ  
E<uOk  
QZr<=}   
Public class TwaTEI extends TagExtraInfo 9C;Y5E~'L  
3(+#^aw  
{ r%pFq1/'!  
6t:c]G'J  
public boolean isValid(Tagdata data) 'I]"=O,  
]5f M?:<l  
{ ts<dUO  
j\f$r,4  
Object o = data.getAttribute(“attr1”); *]WXM.R8  
LFyceFbm  
If(o != null && o != TagData.REQUEST_TIME_VALUE) l7,qWSsn K  
Zk UuniO  
{ uR@`T18  
Qiw4'xQm  
if( ( (String)o).toLowerCase().equals(“true”) || 7[BL 1HI*  
|nN/x<v  
((String)o).toLowerCase().equals(“false”) ) io7U[#  
C-u/{CP  
return true; Ok&>[qu  
HY;?z `=  
else +[/47uFbI  
-5 /v`  
return false; ~[TKVjyO  
*"FLkC4  
} 2?iOB6  
%:KV2GP  
else vQ mackY  
!`[I>:Ex  
return true; 8 QF?W{NK  
\.P}`Bpa  
} G*i#\   
5jV97x)BGx  
} :IVMTdYf  
o?K|[gNi  
Ln2C#Uf  
带body的tag t* vg]Yc  
Nu/Qa:H_{  
|8 2tw|<o  
tag处理类 >B/&V|E  
jne9=Als5  
6BU0hV  
如果tag标签含有内容,那处理方式会略微有些不同,而且还要视tag处理类是否要与body交互的情况而定。如果要与body交互,那我们认为tag处理类要可能要对body进行操作。 mqk(UOK`  
' P`p.5nH  
Tag处理类不与body交互 yj'' \  
` .(S#!gw  
如果tag处理类不与body交互,tag处理类应该实现Tag接口或从TagSupport中派生,如果body要被计算,那么doStartTag方法应返回 EVAL_BODY_INCLUDE,否则应返回SKIP_BODY。 \h7J/es^p!  
Mp"ci+Iu  
如果tag处理类要对body反复运算,则它应该实现IterationTag或从TagSupport中派生。如果tag处理类认为body还未计算完的话,那它的doStartTag方法和doAfterBody方法必须返回EVAL_BODY_AGAIN。 =+}}Sv2  
BrH;(*H)8  
Tag处理类与body交互 w2N3+Tkg  
>xV<nLf/  
如果tag处理类与body交互,那tag处理类应实现BodyTag接口或从BodyTagSupport中派生。这种tag处理类一般要实现doInitBody和doAfterBody方法。 &rztC]jF  
R P:F<`DB|  
Body允许一些方法来读写它的内容。Tag处理类可以调用body内容的getString或getReader方法来从body中提取信息,也可用 writeOut(out) 方法来将body的内容写入到out对象中。其中out对象通过tag处理类的getPreviousOut方法来获得。 !Vr45l  
=j+oKGkoCa  
如果body的内容需要被计算,那么doStartTag方法必须返回EVAL_BODY_BUFFERED,否则,它将返回 SKIP_BODY。 Ge:-|*F  
6~h1iY_~  
doInitBody 方法 M1 ]6lg[si  
x*&&?nV Iz  
此方法在body内容已经设好,但未被计算之前被调用。你可以根据不同的body内容来制定初始化策略。 zLw h6^?Y  
6!%d-Z7)  
doAfterBody方法 b^,Mw8KsO  
x)VIA]  
此方法在body内容已被计算后进行调用。 ;5Vk01R  
+yb$[E*  
和doStartTag方法一样,doAfterBody方法返回一个指示符指示是否要继续计算body,如果要继续计算,则doAfterBody应返回EVAL_BODY_BUFFERED,否则,它应返回SKIP_BODY。 M&djw`B  
s>@#9psm  
release 方法 2Cd --W+=  
6"Lsui??  
tag处理类调用此方法将它的状态重置为初始状态,并释放所有的私有资源。 ~26s7S}  
%rDmW?T  
'+!S|U,{  
以下的例子读取body的内容(其中含有一条sql语句),然后将它传递给一个对象,让它进行查询。由于此处body不须重新计算,所以doAfterBody会返回SKIP_BODY。 O/Mz?$8J  
W]D`f8r9  
{nPkb5xbW  
Public class QueryTag extends BodyTagSupport u@bOEcxK  
=F %wlzF:  
{ YKe0:cWc  
85|95P.<  
public int doAfterBody() throws JspTagException Naf`hE9  
!*?(Q6  
{ O:,2OMB}B`  
a\&(Ua  
BodyContent bc = getBodyContent(); Ukx/jNyYv  
Ztyv@z'/Z  
//将body的内容以字符串的格式提取出来 qBBYckS.  
I#S~  
String query = bc.getString(); !q-:rW? c  
we\b]  
//清除body 2JA&{ch  
%<wQ  
bc.clearBody(); u3M` 'YCb  
^\ vfos  
try{ n=G>y7b  
BK(pJNBh  
Statement stmt = connection.createStatement(); c3zT(FgO>N  
/m Q2;*|  
Result result = stmt.executeQuery(query); }+{*, z  
y '_V/w s  
}catch(SQLException e){  hmBnV  
\za5:?[xB  
throw new JspTagException(“queryTag: “ + e.getMessage() ); ?Rt 1CDu  
x0u?*5-t  
return SKIP_BODY; of+phMev  
&ppE|[{  
} 7O8V1Tt  
/OhaERv  
} ]Z.<c$  
m]0^  
!bZhj3.  
body-content元素 |D;"D  
ZSF=  
hy$MV3LP  
由于tag可能会有body,你必须用body-content元素来指定body内容的类型: z;bH<cQ  
~'^!udF-  
<body-content>JSP|tagdependent</body-content> :7$\X[  
;&+[W(7Sy  
Sv~YFS :oy  
如果body的内容是定制的或内部的tag、脚本元素、或HTML广本,则归类为JSP类型。其他的类型,比如上面代码所述的?D?D将sql statement类传给 query tag的这种类型应该标为tagdependent。 @ate49W  
<+? Y   
注意:实际上body-content的值并不影响tag处理类对body内容的处理,它仅仅是被tag编辑工具用来描述此body的内容。 2fkIdy#n@  
j8[`~p b  
'R4>CZ%jV  
用tags定义脚本变量 1Lm].tq  
I~p8#<4#b  
Y!Uu173  
tag处理类 P Pwxk;  
+  ZR(  
C.yY8?|  
tag处理类负责创建或设置页面中定义的脚本变量,用pageContext.setAttribute(name,value,scope)或pageContext.setAttribute(name,value)方法来实现。一般来说,tag处理类通过脚本变量的名称来获取它,脚本变量的名称一般可用get方法来获得。 `ICcaRIN8I  
<qbZG}u  
如果脚本变量的值依赖于tag处理类中的上下文中某一对象,那它可用pageContext.getAttribute(name,scope)方法来找到那个对象。一般的处理过程是tag处理类先找到脚本变量,再对其进行处理,然后用pageContext.setAttribute(name,object)的方法来设置它的新值。 8!u/   
tC2 )j7@  
对象的生存周期(scope)如下表: `a9k!3_L  
[cGt  
对象的生存周期表 5i!V}hE  
_`bS[%CJ  
名字 Y<p zy8z  
可访问范围 pu/m8  
生存周期 F=oHl@  
[2GXAvXsT  
page M1AZ}b c0]  
当前页面 :DZLjC  
一直有效,除非页面向客户提交响应或重定向到一个新页面 -`zG_]=-  
0Jm]f/iZ  
request M&uzOK+  
当前页面或当前页面重定向到的页面 *.kj]BoO  
一直有效,除非页面向客户提交响应 Cz'xGW{  
]j& FbP)3  
session +M44XhT  
当前页面或在同一浏览器窗口中的页面 `pP9z;/Xq  
一直有效,除非关闭当前浏览器、超时、网络故障 o"'iX UJ  
%B#hb<7}  
application Z |2E b*  
整个web应用程序的所有请求 &mh Ln4^  
一直有效,除非发生网络故障、服务器故障 N4I^.k<-A  
<A#5v\{.;~  
提供关于脚本变量的信息 G_V.H \w  
JQ*D   
以下示例定义了一个名为“book”的脚本变量,用来访问程序中关于书的信息: r_4T tP&UW  
jA4PDHf+  
<bean:define id=”book” name=”bookDB” property=”bookDetails” type=”database.BookDetails” /> 2Ryp@c&r^  
uew0R;+oa  
<font color=”red” size=”+2” > ;EK(b  
-L@]I$Yo  
<%= messages.getString(“CartRemoved”) %> x  S   
>?S\~Y  
<strong><jsp:getProperty name=”book” property=”title” /></strong> x Z|&/Ci  
= y?#^  
</font> h6g=$8E  
|n+ #1_t%  
当包含此tag的JSP页面被编译时,jsp引擎会自动生成关于此book的同步的代码(同步可以避免几个客户同时访问此book时造成的冲突),要生成同步代码,jsp引擎需要知道此脚本变量的如下信息: j.k@6[ R>?  
jmkRP"ZnA  
· 脚本变量名称 C= >B_EO  
q&u$0XmV  
· 脚本变量所属的类  qovQ9O  
$ I#7dJ"*  
· 此脚本变量是否引用了一个新的或已存在的对象 HDyQzCG,  
48wDf_<f5=  
· 此脚本变量的有效性 YV*b~6{d  
j._G7z/LJ  
有两种办法可以向jsp引擎提供关于脚本变量的信息:在TLD中定义variable子元素,或用tei-class子元素定义一个额外tag信息类。用variable最简单,但可能降低了一些灵活性。 ;5<P|:^  
|}Q( F+cL  
Variable元素 Af`z/:0<  
W&<g} N+  
Variable元素有如下子元素: $v FrUv  
{5SfE$r  
· name-given ?D?D 给出的名字,是一个常量 ft{W/ * +_  
a]`itjL^  
· name-from-attribute?D?D 属性名,在编译时给出的属性名 /Z:N8e  
ir]Mn.(Y  
name-given或name-from-attribute两者必须选一,但以下子元素是可选的: <#>Oy&E  
"cwR^DoD&  
· variable-class?D?D变量的类型,缺省为java.lang.String。 f:xUPH?+  
mj)PLZ]  
· declare?D?D此脚本变量是否引用了一个新对象,缺省为True。 L*P_vCC  
}qG#N  
· scope?D?D脚本变量的范围,缺省为NESTED。下表描述了scope的几种类型: ,aI,2U91  
!&W|myN^  
脚本变量的有效范围 ~ 9=27 p  
3Q",9(D  
h9)RJSF4  
有效性 F@9Y\. ,  
方法 pqJ)G;%9  
jM*AL X  
NESTED |Td_S|:d  
在tag标签的开始和结束之间 n<E.Em1  
如果tag处理类实现BodyTag接口,则在doInitBody和doAfterBody中调用,否则在doStartTag中调用 pL~=Z?(B  
VO9XkA7  
AT_BEGIN [KMS<4t'  
从tag标签的开始一直到页面结束 *MI)]S  
如果tag处理类实现BodyTag接口,则在doInitBody、doAfterBody和doEndTag中调用,否则在doStartTag和doEndTag中调用 vEF=e  
SWT:frki`  
AT_END r]9e^  
从tag标签的结束一直到页面结束 TaOOq}8c#  
在doEndTag中调用 9[kX/#~W*  
e|VJ9|;3  
以struts为例,它的bean:define标签的实现遵循JSP1.1规范,此规范要求使用额外tag信息类来定义脚本变量。Variable元素是JSP1.2规范中加入的。以bean:define标签为例,你可以定义如下variable元素: :.DI_XN`  
d4J<,  
<tag> +I&J7ICV0  
r]0(qg  
<variable> `0?^[;[u[  
9<v}LeX  
<name-from-attribute>id</name-from-attribute> sW?B7o?  
3EmcYC  
<variable-class>database.BookDetails</variable-class> HM):"  
y<|)'(  
<declare>true</declare> h`lmC]X _  
lcCJ?!lsSW  
<scope>AT_BEGIN</scope> AQe!Sqg'  
lj*8mS/;h  
</variable> X($6IL6m  
$~=2{  
</tag> Y xJ`-6  
v{.\iIg N  
额外tag信息类 -Un=T X  
uWTN 2jr  
如果要定义一个额外tag信息类,你要继承javax.servlet.jsp.TagExtraInfo类。一个TagExtraInfo类必须实现getVariableInfo方法,此方法返回一个叫VariableInfo的数组类,它包括如下信息: '6X%=f'^b  
<PioQ>~  
· 变量名 Q3,=~}ZNK  
8[M* x3  
· 变量所属类名 `dO}L  
".E5t@ }?m  
· 此变量是否引用了一个新对象 ) \ 4 |  
jXWNHIl)@  
· 此变量的有效范围 pisB,wP$2  
7 W{~f?Sh  
jsp引擎将一个名为data的参数传给getVariableInfo方法,data中包括tag标签中的所有“属性名?D?D属性值”对。它可以用来向VariableInfo对象提供脚本变量的名字和类名。 #d% vT!Bz~  
g ?V&mu  
以struts为例,它在bean:define标签中定义了一个名为DefineTei的额外tag信息类,用来向脚本变量提供信息。由于脚本变量的名称(book)和类名(database.BookDetails)是通过tag标签的属性来传递的,它们一般定义在VariableInfo的构建代码中,并且可用data.getAttributeString方法来得到这些信息。如果要允许book脚本变量能在从tag开始直到整个JSP页面结束的范围内都可用的话,那它的范围应设为AT_BEGIN。如下所示: EI\v  
k-Fdj5/  
q`[K3p   
public class DefineTei extends TagExtraInfo {y b D  
sQtf,e|p  
{ 5DOE3T`^Oc  
oIR.|=Hk{  
public VariableInfo[] getVariableInfo(TagData data) <BPRV> 0X  
4>YU8/Rw  
{ ]~8v^A7u  
U*qNix  
String type = data.getAttributeString(“type”); sMm/4AY]  
ZBJ3VK  
If( type == null) -w~(3(  
Q&PB]D{  
type = “java.lang.Object”; MRs,l'  
$/paEn"  
return new VariableInfo[] { _88QgThb  
Y\p $SN  
new VariableInfo(data.getAttributeString(“id”), FsY(02  
qg4fR' i  
type, 5B{k\H;  
l4 "\) ];  
true, Y208b?=9w  
Sdx Y>;  
VariableInfo.AT_BEGIN) l{5O5%\,  
4\6: \  
}; q{E"pyt36R  
` 8UWE {  
} x@m<Ym-  
j{;|g%5t  
} ) * TF"  
9U^$.Lb  
$O9Xx  
注意:关于额外tag信息类的类名必须要在TLD中的tag标签下的tei-class子元素中定义。因此,DefineTei的tei-class中的定义看起来如下: $KX[Zu%  
<tei-class> EZib1g&:R/  
org.apache.struts.taglib.bean.DefineTagTei 7~b!4x|Z  
</tei-class> ru{f]|  
mM5|K@0|  
nJT4w|Yx  
具有协作关系的tag JUQg 'D  
94{)"w]  
X V=S )  
tag通过共享对象来进行协作,JSP技术支持2种方式的对象共享。 M3(k'q7&:  
T4r5s  
第一种方法是使用pageContext对象进行对象的共享(可支持JSP页面和tag处理类之间的共享),如果在一个tag处理类中要调用由另一个tag处理类创建的对象,可调用pageContext.getAttribute(name, scope)方法。 NR4Jn?l{  
~+HoSXu@E  
第二各方式的共享是对于tag之间有嵌套关系而言的,外层的tag所创建的对象对于内层的tag来说是可以共用的。这种形式的共享的好处是减少了可能存在的重名冲突。 sx5r(0Z  
kXwi{P3D$  
要访问一个嵌套tag创建的对象,tag处理类必须先找到此嵌套tag对象,可用TagSupport的静态方法 TagSupport.findAncestorWithClass(from, class)或TagSupport.getParent方法。前者在当不确定此tag是否为嵌套tag对象时使用。一旦它的父类被找到,它就能访问其所有动态或静态创建的对象。静态创建的对象是父类的成员,而动态创建的对象可能是父类的私有对象。诸如此类的对象可以用tag处理类的setValue方法来保存,用getValue方法来获得。 TJOvyz`t  
WeC(w+}p  
下例阐述了以上两种共享对象的方法。在这个例子当中,一个查询tag检查一个名为connection的属性名是否在doStartTag中被设置。如果connection属性被设置,tag处理类从pageContext中得到这个connection对象。否则,此tag处理类先找到它的父tag处理类,然后从它的父tag处理类中找到connection对象。 w!`Umll2  
k)":v3 ^  
-;pOh;WG  
public class QueryTag extends BodyTagSupport ?z=\Ye5x  
U =cWmH  
{ QU/3X 1W  
tg85:  
private String connectionId; NfwYDY  
c!Dc8=nE0m  
public int doStartTag() throws JspException xU}M;4kH~  
73 V"s  
{ }Hy ~i  
XoItV  
String cid = getConnection(); VVuR+=.&  
i8~ r  
if(cid != null) JE!("]&  
=_PvrB2'  
{ )X5(#E  
EGS%C%>l/o  
//存在一个connection id,使用它。 = .`jjDJ  
J`oTes,  
connection = (Connection) pageContext.getAttribute(cid); }U[-44r:  
!M;A*:-  
} jG D%r~lN  
(}gcY  
else _%ZP{5D>  
V1utUGJV  
{ 2dbRE:v5  
6I|A- h  
ConnectionTag ancestorTag = (ConnectionTag)findAncestorWithClass(this, J%Mnjk^_\S  
Z]vL%Gg*!  
ConnectionTag.class); /P+q}L %  
qn"K9k  
if(ancestorTag == null) M{G xjmdx  
sLns3&n2  
{ o8z)nOTO;  
q`Q}yE> 9  
throw new JspTagException(“一个没有connection属性的查询标签必须被一个connection标记嵌套。”); Y~qb;N\  
\VN=Ef\E  
} 3z[ $4L'.  
@`|)Ia<  
connection = ancestorTag.getConnection(); Q2s&L]L=  
c tI{^f:  
} 't (O$  
U.oksD9 v  
} CXaWgxlK:a  
9U_ks[Qa  
} "MOpsb,  
eVz#7vqv   
</~ 6f(mg  
Zj9c9  
此查询标签在JSP页面中的调用形式可以从以下2种定义中任选一种: C*kK)6v `  
Kuw^qX"  
ocRdbmS  
<tt:connection id=”con01” ...> ... </tt:connection> @cvP0A  
` }gbc69  
<tt:query id=”balances” connection=”con01” > PX O!t]*  
>t+ qe/  
SELECT account, balance FROM acct_table W<b-r^9?s  
]ya; v '  
where customer_num = <%= request.getCustno() %> RrV>r<Z"Q  
'S4)?Z  
</tt:query> '0aG N<c  
}d Ad$^  
K?.e|  
U>qHn'M  
Qs 2.ef?  
<tt:connection ...> <, @%*G1-  
#J\rv'  
<x:query id=”balances”> *|:Q%xr-  
7L(e h7  
SELECT account, balance FROM acct_table  J m{  
^_5|BT@  
where customer_num = <%= request.getCustno() %> &Z("D7.G  
n{5NNV6  
</x:query> m?CZQq,  
4mYCSu14:`  
</tt:connection> ?8V UO x  
np$ zo  
#=c`of6  
与此同时,在TLD中必须指定connection属性为可选的,定义如下: ^q[gxuL_  
`FF8ie8L  
<tag> D)b}f`  
s'HD{W`  
... db72W x0>  
a$11PBi[9  
<attribute> 0HeD{TH\  
\.{AAj^qD  
<name>connection</name> v({N:ya  
%Q"(/jm?  
<required>false</required> e79KbLV  
LO%!Z,}   
</attribute> o @Z#  
}M>r E  
</tag>
描述
快速回复

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