在JSP页面中自定义标签 :
实际上,自定义标签的处理类实现了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接口。
接口及其方法
Tag接口 | 方法 |
SimpleTag | dotag |
Tag | doStartTag,doEndTag,release |
IterationTag | doStartTag,doAfterTag,release |
BodyTag | doStartTag,doEndTag,release,doInitBody,doAfterBody |
jsp自定义标签的定义步骤:
创建标记处理器
创建TLD文件
编辑web.xml(如果是jar放在lib文件夹中就不需要编写web.xml)
在JSP页面中使用此标签
另外还有修改一下classpath,因为创建标记处理器(java类)需要用到jsp-api.jar,这个文件在tomcat中,把它加入到classpath后才能运行.
为了使到JSP容器能够使用标签库中的自定义行为,必须满足以下两个条件:
1.从一个指定的标签库中识别出代表这种自定义行为的标签
2.找到实现这些自定义行为的具体类
第一个必需条件-找出一个自定义行为属于那个标签库-是由标签指令的前缀(Taglib Directive's Prefix)属性完成,所以在同一个页面中使用相同前缀的元素都属于这个标签库。每个标签库都定义了一个默认的前缀,用在标签库的文档中或者页面中插入自定义标签。所以,你可以使用除了诸如jsp,jspx,java,servlet,sun,sunw(它们都是在JSP白皮书中指定的保留字)之类的前缀。
uri属性满足了以上的第二个要求。为每个自定义行为找到对应的类。这个uri包含了一个字符串,容器用它来定位TLD文件。在TLD文件中可以找到标签库中所有标签处理类的名称
处理标签的类必须扩展javax.servlet.jsp.TagSupport.
1.TagSupport类提供了两个处理标签的方法:
public int doStartTag() throws JspException
public int doEndTag() throws JspException
2.doStartTag:但JSP容器遇到自定义标签的起始标志,就会调用doStartTag()方法。
doStartTag()方法返回一个整数值,用来决定程序的后续流程。
A.Tag.SKIP_BODY:表示…之间的内容被忽略
B.Tag.EVAL_BODY_INCLUDE:表示标签之间的内容被正常执行
3.doEndTag:但JSP容器遇到自定义标签的结束标志,就会调用doEndTag()方法。doEndTag()方法也返回一个整数值,用来决定程序后续流程。
A.Tag.SKIP_PAGE:表示立刻停止执行网页,网页上未处理的静态内容和JSP程序均被忽略任何已有的输出内容立刻返回到客户的浏览器上。
B.Tag_EVAL_PAGE:表示按照正常的流程继续执行JSP网页
标签库元素用来设定标签库的相关信息,它的常用属性有:
A.shortname: 指定Tag Library默认的前缀名(divfix)
B.uri: 设定Tag Library的惟一访问表示符
标签元素用来定义一个标签,它的常见属性有:
A.name: 设定Tag的名字
B.tagclass: 设定Tag的处理类
C.bodycontent: 设定标签的主体(body)内容
1).empty:表示标签中没有body
2).JSP:表示标签的body中可以加入JSP程序代码
3).tagdependent:表示标签中的内容由标签自己去处理
标签属性元素用来定义标签的属性,它的常见属性有:
A.name:属性名称
B.required:属性是否必需的,默认为false
C.rtexprvalue:属性值是否可以为request-time表达式,也就是类似于的表达式
开始实验
编写JSP
< !—hello.jsp的源码 -- >
<%@ page contentType="text/html; charset=GBK" %>
<%@ taglib uri="/helloworld" divfix="mytag" %>
<html>
<head>
<title>
jsp1
</title>
</head>
<body bgcolor="#ffffc0">
<h1>
下面显示的是自定义标签中的内容
</h1>
<br><br>
<mytag:helloworld></mytag:helloworld>
<br>
</body>
</html>
编写web.xml
<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSPY v5 rel. 4 U (http://www.xmlspy.com) by Williams (501) -->
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<taglib>
<taglib-uri>/helloworld</taglib-uri>
<taglib-location>/WEB-INF/helloworld.tld</taglib-location>
</taglib>
</web-app>
编写tld文件
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"></P< p>
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>mytag</short-name>
<tag>
<name>helloworld</name>
<tag-class>mytag.HelloWorldTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
编写标签实现类
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;
}
}
JSP中的隐含对象都是通过pageContext的方法得到的
写入servlet输出流中:
JspWriter out=pageContext.getOut();
out.println(bodyContent.getString());
本文来源:http://blog.csdn.net/syhhl007/archive/2007/08/21/1753347.aspx