J2EE快速入门之自定义标签

目录

一、标签语言特点

二、标签生命周期

三、 自定义标签的开发及使用步骤（浏览器使用：google/firefox）

  （1）创建一个标签助手类(继承BodyTagSupport)

  （2）创建标签库描述文件(tld)，添加自定义标签的配置

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

    (4)最后的结果显示

---

一、标签语言特点

标签结构：

   <开始标签 属性="属性值">标签体</结束标签>  <h1 style="">1</h1>

   <空标签>  <br/><hr/>

二、标签生命周期

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

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

（3）  常见的方法

  SKIP_BODY：跳过主体
  EVAL_BODY_INCLUDE：计算标签主体内容并[输出]
  EVAL_PAGE:计算页面的后续部分
  SKIP_PAGE:跳过页面的后续部分
  EVAL_BODY_AGAIN:再计算主体一次

三、 自定义标签的开发及使用步骤（浏览器使用：google/firefox）

 （1）创建一个标签助手类(继承BodyTagSupport)

           标签属性必须与助手类的属性对应、且要提供对应get/set方法​​​​​​

package com.lixiangning.jsptag.tag;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;

/**
 * JSP 自定义标签开发及使用步骤
 * 1）创建标签助手类并继承BodyTagSupport
 * 注：标签描述文件中定义的属性与助手类中的属性必须一致，并且提供get/set方法
 * 2）创建标签描述文件（.tld），并在其中添加自定义配置
 * 注：必须添加到WEB-INF或其子目录下
 * 3）在指定的页面中通过taglib指令导入自定义标签库
 * @author Administrator
 *
 */
public class TestTag extends BodyTagSupport {
	
	private Object name;
	
	private int count = 0;
	
	public Object getName() {
		return name;
	}

	public void setName(Object name) {
		this.name = name;
	}

	/**
	 * doStartTag：对应<开始标签> 所执行的动作
	 * 例如：对应<z:test>
	 * 返回值：
	 * 1）SKIP_BODY:跳过主体内容不包含在输出中
	 * 2）EVAL_BODY_INCLUDE:计算主题内容并包含在输出中
	 */
	@Override
	public int doStartTag() throws JspException {
		System.out.println("name="+this.name);
		System.out.println("doStartTag：对应<开始标签> 所执行的动作");
		return EVAL_BODY_INCLUDE;
	}
	
	/**
	 * doAfterBody：介于<开始标签>标签体与<结束标签>之间所执行的动作
	 * 例如：介于<z:test>112与</z:test>之间所执行的动作
	 * 返回值：
	 * 1）SKIP_BODY:跳过页面内容不输出（可以理解成for循环中的break）
	 * 2）EVAL_BODY_AGAIN：再次计算标签主体内容并保持在输出中（可以理解成for循环continue）
	 */
	@Override
	public int doAfterBody() throws JspException {
		System.out.println("doAfterBody：介于<开始标签>标签体与<结束标签>之间所执行的动作");
		if(count<3) {
			count++;
			return EVAL_BODY_AGAIN;
		}
		return SKIP_BODY;
	}
	
	/**
	 * doEndTag:对应<结束标签>所执行的动作
	 * 例如：对应</z:test>标签
	 * 返回值：
	 * 1）SKIP_PAGE：跳过页面的后续内容
	 * 2）EVAL_PAGE：计算页面的后续内容
	 */
	@Override
	public int doEndTag() throws JspException {
		System.out.println("doEndTag:对应<结束标签>所执行的动作");
		return EVAL_PAGE;
	}
}

  （2）创建标签库描述文件(tld)，添加自定义标签的配置

                  注：tld文件必须保存到WEB-INF目录或其子目录

<!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>test</short-name>
	<!-- 你标签库的引用uri -->
	<uri>/zking</uri>

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

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

<h2>自定义标签</h2>
	<z:test name="${name }">112</z:test>
	Bye~ Bye~ Bye~

     (4)最后的结果显示

这呢，就是一个简单的结果显示，其实学自定义标签，首先要掌握标签助手类，然后才可以通过一些条件判断之类的自定义标签。