自定义标签 (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变量。