JSP自定义标签

什么是标签

标记语言，是一种注释文本的语言，以便于计算机可以操作。很多与“ML”结尾的语言都是标记语言，比如：HTML，XML，XHTML，VML等等。
标记语言与其他语言一样，也需要运行它们的环境，比如HTML的运行环境时浏览器，XML也要自己的解析和运行的环境。

基本结构：

<开始标签>标签体</结束标签>

空标签：

<开始标签 属性名="属性值"/></结束标签>
<br/><br/>
<开始标签 属性名="属性值"/>

一、JSP标签库是什么？

是一个JSP标签集合，它封装了JSP应用的通用核心功能， 基于JSP标签我们可以理解为，是JSP应该通用功能的一种封装方式。

二、使用流程

 1 创建一个标签助手类(继承BodyTagSupport)
      标签属性必须与助手类的属性对应、且要提供对应get/set方法

public class ForEachTag  extends BodyTagSupport{
	
	private String awa;
	
	
	public String getAwa() {
		return awa;
	}
	public void setAwa(String awa) {
		this.awa = awa;
	}

 2 创建标签库描述文件(tld)，添加自定义标签的配置
      注：tld文件必须保存到WEB-INF目录或其子目录

tld 案例：

<!DOCTYPE taglib
  PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
   "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<!-- 标签库描述符 -->
<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
	<!-- 代表标签库的版本号 -->
	<tlib-version>1.0</tlib-version>
	<!-- 代表jsp的版本 -->
	<jsp-version>1.2</jsp-version>
	<!-- 你的标签库的简称 -->
	<short-name>awa</short-name>
	<!-- 你标签库的引用uri -->
	<uri>/aa</uri>

	<tag>
		<!-- 标签名 -->
		<name>test</name>
		<!-- 标签工具类 -->
		<tag-class>com.zking.tag.TestTag</tag-class>
		<!-- 标签的内容类型：empty表示空标签，jsp表示可以为任何合法的JSP元素 -->
		<body-content>jsp</body-content>
		<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
		 <attribute>
			<!--自定义标签的属性名称 -->
			<name>name</name>
			<!--true表示必填 -->
			<required>false</required>
			<!--true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
			<rtexprvalue>false</rtexprvalue>
		</attribute>
	</tag>
	
</taglib>

 3 在JSP通过taglib指令导入标签库，并通过指定后缀访问自定义标签

<%@ taglib uri="/aa" prefix="c"%>

注：uri的路径要与tld的标签库的引用的uri相同

标签生命周图

 

  流程A：
                                      SKIP_BODY
  1  实例化标签助手类->doStartTag()------------->doEndTag()
       //主要用开发简单标签

/**
	 * 在结束标签执行的动作
	 * 返回值两种结果
	 * 1.计算页面的后续部分（默认）EVAL_PAGE
	 * 2.跳过页面的后续部分  SKIP_PAGE
	 * 
	 * 
	 */
	@Override
	public int doEndTag() throws JspException {
		//System.out.println("doEndTag()......");
		return EVAL_PAGE;
	}
	
	/**
	 * 在开始标签时执行的动作
	 * 返回值有两种
	 * 1.跳过标签体内容
	 * 2.执行计算标签体并输出内容
	 * 
	 */
	@Override
	public int doStartTag() throws JspException {
		//System.out.println("doStartTag()......");
		//System.out.println("我的名字叫"+this.name);
		return EVAL_BODY_INCLUDE;
	}

  流程B：
                                      EVAL_BODY_INCLUDE         SKIP_BODY
  2  实例化标签助手类->doStartTag()------------->doAfterBody---------------->doEndTag()...
                                                              EVAL_BODY_AGAIN
 

/**
	 * 在标签体之后在结束标签之前执行的动作
	 * 返回值两种：
	 * 1.跳过主题，执行doEndTag的方法SKIP_BOOY
	 * 2.再计算主题一次  EVAL_BODY_AGAIN
	 */
	/*@Override
	public int doAfterBody() throws JspException {
		//获取count值
		int count = (int)pageContext.getAttribute("count");
		if(count<3) {
			count++;
			pageContext.setAttribute("count", count);
			return EVAL_BODY_AGAIN;
		}else {
			return SKIP_BODY;
		}
	}
*/
	@Override
	public int doEndTag() throws JspException {
		return super.doEndTag();
	}
	
	/**
	 * 默认为跳过标签体
	 */
	@Override
	public int doStartTag() throws JspException {
		pageContext.setAttribute("count", 1);
		String str="";
		for (Object string : item) {
			str+=string;
		}
		pageContext.setAttribute(var, str);
		return EVAL_BODY_INCLUDE;
	}

例： 

<z:test name="aa">awa</z:test>

  SKIP_BODY：跳过主体（ 不会打印“awa”）
  EVAL_BODY_INCLUDE：计算标签主体内容并[输出]（会打印“awa”）
  EVAL_PAGE:计算页面的后续部分
  SKIP_PAGE:跳过页面的后续部分（不建议用，直接跳过后面全部类容包括body）
  EVAL_BODY_AGAIN:再计算主体一次