标准的JSP 标记可以调用JavaBeans组件或者执行客户的请求,这大大降低了JSP开发的复杂度和维护量。JSP技术也允许你自定义taglib,其实换句话说,taglib可以看成是对JSP标记的一种扩展,正如xml是对html的一种扩展一样。taglib通常定义在tag标签库中,这种标签库存放着你自己定义的tag标签。简而言之,如果使用taglib,那么你可以设计自己的JSP标记!
N{t:%[ ~N^vE; 一般来说,自定义tag标签主要用于操作隐藏对象、处理html提交表单、访问数据库或其它企业级的服务,诸如邮件和目录操作等等。自定义tag标签的使用者一般都是那些对java编程语言非常精通,而且对数据访问和企业级服务访问都非常熟悉的程序员,对于HTML设计者来说,使得他可以不去关注那些较复杂的商业逻辑,而将精力放在网页设计上。同时,它也将库开发者和库使用者进行合理分工,自定义tag标签将那些重复工作进行封装,从而大大提高了生产力,而且可以使得tag库可用于不同的项目中,完美地体现了软件复用的思想。
\q|PHl NCFV 在这篇文章中,我们主要讨论:
&R*5;/
! &2=KQ\HO · 什么是自定义tag标签?
"D(8]EG= jYX9;C;J · 怎么使用tag标签?
!<zzP LC oQ nk+> }% o 声明要使用的tag库
Bq]O &>\hX #L:P
R> o 找到与之对应的tag处理类
s;7qNwYO =awO63j> o tag标签的类型
/^3oq] m8j-lNu · 自定义tag标签
5MY}(w oz6+rM6MY o tag处理类
F ssEs!# Y;F
R"~^ o tag库描述
`F\:XuY uQ]]]Z(H' o tag标签示例
6//FZ:q `uZv9I" o 带属性的tag
/cC6qhkp% 0nn]]B@l o 带body的tag
p_qm}zp
NS4'IR=;E! o 定义了脚本变量的tag
xY'qm8V -^4bA<dCCE o 具有协作关系的tag
R:OU>HsdX &s^>S?L- · 自定义tag标签
`XSc > 9jR[:[
o 一个迭代tag的例子
<cv2-?L{ Bd9hf`%2 o 一个模板tag库
Yuo1'gE+ d&T6p&V$ o tag处理类到底是怎样被调用的?
r7"A u" A!W"*WT (#B^Hyz! 什么是自定义的tag?
9c^skNbS 3> \fP#oQ 一个自定义的tag标签是用户定义的一种JSP标记。当一个含有自定义的tag标签的JSP页面被jsp引擎编译成servlet时,tag标签被转化成了对一个称为tag处理类的对象进行的操作。于是当JSP页面被jsp引擎转化为servlet后,实际上tag标签被转化成为了对tag处理类的操作。
,+/9K)X 3Wb2p'V7$? 自定义tag标签有很多特色,诸如:
=Etwa ]bN&5.| · 可以在JSP页面中自定义tag标签的属性
ri<'-w i P,/13tZ#3 · 访问JSP页面中的所有对象
3 "l
F 7mn,{2 · 可以动态地修改页面输出
] `B,L*m6 UOu6LD/|h · 彼此这间可以相互通信。你可以先创建一个JavaBeans组件,然后在一个tag中调用此JavaBeans组件,同时可以在另一个tag中调用它。
'EL || 7.$]f71z · tag允许相互嵌套,可以在一个JSP页面中完成一些复杂的交互。
u*26>. VZ2.w4b 0Q$~k 使用tag标签
Bn1L?>G R 5K-KSvW D(qHf9 本节主要描述怎样在JSP页面中使用tag标签,以及tag标签的不同类型。
18.Y/nZAgQ .>kccLr:z 要使用tag标签,JSP程序员必须做2件事:
gHvW
e Mr=}B6` · 声明此tag标签的tag库
:'d76pM- Mu'^OX82 · 实现此tag标签
|7QVMFZ -_2Dy1 声明tag标签所在的tag库
gb=80s0 ^V<J69ny|9 如果要使用tag标签,则应用JSP的taglib指示符来指定其tag库(注意:taglib要在在使用此tag标签之前声明)
O1?B{F/ e }c`
?0FQ <%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %>
5ys#L&q'Z WYwzo V- uri属性定义了唯一的标签库描述(以下简称TLD),它可以是直接是tld文件名或一个独一无二的名字。prefix是用来区别其它TLD中和本TLD中有重名的tag的一种手段。
Gva}J6{ *CeQY M TLD必须以.tld作为扩展名,并且存放在当前应用的WEB-INF目录或其子目录下。你可以通过它的文件名直接引用它,也可以通过别的方式间接地引用它。
J 16=!q() vIVw'Z(g} 以下taglib指示符直接引用一个TLD:
E\R raPkQT M5']sdR(l <%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %>
w::r?.9 FNz84qVIx' 以下的taglib指示符通过一个逻辑名称间接地引用一个TLD:
bbd0ocva >"cr-LB <%@ taglib uri=”/tutorial-template” prefix=”tt” %>
x*unye7 %<aImR] 如果是间接引用TLD的话,那你必须还要在web.xml中定义此逻辑名称与tld文件之间的映射,具体做法是在web.xml中加入一个名为taglib的元素:
DH\wDQ $Hp.{jw <taglib>
Q&u>7_, Du Hs[}l_gYn <taglib-uri>/tutorial-template</taglib-uri>
tCZpfZ@+= =QrA0kQR <taglib-location>
<^#P6 `]K,'i{R /WEB-INF/tutorial-template.tld
0SJ{@* + jp|Y?6Z </taglib-location>
%S{o5txo /GsSrP_?] </taglib>
&bB6}H( b\1+kB/8 'oC$6l'rQ 实现此tag标签
M} O[`Fx{W ;xSRwSNDi( yrO?Np 为了实现tag标签,你有2种方法来存放tag处理类。一、让tag处理类以.class的方式存放于当前应用的WEB-INF/class子目录下,二、如果tag处理类是以JAR包的形式存在的话,那可以放在当前应用的WEB-INF/lib目录下,如果tag处理类要在多个应用中共享,那么它就应放在jsp服务器上的common/lib目录下,对于tomcat来说,就是tomcat/common/lib目录下。
"YuZ fL`bb :tKbz
nd/ Tv`_n2J`2 tag标签类型
f4R1$(< w'd.; DeA @0HOxh 自定义的tag标签遵循XML语法。它有一个开始标记和一个结束标记,有的还有body(即文本节点):
R @"`~#$$ c+1vqbqHG <tt:tag>
{U(Bfe^a, PM@XtL7J body
9^oo-,Su_ :ezA+=ENg </tt:tag>
(%i!%{!] E\w+kAAf HH7[tGF 一个不带body的tag标签如下:
1x{XE*%; Y]~IY?I <tt:tag />
s}jlS w.tW=z5 #`vVgGZ& 简单的tag标签
\kxh#{$z? 0"TgLd 一个没有body和属性的tag标签如下:
kr#I{gF [1<(VyJ}ye <tt:simple />
Im6U_JsNZh C]/&vh7ta ^ZR8s^X 带属性的tag标签
6Hda]y 1f<RyAE?5 (X*9w##x( 自定义标签可以有自己的属性。属性一般在开始标记中定义,语法为 attr=”value”。属性的作用相当于自定义标签的一个参数,它影响着tag处理类的行为。你可以在TLD中详细定义它。
pOKeEW<q *y{+W 你可以用一个String常量给一个属性赋值,也可以通过表达式给它赋值,如<%= ...%>。以struts为例,它的logic:present标签就是用的String常量来给属性赋值:
ANotUty;y ~*,Wj?~+7 <loglic:present parameter = “Clear”>
+SyUWoM lO[E[c G 而另一个标签logic:iterate是用表达式来给属性赋值:
Y5n>r@)m r4EoJyt <logci:iterate collection=”<%= bookDB.getBooks() %>”
E.9^&E}PG S4)A6z$ id=”book” type=”database.BookDetails”>
|e:rYLxm: Mo_$b8i ]9s\_A9 带body的tag标签
9l#gMFknI o ~;M" 一个自定义标签可以包含其它自定义标签、脚本变量、HTML标记或其它内容。
\KCWYi] %;tJQ%6-.S 在下述例子中,此JSP页面使用了struts的logic:present标签,如果些标签定义了parameter=”Clear”的属性,则将清除购物车的内容,然后打印出一条信息:
~?CS_B * [T-*/}4$ <logic:present parameter=”Clear”>
QhsVIta G~(&3 <% cart.clear(); %>
|WBZN1W) Wa<-AZnh <font color=”#ff0000” size=”+2”><strong>
TVYz3~m :kt/$S^- 你选择了清除购物车!
^;4YZwW5w
jC4O` </strong></font>
UG # X/%p >P<'L4; </logic:present>
!UVk9 me:iQ.g G%$}WA]| 到底是用属性还是用body来传递信息?
@%:E } 8RU.}PD 如上所述,我们既可以通过属性,也可以通过body来传递信息。但一般来说,比较简单的类型,如字符串或简单表达式最好采用属性来传递信息。
@i{]4rk lv 9OfU7_m )T/J 定义脚本变量的tag标签
5#2jq<D y]
y9'5_ 所谓脚本变量,是指JSP中可以调用的变量或对象。它可由tag标签产生。以下示例阐述了一个tag标签定义了一个名为tx的由JNDI所定义的事务处理对象。脚本变量可以是ejb对象、事务、数据库连接等等:
i?x$w{co
w{r8kH <tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” />
<S&]$?`{Wi >8(jW <% tx.begin(); %>
vzG ABP h\FwgkJP ...
)P%4:P c;^A)_/ 9(Jy0]E~ 具有协作关系的tag标签
;?`@"YG) gvlFumg2 自定义tag标签之间可以通过共享对象来实现协作。在下述例子中,标签tag1创建了一个名为obj1的对象,在标签tag2仍可以重复使用obj。
N8QH*FX/F1 +|0 t <tt:tag1 attr1=”obj1” value1=”value” />
O+b6lg)q !=y Q)l2 <tt:tag2 attr1=”obj1” />
kP?_kMOx .6Fsw
在以下这个例子当中,如果外层的tag标签创建了一个对象,那么其内层的所有tag标签都可以使用这个对象。由于这样产生的对象没有一个指定的名字,那么就可以将少重名的冲突。这个例子阐述了一系列协作的嵌套对象。
^e%k~B^ YXRjx.srf <tt:outerTag>
>jKjh!`)!e "koo` J <tt:innerTag />
|T
y=7d , \%4|t,en </tt:outerTag>
EZ{\D!_Y "k, K ~@} LQ>$>A( Tag处理类
~of,,& *:S~C SBL+e]P Tag处理类必须实现Tag接口或BodyTag接口,不过现在一般都流行从TagSupport或BodyTagSupport类中继承,这些类或接口都可以在javax.servlet.jsp.tagext包中找到。
32^#RlSu8 +A\V ) 当JSP引擎看到自己的JSP页面中包含有tag标签时,它会调用doStartTag方法来处理tag标签的开头,调用doEndTag方法来处理tag标签的结束。
\4QH/e K~3Ebr 下表说明不同类型的tag所需要不同的处理过程:
Cm410 =b EBwK 7c Tag处理类的方法
E-F5y S (tEwXy Tag标签类型
D )gD< 所调用的方法
3HKxYvc C LD_M 3
P 基本标签
U{HML| doStartTag, doEndTag, release
3.FR C snq;:n! 带属性的标签
~#4~_d.=L doStartTag, doEndTag, set/getAttribute1...N, release
*{nunb>WO \HD-vINV; 带内容的标签
^Et,TF\ doStartTag, doEndTag, release
kC31$jMC3! O]bKNA.5 带内容的标签,且内容重复循环
bBG/gQ doStartTag, doAfterBody, doEndTag, release
qK,V$l(4# 5W{hH\E _5 带内容的标签,且内容与JSP交互
67?n-NP doStartTag, doEndTag, release, doInitBody, doAfterBody, release
lvPpCAXY gb(#DbI 一个tag处理类可以通过javax.servlet.jsp.PageContext来与JSP交互,通过javax.servlet.jsp.PageContext类,tag处理类可以访问JSP中的request、session和application对像。
-%i#j> Wp`C:H 如果tag标签是互相嵌套的,那内层的tag处理类可以通过它的parent属性来访问上层的tag处理类。
dE GX3 - 69iM0X!'u 一般情况都将所有的tag处理类打成了JAR的包,以便于发布。
}PmTR4F!} J?,?fqb E|{m"RUOy Tag库描述(简称TLD)
pALJl[Cb Pt(tRH B ,ex]$fQ' Tag库是用xml语言描述的,TLD包括了tag库中所有tag标签的描述,它一般用来被jsp服务器用来校验tag的语法正确性,或者被jsp开发者用来开发新的标签。
cyBW0wV1 *l{4lu TLD的文件扩展名必须为.tld,而且必须放在当前WEB应用的WEB-INF目录或其子目录中。
|
+fwvi&a *_#&"(P 一个TLD的内容的开头必须遵守标准的XML开头,用于描述DTD和xml的版本,例如:
u uSHCp
=1IEpxh% <?xml version="1.0" encoding="ISO-8859-1" ?>
B*2{M m#;.yR <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "
http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
oSmjs TLD必须以<taglib>来作为它的根元素,<taglib>的子元素如下表:
PU"S;4m 8yvJ`eL- Q K j1yG0i <taglib>的子元素
V(DjF=8 FCAJavOGH Element
/cYk+c
Description
L\YZT|
K( RyE_|]I62u tlib-version
wR(ttwxK3 Tag库的版本
umryA{Ps \QiqcD9Y jsp-version
GBW 7Y Tag库所需要的jsp的版本
X~%IM1+L; {o {#]fbO% short-name
<ip)r; 助记符,tag的一个别名(可选)
leR"j PYaOH_X. uri
3}yraX6r! 用于确定一个唯一的tag库
=@%MV( `!_? uT display-name
%![4d;Z%x 被可视化工具(诸如Jbuilder)用来显示的名称(可选)
pRmE ryR(U sE}sE=\ small-icon
q4 $sc_0i 被可视化工具(诸如Jbuilder)用来显示的小图标(可选)
~O8]3+U 9z5z large-icon
uQ-WTz|* 被可视化工具(诸如Jbuilder)用来显示的大图标(可选)
C>M6&= uz8nRS s description
IK85D>00T 对tag库的描述(可选)
L-SdQTx_ -)<JBs> listener
;B(;2.<"J 参见下面listener元素
S`fu+^cv omr:C8T> tag
k#BU7Exij 参见下面tag 元素
v#w4{.8) O$YJku Listener元素
9
4 "f P~;<o!f 一个tag库可能定义一些类做为它的事件侦听类,这些类在TLD中被称为listener 元素,jsp服务器将会实例化这些侦听类,并且注册它们。Listener元素中有一个叫listener-class的子元素,这个元素的值必须是该侦听类的完整类名。
+HYN$> zv>ZrFl* Tag元素
zR_9D} 9[B<rz 每个tag元素在tag库中都要指出它的名字、类名、脚本变量、tag的属性。其中脚本变量的值可以直接在TLD中定义或通过tag附加信息的类来取得。每个属性描述了这个属性是否可以省略,它的值是否可以通过<%= …%>这样的JSP语法来获得,以及属性的类型。
u)wu=z8 H;4oZ[g 每一个tag在TLD中对应一个tag元素,下表是tag元素的子元素:
i_'|:Uy*F !N@Yh"c Tag元素的子元素
^a: Saq-} 9(V=Ubj 元素名称
h4B+0 描述
':9%3Wq]j \3,$YlG name
x A@|I# 独一无二的元素名
Aigcq38 ZK W@pW]U tag-class
1v+JCOy Tag标签对应的tag处理类
$@XPL~4 Djg1Qh tei-class
RI7qsm6RN javax.servlet.jsp.tagext.TagExtraInfo的子类,用于表达脚本变量(可选)
PTfN+ fq)Ohb body-content
hlYS=cgY= Tag标签body的类型
WoC\a^V s:qxAUi\/ display-name
XY&]T'A 被可视化工具(诸如Jbuilder)用来显示的名称(可选)
ZdJVs/33Vn TW;|G'}$ small-icon
AIIBd 被可视化工具(诸如Jbuilder)用来显示的小图标(可选)
eP-R""uPw &z{dr~ large-icon
Ep#<$6> 被可视化工具(诸如Jbuilder)用来显示的大图标(可选)
z/Mhu{ttL G~Q*:m description
fJ|Bu("N 此tag标签的描述
VyBJIzs0 =N[V{2}q variable
fD]An< 提供脚本变量的信息(同tei-class)(可选)
+3~Gc<OO 0e7O#- attribute
.j+2x[`l Tag标签的属性名
mYsuNTx!. wd2P/y42;; 以下章节介绍对于不同类型的tag,如何具体地实现它们。
8xeun~e"vS pU'`9fLi_ .wt>.mUH 简单的tag
wAj(v6 q^T&A[hMPx gn4g 43 tag处理类
qx#ghcU ZQJw2LA gO 简单的tag处理类必须实现Tag接口的doStartTag和doEndTag方法。当jsp引擎碰到tag标签的开头时,doStartTag被调用,因为简单的tag没有body,所以此方法将返回 SKIP_BODY。当jsp引擎碰到tag标签的结尾时,doEndTag被调用,如果余下的页面还要被计算,那它将返回EVAL_PAGE,否则将会返回SKIP_PAGE。
nFf\tf%8 ux/[d6To 以下是例子:对于标签 <tt:simple /> ,它的tag处理类实现如下:
.-1{,o/&Q 5D02%U2N)G 6r-<XNv)0 public SimpleTag extends TagSupport
?-6x]l=] =:R[gdA#1 {
*M**h-p2' RE*S7[ge public int doStartTag() throws JspException
6u]OXPA| _QtQPK\+ {
yI)RGOV L-X
_b3E\ try{
d9e H}#OY SUFaHHk@/b pageContext.getOut().print(“Hello.”);
fU){]YP SJ|.% gn }catch(Exception e){
N6 }i>";_; `'k's]Y throw new JspTagException(“SimpleTag: “ + e.getMessage());
=w>>7u$4 b\uB }
m#}{"d&J hcqmjqJ return SKIP_BODY;
9[]"%6 V~^6 TS( }
bU +eJU_% HI`A;G] public int doEndTag()
#L*@~M^] PFn[[~5V {
AZ Lt'9UD 2W-NCE%K)T return EVAL_PAGE;
<?va)
ou pUEok + }
h,jAtL! D@vvy6>~s }
kviSQM2 y.]]V"'2 v}*u[GWl] 注意:如果tag标签没有内容的话,那必须定义body-content元素为空,例如
^Th"`Av5 CzsY=DBH= <body-content>empty</body-content>
I z=w2\r _w,0wn9N$ )aA9z(x 带属性的tag标签