站内搜索: 请输入搜索关键词

当前页面: 开发资料首页 → JSP 专题 → 兔八哥笔记3:JSP自定义标签试验

兔八哥笔记3:JSP自定义标签试验

摘要: JSP;自定义标签

一、概述

JSP中有一块重要的技术：自定义标签（Custom Tag），最近这几天在学习Struts的时候发现Struts中使用了很多自定义标签，如html、bean等。所以我就做了个简单的试验，学习一下这种技术。

首先介绍一下这种技术吧！

1．优点：

取代了JSP中的Java程序，并且可以重复使用，方便不熟悉Java编程的网页设计人员。

2．开发流程：

（1） 编写JSP，在JSP中使用自定义标签。

（2） 在web.xml中指定JSP中使用的标签的.tld(标签库描述文件)文件的位置。

（3） .tld文件中指定标签使用的类。

3. 自定义标签的分类：

（1） 简单标签：如< mytag：helloworld/><?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

（2） 带属性标签：如”/>

（3） 带标签体的标签：

在自定义标签的起始和结束标签之间的部分为标签体(Body)。Body的内容可以是JSP中的标准标签，也可以是HTML、脚本语言或其他的自定义标签。

”>

（4） 可以被Script使用的标签：

定义了id和type属性的标签可以被标签后面的Scriptlet使用。

<%oraDB.getConnection(); %>

4．接口及其他

实际上，自定义标签的处理类实现了Tag Handler对象。JSP技术在javax.servlet.jsp.tagext中提供了多个Tag Handler接口，JSP1.2中定义了Tag、BodyTag、IterationTag接口，在JSP2.0中新增了SimpleTag接口。JSP还提供了上述接口的实现类TagSupport、BodyTagSupport和SimpleTagSupport（SimpleTagSupport只在JSP2.0中才有）。BodyTagSupport实现了BodyTag、Tag和IterationTag接口。

接口及其方法

<table bgColor=silver border=1 cellPadding=0 cellSpacing=0 style="BACKGROUND: silver; BORDER-BOTTOM: medium none; BORDER-COLLAPSE: collapse; BORDER-LEFT: medium none; BORDER-RIGHT: medium none; BORDER-TOP: medium none; WIDTH: 437.4pt; mso-border-alt: solid windowtext .5pt; mso-padding-alt: 0cm 5.4pt 0cm 5.4pt" width=583> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: windowtext 0.5pt solid; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 4cm" vAlign=top width=151>

Tag接口

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: windowtext 0.5pt solid; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 324pt; mso-border-left-alt: solid windowtext .5pt" vAlign=top width=432>

方法

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 4cm; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=151>

SimpleTag

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 324pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=432>

dotage

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 4cm; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=151>

Tag

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 324pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=432>

doStartTag,doEndTag,release

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 4cm; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=151>

IterationTag

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 324pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=432>

doStartTag,doAfterTag,release

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 4cm; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=151>

BodyTag

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 324pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=432>

doStartTag,doEndTag,release,doInitBody,doAfterBody

</td></tr></table>

下表引自Sun的JSP在线教程。

<table border=1 cellPadding=0 cellSpacing=0 style="MARGIN-LEFT: -4.5pt; WIDTH: 441pt; mso-padding-alt: 3.75pt 3.75pt 3.75pt 3.75pt; mso-cellspacing: 0cm" width=588> <tr> <td colSpan=2 style="BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; BORDER-RIGHT: medium none; BORDER-TOP: medium none; PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 441pt" width=588>

Tag Handler Methods

</td></tr> <tr> <td style="BACKGROUND: #cccccc; PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 146.2pt" width=195>

Tag Handler Type

</td> <td style="BACKGROUND: #cccccc; PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 294.8pt" width=393>

Methods

</td></tr> <tr> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 146.2pt" width=195>

Simple

</td> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 294.8pt" width=393>

doStartTag, doEndTag, release

</td></tr> <tr> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 146.2pt" width=195>

Attributes

</td> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 294.8pt" width=393>

doStartTag, doEndTag, set/getAttribute1...N, release

</td></tr> <tr> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 146.2pt" width=195>

Body, Evaluation and No Interaction

</td> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 294.8pt" width=393>

doStartTag, doEndTag, release

</td></tr> <tr> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 146.2pt" width=195>

Body, Iterative Evaluation

</td> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 294.8pt" width=393>

doStartTag, doAfterBody, doEndTag, release

</td></tr> <tr> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 146.2pt" width=195>

Body, Interaction

</td> <td style="PADDING-BOTTOM: 3.75pt; PADDING-LEFT: 3.75pt; PADDING-RIGHT: 3.75pt; PADDING-TOP: 3.75pt; WIDTH: 294.8pt" width=393>

doStartTag, doEndTag, release, doInitBody, doAfterBody, release

</td></tr></table>

下表中的EVAL是evaluate的缩写，意思是：评价, 估计, 求...的值，在下列的返回值中的意思是执行。

<table bgColor=silver border=1 cellPadding=0 cellSpacing=0 style="BACKGROUND: silver; BORDER-BOTTOM: medium none; BORDER-COLLAPSE: collapse; BORDER-LEFT: medium none; BORDER-RIGHT: medium none; BORDER-TOP: medium none; mso-border-alt: solid windowtext .5pt; mso-padding-alt: 0cm 5.4pt 0cm 5.4pt; mso-table-layout-alt: fixed"> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: windowtext 0.5pt solid; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 131.4pt" vAlign=top width=175>

