J2EE 快速入门之第九章 自定义标签01

一：自定义标签的含义？

       自定义标签就是用户（开发者）自己定义的标签。自定义标签可以让jsp页面不含有java代码，只含有HTML代码和部分标签，就能实现业务逻辑的调用。

二：jsp标签语言的特点

①组成：

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

②分类：

        空标签：br/hr...

        UI标签：table/input...

        控制标签：if/foreach...

        数据标签：set/out...

三：开发步骤

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

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

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

问：为什么要在自定义标签

答：在一些标签不能满足我们代码所需的一些要求了，这个时候就需要自己去定义了

<!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>yy</name>
		<!-- 标签工具类 -->
		<tag-class>com.zking.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>false</rtexprvalue>
		</attribute>
	</tag>
</taglib>

重点：三种方法在什么时候会执行

1. 默认情况，如果jsp上面有标签体，那么三个方法都会执行
2. 如果没有标签体，那么doAfterBody方法不会执行
3. 即默认设置
4. 此时jsp上有标签体，人为将doStartTag的返回值改为SKIP_BODY，那么doAfterBody也不执行 并且jsp页面主体类容显示
5. 如果改变doAfterBody的莫认返回值为EVAL_BODY_AGAIN，那么doAfterBody会反复执行
    

注：只有继承BodyTagSupport才是一个标签助手类

package com.tags;

import java.util.Iterator;

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

/**
 * 1.继承BodyTagSupport
 */
public class TestTag extends BodyTagSupport{
	
	int i=0;

	/**
	 * 标签开始处执行的方法
	 * (默认)SKIP_BODY 跳过标签的内容
	 * EVAL_BODY_INCLUDE 计算标签的内容（不跳过标签的内容）
	 */
	public int doStartTag() throws JspException {
		System.out.println("start");
		i=0;
		return EVAL_BODY_INCLUDE;
	}
	
	//重复吧内容输出三次
	/**
	 * doAfterBody执行的位置 
		 	<z:test>
				胡歌超级帅，爱死你了（在这里执行）
			</z:test>
	 */
	public int doAfterBody() throws JspException {
		if(i<2) {
			i++;
			System.out.println(i);
			return EVAL_BODY_AGAIN;
		}
		return SKIP_BODY;
	}
	
	/**
	 * 标签结束处执行的方法
	 * SKIP_PAGE 页面不要在执行了
	 * (默认)EVAL_PAGE 页面继续往下走
	 */
	public int doEndTag() throws JspException {
		System.out.println("end");
		return EVAL_PAGE;
	}
	
}

ps：1.doStartTag() 开始标签
        2.doAfterBody() 主体部分
        3.doEndTag() 结束标签

四：标签的生命周期

 

五：属性讲解

 六：登录的自定义标签演示

 --------------------------------------------tld文件配置-----------------------------------------------------

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

----------------------------------------------标签助手类--------------------------------------------------

package com.test;

import java.io.IOException;

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

public class Test extends BodyTagSupport {
private Object key;

public Object getKey() {
	return key;
}

public void setKey(Object key) {
	this.key = key;
}
@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub
	String html="";
	if(key==null) {
		html="<button>点我登录</button>";
	}else {
		html="<h1>我回来喽</h1>";
	}
	try {
		pageContext.getOut().print(html);
	} catch (IOException e) {
		// TODO Auto-generated catch block
		e.printStackTrace();
	}
		return SKIP_BODY;
	}
}