标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记!
TqbKH08i/ M;Vx[s,#, 一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。
&5d>jEaB} ol`]6"Sc 在这篇文章中,我们主要讨论:
$ HUCp9 =:a3cr~ · 什么是自定义tag标签?
pM
VeUK? |Q:`:ODy`5 · 怎么使用tag标签?
@~gz-l^$ wRie{Vk o 声明要使用的tag库
I/^Lr_\ _TX.}167;- o 找到与之对应的tag处理类
;utjW1y ',1rW o tag标签的类型
G0*$&G0nb ,sLV6DM · 自定义tag标签
VJr?`
eY4 A0[flIl o tag处理类
yobi$mnsy!
2EE#60 o tag库描述
.2Rh_ful * rs_k/2( o tag标签示例
UJ6WrO5#kB NWNgh/9? o 带属性的tag
i!,>3 g?@(+\W o 带body的tag
Z.R^@@RqJ <,cD EN7 o 定义了脚本变量的tag
8@$QN4^u^ $rjv4e}7 o 具有协作关系的tag
@[JQCQ#r D% 50 · 自定义tag标签
n7{c0;)$ +JQN=nTA o 一个迭代tag的例子
^Y'>3o21f ;wvVhQ o 一个模板tag库
CF>NyY:_ zSq+#O1# o tag处理类到底是怎样被调用的?
ZGp8$Y>r ~KX!i
8+X C(gH}N4 什么是自定义的tag?
LTa9'
q0 ^AEg?[q 一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。
O~xc>
w ?^@;8m 自定义tag标签有很多特色,诸如:
^R2:Z&Iv% 8} S|iM · 可以在JSP页面中自定义tag标签的属性
0Z@u6{Z9R .Wa6?r<g · 访问JSP页面中的所有对象
r<bg->lX sjzZl*GSy · 可以动态地修改页面输出
`#l_`j=r$ AalyEn&> · 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。
2#py>rF(
2=U4'C4# · tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。
naAZR*(A @h$7C< o!j? )0d 使用tag标签
`|]juc e+&/Tq'2 b9"Q.*c<Z^ 本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。
~>qcV=F^d, *d)B4qG 要使用tag标签,JSP程序员必须做2件事:
3tgct <" -o=qYkyLK · 声明此tag标签的tag库
G:A`
n;E0 &}*[-z · 实现此tag标签
.Z9Bbab: :x16N|z 声明tag标签所在的tag库
U?.VY@ $e0sa=/ 如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明)
J/)Q{*`_ SVeL c <%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %>
ZfIQ Fh> t*n!kXa uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。
[x9eamJ,H ?n[+0a:8E TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。
QCMt4`%'u bY]aADv\ 以下taglib指示符直接引用一个TLD:
y/
vE 2}hEBw68 <%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %>
fF<~2MiKw z,$^|'pP 以下的taglib指示符通过一个逻辑名称间接地引用一个TLD:
!.kj-==s{7 h\:"k_u# <%@ taglib uri=”/tutorial-template” prefix=”tt” %>
NouT~K`' [&"`2n 如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素:
_18) XR /2WGo- <taglib>
1XL^Zhr $xNZ.|al <taglib-uri>/tutorial-template</taglib-uri>
"){"{~ 51l : <taglib-location>
E%2]c?N5 -=@d2LY /WEB-INF/tutorial-template.tld
HZ )z^K?1 o yK'h9Wt1 </taglib-location>
"! m6U#^
Jf9a<[CcV </taglib>
i=nd][1n 5{L~e>oS9 PsaKzAg? 实现此tag标签
E WrIDZi #;z;8q mA@FJK_
为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。
Xq@Bzya kZ>_m&g
E{k$4 tag标签类型
.J"QW~g^ [0qe ?aI x8
_f/2& 自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点):
%68'+qz @IhC:Yc <tt:tag>
c#(Hh{0 X6*4IE body
<hvs{}TS Ra)wlIx </tt:tag>
%<8`(Uu5 SMoJKr(:w# '
Dcj\=8 一个不带body的tag标签如下:
>mJH@,F: q=(%
]BK <tt:tag />
& %A&&XT9
h!=h0 2. '` mGu 简单的tag标签
& OYo ,.9k)\/V 一个没有body和属性的tag标签如下:
UE8j8U'L @GUlw[vi <tt:simple />
ZP{<f~; +`,;tz=? `>)[UG!:| 带属性的tag标签
2Pow-o*r )G#mC0?PV /|q.q 自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。
ysapvQN_6 VWq]w5oQO 你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值:
'_d4[Olu 5EU~T.4C< <loglic:present parameter = “Clear”>
7UIf {Y-~7@ 而另一个标签logic:iterate是用表达式来给属性赋值:
0FSN IPx E75/EQ5p]p <logci:iterate collection=”<%= bookDB.getBooks() %>”
[ ?%q,>F \~RDvsSD id=”book” type=”database.BookDetails”>
!iO2yp @}=(4% jr,N+K(@T 带body的tag标签
m g,1*B' I4W@t4bZ 一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。
4
km^S9 Q$uv
\h; 在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息:
85YUqVi9 `78Bv>[A <logic:present parameter=”Clear”>
@-}*cQ4u? d]poUN~x <% cart.clear(); %>
AtewC
Yo LH)XD[ <font color=”#ff0000” size=”+2”><strong>
*,mI=1 ]}dQ~lOE 你选择了清除购物车!
h);^4cU XEQTT D< </strong></font>
rUpe ;c _Ao$)Gu) </logic:present>
(J[Xryub Hs*["zFc H T|DT 到底是用属性还是用body来传递信息?
yL*]_ 4q E95THB 如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。
Y8zTw`:V 1>"-!ADm <%HRs>4 定义脚本变量的tag标签
G@.MP|
2 TWzLJ63* 所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等:
CuWJai:nQ; &^r>Q`u
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” />
gxN>q4z 51SmoFbMz <% tx.begin(); %>
<.Ws; HN} >>
zd ...
q0iJy@?A 8.i4QaU KNUK]i&L 具有协作关系的tag标签
64<;6* L5-|-PP|; 自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。
dE7S[O TaN{xpo <tt:tag1 attr1=”obj1” value1=”value” />
yO q@w!xz 4f([EV[6dK <tt:tag2 attr1=”obj1” />
%GHGd'KO& U[@y8yN6M 在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。
m^k0j/ ?13qDD: <tt:outerTag>
BmG(+;;& k, HC"?K <tt:innerTag />
xT%`"eM} rmiOeS`: </tt:outerTag>
UFG_ZoD+ K#0TD(" "8xAe0-4 Tag处理类
8]ZzO(=@{
.Q{RTp A&Y5z[p Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。
`*C=R
_
c0oHE8@ 当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。
LQ jbEYp Smr{+m a 下表说明不同类型的tag所需要不同的处理过程:
5(3O/C{?~ -U d^\Yy Tag处理类的方法
]~({;;3o- Mo,&h?VOM? Tag标签类型
0l!#u`cCI 所调用的方法
g!'R}y -(qRC0V 基本标签
LeKovt% doStartTag, doEndTag, release
`o[l%I\Q |9CikLX)7 带属性的标签
rUiYR]mV doStartTag, doEndTag, set/getAttribute1...N, release
T] zEcx+e =]Wi aF 带内容的标签
0MG>77 doStartTag, doEndTag, release
b)LT[>f 3S^0%"fY 带内容的标签,且内容重复循环
=>jp\A doStartTag, doAfterBody, doEndTag, release
eqbN_$> T(b9b,ov) 带内容的标签,且内容与JSP交互
@60D@Y doStartTag, doEndTag, release, doInitBody, doAfterBody, release
aurs~ {/'T:n# 一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。
j4.wd
RK dbI>\khI 如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。
}>A
q<1% 7=!9kk 0 一般情况都将所有的tag处理类打成了JAR的包,以便于发布。
'xwCeZcg k3~9;Z $[gN#QW% Tag库描述(简称TLD)
hXW` n*Zw B`*,L\LZ* i+_LKHQN Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。
5/meH[R\M \Wbmmd}8 TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。
?t#wK}d. Q;h.}N8W 一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如:
e+
xQ\LH ,_[x|8m <?xml version="1.0" encoding="ISO-8859-1" ?>
K1&
QAXyP hW^,' m <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "
http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
NvR{S /Z TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表:
+H)'(< r*X,]\V0x B9v>="F <taglib>的子元素
aSL`yuXu k+<945kC Element
pLMt2G Description
Oy6fl'FIt ,:_c-d# tlib-version
Q&9yrx. Tag库的版本
0I}e>]:I eA!o#O. jsp-version
9shfy4?k Tag库所需要的jsp的版本
]hl*6 b 2gng} short-name
sI ,!+ 助记符,tag的一个别名(可选)
JA^o/%a^ ZsmOn#`=^} uri
.@1+}0 用于确定一个唯一的tag库
4{VO:(geZ *~rj!N?; display-name
fFQ|dE;cF 被可视化工具(诸如Jbuilder)用来显示的名称(可选)
GES}o9?# k,h602( small-icon
9&mSF0q 被可视化工具(诸如Jbuilder)用来显示的小图标(可选)
mHD_cgKN [Nyt0l "z large-icon
1.hWgW DP 被可视化工具(诸如Jbuilder)用来显示的大图标(可选)
l|5 h k.J%rRneN description
/dnwN7Gf 对tag库的描述(可选)
)"?4d[ 5 z8kO)' listener
m/HT3<F 参见下面listener元素
bS_#3T )^(*B6;z5 tag
uvys>]+ 参见下面tag 元素
1 ZdB6U0 U(&c@u% Listener元素
PyeNu3Il4 -I< >Ab 一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。
.i0K-B '
jciX]g Tag元素
q'3{M]Tk (;NJ<x 每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。
UQVL)-Z 4pmeu:26 每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素:
z]7 WC h]7_
N, Tag元素的子元素
T,38Pu@r !R{IEray 元素名称
HU0.)tD 描述
e=amh CEfqFn3^ name
DP_b9o
\5 独一无二的元素名
'|yx B') s{^98* tag-class
R'c*CLaiE Tag标签对应的tag处理类
"1o{mvCkR pwSgFc$z tei-class
RB>=#03 javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选)
D?Oe";"/ $<*) 5|6 body-content
nnlj# Tag标签body的类型
e02Hf{eOfw J+D|/^ display-name
uYW4$6S3 被可视化工具(诸如Jbuilder)用来显示的名称(可选)
4:MvC^X~z RhYe=Qh4{p small-icon
zDFNx:h 被可视化工具(诸如Jbuilder)用来显示的小图标(可选)
+.cpZqWn3 1UQ,V`y large-icon
0nc(2Bi 被可视化工具(诸如Jbuilder)用来显示的大图标(可选)
C T~6T&' *F$@!ByV description
?XKX&ws 此tag标签的描述
n%Oi~7> Iv6 lE:) variable
=DwLNyjU4 提供脚本变量的信息(同tei-class)(可选)
<ZT
C^=3 {7y;s attribute
We6eAP /Z Tag标签的属性名
WZa6*pF v^A+LZ*d
以下章节介绍对于不同类型的tag,如何具体地实现它们。
z|s(D<*w sRB=<E*_ V|Bwle 简单的tag
dv+Gv7&2/ %/dOV[/ (KI9j7 tag处理类
$Sc _E:`] 1dvP2E 简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。
9hr7+fW]t coCT]< 以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下:
Jp jHbG loA/d H&-3`< public SimpleTag extends TagSupport
AojL4H| 8K4^05*S {
H*]Vs=1 ~vTwuc\(H public int doStartTag() throws JspException
-!!]1\S*Y G]h_z|$K {
RUY7Y? R;HE{q[ f try{
,h=a+ja8 {Q>OZm\+ pageContext.getOut().print(“Hello.”);
vom3C9o L9jT:2F }catch(Exception e){
NL]_;\ h pW+uVv, throw new JspTagException(“SimpleTag: “ + e.getMessage());
yeyDB>#Va. Bq$IBAot }
s[GHDQ;! lEl.'X$ return SKIP_BODY;
ezw*Lo! af<h2r }
KBM*7raA P;"moluE; public int doEndTag()
WVD48}HF- (:8a6=xQ {
OPN\{<`*d D\M"bf>q1 return EVAL_PAGE;
~QSX 1w" 7;+G)44 }
6):1U mrr]{K }
HW]?%9a WzstO}?P( G_?U?:!AC 注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如
I;Mm +5A U',C-56z <body-content>empty</body-content>
p _[,P7 :pM8Q1:B _cvX$(Sg 带属性的tag标签