返回值

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: windowtext 0.5pt solid; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 306pt; mso-border-left-alt: solid windowtext .5pt" vAlign=top width=408>

意义

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 131.4pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=175>

SKIP_BODY

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 306pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=408>

表示不用处理标签体，直接调用doEndTag()方法。

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 131.4pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=175>

SKIP_PAGE

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 306pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=408>

忽略标签后面的JSP内容。

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 131.4pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=175>

EVAL_PAGE

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 306pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=408>

处理标签后，继续处理JSP后面的内容。

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 131.4pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=175>

EVAL_BODY_BUFFERED

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 306pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=408>

表示需要处理标签体。

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 131.4pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=175>

EVAL_BODY_INCLUDE

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 306pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=408>

表示需要处理标签体,但绕过setBodyContent()和doInitBody()方法

</td></tr> <tr> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: windowtext 0.5pt solid; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 131.4pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=175>

EVAL_BODY_AGAIN

</td> <td style="BORDER-BOTTOM: windowtext 0.5pt solid; BORDER-LEFT: medium none; BORDER-RIGHT: windowtext 0.5pt solid; BORDER-TOP: medium none; PADDING-BOTTOM: 0cm; PADDING-LEFT: 5.4pt; PADDING-RIGHT: 5.4pt; PADDING-TOP: 0cm; WIDTH: 306pt; mso-border-left-alt: solid windowtext .5pt; mso-border-top-alt: solid windowtext .5pt" vAlign=top width=408>

对标签体循环处理。

</td></tr></table>

具体用法可以查看其他参考资料。

Sun的Java教程相关部分：http://java.sun.com/webservices/docs/1.0/tutorial/doc/JSPTags.html

二、实验

1．试验介绍

下面的实验就是基于上述开发流程开发的。

（1）在JSP中指定taglib的uri：<%@ taglib uri="/helloworld" prefix="mytag" %>。

（2）在web.xml中配置tag-location:

/helloworld

/WEB-INF/helloworld.tld

（3）在tag-location中指定的.tld文件中定义实现标签的处理类：

<short-name>mytag

helloworld

mytag.HelloWorldTag

<body-content>empty</body>

(4)执行处理类mytag.HelloWorldTag的doStartTag和doEndTag方法，然后将结果输入到JSP中，和JSP中的内容一起输出。实际上自定义标签和JSP中的其他的内容被WebServer一起编译成servlet。

2. 完成后的试验的目录结构

应用myjsp放在Tomcat的webapps下。

myjsp中包含J2EE标准目录结构：WEB-INF和hello.jsp。WEB-INF中包含子目录classes和lib及web.xml,tld文件可以放在WEB-INF下，也可以放在WEB-INF的子目录下。

3．开始实验

3．1．编写JSP

< !—hello.jsp的源码 -- >

<%@ page contentType="text/html; charset=GBK" %>

<%@ taglib uri="/helloworld" prefix="mytag" %>

<head>

</P> <P class=MsoNormal style="MARGIN-LEFT: 18pt">jsp1</P> <P class=MsoNormal style="MARGIN-LEFT: 18pt">

</head>

<body bgcolor="#ffffc0">

下面显示的是自定义标签中的内容




</form>

</body>

3．2．编写web.xml

< !—web.xml的源码 -- >

<?xml version="1.0" encoding="UTF-8"?>

web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun.com/dtd/web-app_2_3.dtd">

/helloworld

/WEB-INF/helloworld.tld

3．3 编写tld文件

< !—helloworld.tld的源码 -- >

<?xml version="1.0" encoding="ISO-8859-1"?>

taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"

"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">

1.0

1.2

mytag

helloworld

mytag.HelloWorldTag

<body-content>empty</body>

3．4 编写标签实现类

< !—标签的实现类HelloWorldTag.class的源码 -- >

package mytag;

import java.io.IOException;

import javax.servlet.jsp.*;

import javax.servlet.jsp.tagext.*;

public class HelloWorldTag extends TagSupport {

public HelloWorldTag() {

}

public int doStartTag() throws JspTagException{

return EVAL_BODY_INCLUDE;

}

public int doEndTag() throws JspTagException{

try {

pageContext.getOut().write("Hello World");

}

catch (IOException ex) {

throw new JspTagException("错误");

}

return EVAL_PAGE;

}

}

3．5 执行效果

部署到Tomcat的WebApps目录下，启动Tomcat，输入：http://localhost:8080/myjsp/hello.jsp

“Hello World”就是我们定义的标签部分的处理类输出的结果。

3．6 注意：

这个试验我做了2天，总是报错，弄得很是灰心，开始时以为tld文件或web.xml文件配置不正确，但怎么也找不到原因。

今晚我终于找到原因了，是因为.class文件一定要放在classes文件夹中，我放到了lib中。

.jar或servlet文件要放在lib目录中，而.class要放在classes目录中，如果要放到lib目录中,必须把mytag中的文件打包成.jar文件，然后把mytag.jar放到lib目录中。

希望你不要犯我犯过的这个错误！^_^

有时间我会再写一篇介绍Struts详细处理流程的笔记。

这篇笔记整理的的确是JSP1.2的自定义标签，在JSP2.0中xml文件的格式变了，其他的就不太了解了！但我想变化应该不会太大，另外标准是向下兼容的，感兴趣的朋友可以看看，这是我的学习笔记，可能会对别人有些用处，所以贴出来献丑了！



↑返回目录
前一篇: jsp+tomcat的配置--写给那些因为配置问题而焦虑不堪的菜鸟朋友
后一篇: JSP 单页面网站文件管理器