自定义标签 (Taglib) :
可重用的标签可处理复杂的逻辑运算和事务,或定义jsp网页的输出内容和格式
自定义标签所涉及到的接口与类的层次结构
创建客户化jsp标签的步骤:
1)创建标签的处理类
创建的标签处理类要继承javax.servlet.jsp.tagext.TagSupport 类
或 javax.servlet.jsp.tagext.BodyTagSupport 类,
并重写 两个重要的方法 doStartTag(),doEndTag()
2)创建标签库描述文件(格式 .tld <Tag Library Description> 其实就是一个xml文档),
这个文件要放在WEB-INF目录下
3)在jsp文件中引入标签库,然后插入标签,例如 <hello:firstTag/>
Servlet容器编译jsp文件时,如果遇到自定义标签就会调用这个标签的处理类
实例一:
1.创建标签的处理类 MyTag.java
package com.tag;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;
//定义一个标签处理类
public class MyTag extends TagSupport{
@Override
//当遇到开始标签 该方法会得到调用
public int doStartTag() throws JspException {
try {
//往页面中输出 hello
this.pageContext.getOut().println("hello") ;
} catch (IOException e) {
e.printStackTrace();
}
//EVAL_BODY_INCLUDE 正常执行 开始标签 与结束标签之间的内容
return EVAL_BODY_INCLUDE;
}
@Override
//当遇到结束标签 该方法会得到调用
public int doEndTag() throws JspException {
try {
this.pageContext.getOut().println("world");
} catch (IOException e) {
e.printStackTrace();
}
//EVAL_PAGE 正常执行 结束标签之后的内容
return EVAL_PAGE;
}
}
注意: 1)doStartTag() 返回一个整数值,用来控制执行程序的后续流程,有两个可选值:
EVAL_BODY_INCLUDE :正常执行 开始标签 与结束标签之间的内容
SKIP_BODY :跳过 开始标签 与结束标签之间的内容
2)doEndTag()返回一个整数值,用来控制执行程序的后续流程,有两个可选值:
EVAL_PAGE : 正常执行 结束标签之后的内容
SKIP_PAGE :跳过 结束标签之后的内容
2.创建标签库描述文件myTag.tld ,,供服务器去读取
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.1</jsp-version>
<short-name>myTag</short-name>
<uri>/myTag</uri> <!-- 这个是 uri 而不是 url -->
<tag>
<name>firstTag</name>
<tag-class>com.tag.MyTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
3。在jsp文件中引入标签库,然后插入标签
tag.jsp
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!-- 引入标签库 , prefix 是前缀 -->
<%@ taglib uri="/myTag" prefix="hello" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
<hello:firstTag/>abcd
</body>
</html>
JSP容器在调用doStartTag或doEndTag
方法前,会先调用setPageContext 和
setParent 方法,设置pageContext 和
parent。
在doStartTag或doEndTag方法中可以通
过getParent方法获取上层标签的处理类;
在TagSupport类中定义了protected类型
的pageContext成员变量,因此在标签处
理类中可以直接访问pageContext变量。