JSP标签

一.特点：

a，组成：

1，开始标签

2，标签体

3，结束标签

组成形式：<开始标签 属性="属性值">标签体</结束标签>

b,分类

1，空标签： br、hr...

2，ui标签：input、table...

3，控制标签：if、foreach...

4数据标签：set标签、out标签...

二，自定义标签开发

概念： 在jsp开发时，当jsp内置标签以及JSTL标签库都满足不了需求时，可以根据自己的需求来自定义标签

意义：根据自己的需求来调整，动态的实现一些功能，从而提高开发效率

---

步骤：

1.创建一个标签助手类(继承BodyTagSupport)，重写doStartTag、doAfterBodyTag、doEndTag。

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

3，通过taglib引入自定义标签库

标签库描述文件：

<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
    version="2.0">
    
  <description>JSTL 1.1 core library</description>
  <display-name>JSTL core</display-name>
  <tlib-version>1.1</tlib-version>
  <short-name>c</short-name>
  <uri>xyy</uri>

  <validator>
    <description>
        Provides core validation features for JSTL tags.
    </description>
    <validator-class>
        org.apache.taglibs.standard.tlv.JstlCoreTLV
    </validator-class>
  </validator>

  <tag>
  
    <name>if</name>
    <tag-class>com.xyy.xyy1</tag-class>
    <body-content>JSP</body-content>
    <attribute>
    <!-- 属性名 -->
        <name>text</name>
    <!-- 是否必须 -->
        <required>true</required>
    <!-- 是否支持EI表达式 -->
        <rtexprvalue>false</rtexprvalue>
    </attribute>
  </tag>

  

</taglib>

引入自定义标签库： 

 三，标签库生命周期

 

 

路线1：doStarTag-->SKIP_BODY-->doEndTag

路线2：doStartTag-->EVAL_BODY_INCLUDE-->doAfterBody-->EVAL PAGE-->doEndTag

线路3：doStartTag-->EVAL_BODY_INCLUDE-->doAfterBody-->EVAL_BODY_AGAIN-->doAfterBody...(循环)-->满足条件后doEndTag
 

---

返回值：

1.SKIP_BODY:跳过主体

2.EVAL_BODY_INCLUDE:计算标签主体内容并输出

3.EVAL_BODY_AGAIN:在计算主体一次

4.EVAL_PAGE:计算页面的后续部分

5.SKIP_PAGE:跳过页面的后续部分

 

package com.xyy;
 
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
/**
	三种路线(根据生命周期图整理出来的)
  1.dostartTag...skipBody...doEndTag
  2.dostartTag...EVAL_BODY_INCLUDE...doAfterBody...EVAL_PAGE...doEndTag
  3.dostartTag...EVAL BODN INCLUDE...doAfterBody...EVAL_BODY_AGAIN...doAfterBody...EVAL_BODY_AGAIN...doAfterBody...EVAL_BODY_AGAIN...doEndTag
 */
 
public class Dome01 extends BodyTagSupport{
 
	//开始标签
	public int doStartTag() throws JspException {
		System.out.println("Dome1...doStartTag...进来了");
		return EVAL_BODY_INCLUDE;
	}
	
	//结束标签
	public int doEndTag() throws JspException {
		System.out.println("Dome1...doEndTag...进来了");
		return super.doEndTag();
	}
	
}
public class Dome02 extends BodyTagSupport{
 
	//开始标签
	public int doStartTag() throws JspException {
		System.out.println("Dome2...doStartTag...进来了");
		return EVAL_BODY_INCLUDE;
	}
	
	//标签体
	@Override
	public int doAfterBody() throws JspException {
		System.out.println("Dome2...doAfterBody...进来了");
		return EVAL_PAGE;
	}
	
	//结束标签
	public int doEndTag() throws JspException {
		System.out.println("Dome2...doEndTag...进来了");
		return super.doEndTag();
	}
	
}
public class Dome03 extends BodyTagSupport{
 
	//开始标签
	public int doStartTag() throws JspException {
		System.out.println("Dome3...doStartTag...进来了");
		return EVAL_BODY_INCLUDE;
	}
	
	//标签体
	@Override
	public int doAfterBody() throws JspException {
		System.out.println("Dome3...doAfterBody...进来了");
		return EVAL_BODY_AGAIN;
	}
	
	//结束标签
	public int doEndTag() throws JspException {
		System.out.println("Dome3...doEndTag...进来了");
		return super.doEndTag();
	}
	
}

四，案例实践

if标签：

助手类

package com.xyy;

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

public class xyysIF extends BodyTagSupport{
	 private boolean text;

	public boolean isText() {
		return text;
	}

	public void setText(boolean text) {
		this.text = text;
	}


	@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub\
		return text==true? EVAL_BODY_INCLUDE:SKIP_BODY ;
	}
	
	
	@Override
	public int doEndTag() throws JspException {
		// TODO Auto-generated method stub
		return super.doEndTag();
	}
	
	
}

tid文件配置

---

 set，out标签：

助手类

package com.xyy;
/**
 * 第一条路线
 * set标签没有标签体，需要借助JSPWriter
 */
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;

public class xyysSET extends BodyTagSupport{

	private String var;
	private Object value;
	
	public String getVar() {
		return var;
	}
	
	public void setVar(String var) {
		this.var = var;
	}
	
	public Object getValue() {
		return value;
	}
	
	public void setValue(Object value) {
		this.value = value;
	}
	
	
	 
	@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub
		//通过pageContext保存
		pageContext.setAttribute(var, value);
		return SKIP_BODY;
	}

	
	@Override
	public int doEndTag() throws JspException {
		// TODO Auto-generated method stub
		return super.doEndTag();
	}
}

 

package com.xyy;
/**
 * 自定义out标签
 * 成员变量： value 存放标签对应的值  必传，支持EL表达式	  
 * 注意：无标签体，要在页面上输出内容，需要借助一个类JSPWrite。
 * 执行doStartTag,将内容输出到网页上
 */
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.BodyTagSupport;

public class xyysOUT extends BodyTagSupport{

	private Object var;
	
	public Object getVar() {
		return var;
	}
	
	public void setVar(Object var) {
		this.var = var;
	}
	
	

	@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub
		JspWriter out=pageContext.getOut();
		try {
			out.print(var);
		} catch (Exception e) {
			e.printStackTrace();
		}
		return SKIP_BODY;
	}
	
	
	@Override
	public int doEndTag() throws JspException {
		// TODO Auto-generated method stub
		return super.doEndTag();
	}
}

tid文件配置

 

---

foreach标签

助手类

package com.xyy;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

import javax.servlet.jsp.JspException;
/**
 * foreach标签，走第二，三条路线
 * 1，最少要两个参数
 * 2，一定有标签体(doAfterBody)
 * 3，有判断条件使doAfterBody改变返回值（EVAL_PAGE还是 EVAL_BOYY_AGAIN）
 */
import javax.servlet.jsp.tagext.BodyTagSupport;

public class xyysFOREACH extends BodyTagSupport{
	private String var;
	private List<Object> items=new ArrayList<Object>();
	
	public String getVar() {
		return var;
	}
	
	public void setVar(String var) {
		this.var = var;
	}
	
	public List<Object> getItems() {
		return items;
	}
	
	public void setItems(List<Object> items) {
		this.items = items;
	}
	
	

@Override
public int doStartTag() throws JspException {
	// TODO Auto-generated method stub
	//保存迭代器，供doAfterBody中使用
	Iterator< Object> it=items.iterator();
	pageContext.setAttribute("it", it);
	return EVAL_BODY_INCLUDE;
}

@Override
	public int doAfterBody() throws JspException {
		// TODO Auto-generated method stub
	Iterator<Object> it=(Iterator<Object>) pageContext.getAttribute("it");
	if(it.hasNext()) {//判断集合是否有数据
		//在页面上，需要通过var将集合数据拿出
		pageContext.setAttribute(var, it.next());
		//保存下移状态
		pageContext.setAttribute("it", it);
		//继续循环
		return EVAL_BODY_AGAIN;
	}else {
		//结束循环
		return EVAL_PAGE;
	}
	}
	
@Override
	public int doEndTag() throws JspException {
		// TODO Auto-generated method stub
		return super.doEndTag();
	}
}

tid文件配置

 

---

select标签

助手类

package com.xyy;
/**
 * 目的：将所学的自定义标签的知识点用于实际项目开发
 * 不管是if/set/out/foreach标签那是别人已经具备的功能，直接用别人的就行
 * 学习自定义标签理解其底层结构，就是弥补现成C标签没有的功能
 *  以前查询下拉框
 *		<select>
 *			<option value=''>-==请选择==m</option>
 *			<option value= '1'>xyy1</option>
 *			<option value='2'>xyy2</option>
 *			<option value='3'>xyy3</option>
 *		</ select>
 *		修改回显，在这里面有大量的c:foreach. c:if到断
 *		不足之处:代码过大。以及凡是涉及到下拉框以及复选框。粗类似的代码过多
 *	目前:
 *		<z:selectc/z: select>
 *		目的:通过上述标签能够实现上述代码相同的功能
 *	分析属性：
 * 		1.需要数据源属性items,用于遍历展示的
 *   users->List<User>->id=option>value;name=option>text
 * 		2.对象key属性textKey，用于对应option>value
 * 		3.对象value属性textval。用于对应option>text
 *		4.对象默认key属性headerTextKey，用于对应默认的option>value
 *		5.对象默认value属性headerTextval，用于对应默认的option>text
 *		6.对象回显值属性selectedVal,用于判断是否数据回显选中
 *	没有标签体又需要往页面输出内容(jspWriter)
 */
 
import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.List;

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


public class xyysSELECT extends BodyTagSupport{

	private List<Object> items=new ArrayList<Object>();//用于遍历展示
	private String textKey;//用于对应option>value
	private String textVal;//用于对应option>text
	private String headerTextKey;//用于对应默认option>value
	private String headerTextVal;//用于对应默认option>text
	private String selectedVal;//用于判断数据回显选择
	
	//定义属性美化。拓展/操作标签
	private String cssStyle;//美化
	private String id;//绑定事件...操作标签
	private String className;//美化


	private String html() throws Exception {
		StringBuffer sb=new StringBuffer();//获取可变字符串
		sb.append("<select>");
		if(headerTextKey!=null&&"".equals(headerTextVal)) {
			sb.append("<option vlaue='"+headerTextKey+"'>"+headerTextVal+"</option>");
		}
		if(items.size()>0) {
			for(Object obj:items) {
				//obj就是页面传输过来集合的类型或对象
				//通过反射获取类对象属性 getDeclaredField()获取所有(公共的、私有的)类对象属性
				Field fidname=obj.getClass().getDeclaredField(textKey);
				//打开权限 
				fidname.setAccessible(true);
				//获取textKey 对应的属性值
				//String value = fidname.get(obj).toString();
				String value=fidname.get(obj).toString();
				Field fidtext = obj.getClass().getDeclaredField(textVal);
				fidtext.setAccessible(true);
				String text = fidtext.get(obj).toString();
				//追加至<optoin>中 判断默认选中
				if(text.equals(selectedVal)) {
				sb.append("<option selected vlaue='"+value+"'>"+text+"</option>");
				}else {
					sb.append("<option vlaue='"+value+"'>"+text+"</option>");
				}
	}
		}
		sb.append("<option></option>");
		sb.append("</select>");
		return sb.toString();

	}
	@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub
		JspWriter out=pageContext.getOut();
		try {
			out.print(html());
		} catch (Exception e) {
			e.printStackTrace();
		}
		return super.doStartTag();
	}
	
	

	@Override
	public int doAfterBody() throws JspException {
		// TODO Auto-generated method stub
		return super.doAfterBody();
	}
	
	@Override
	public int doEndTag() throws JspException {
		// TODO Auto-generated method stub
		return super.doEndTag();
	}
}

tid文件配置

<tag>
  <name>select</name>
  <tag-class>com.xyy.xyysSELECT</tag-class>
  <body-content>JSP</body-content>
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>id</name>
  <!-- 该成员变量是否必传-->
  <required>false</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>false</rtexprvalue>
  </attribute>
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>cssStyle</name>
  <!-- 该成员变量是否必传-->
  <required>false</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>false</rtexprvalue>
  </attribute>
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>className</name>
  <!-- 该成员变量是否必传-->
  <required>false</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>false</rtexprvalue>
  </attribute>
  
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>items</name>
  <!-- 该成员变量是否必传-->
  <required>true</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>true</rtexprvalue>
  </attribute>
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>textKey</name>
  <!-- 该成员变量是否必传-->
  <required>true</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>false</rtexprvalue>
  </attribute>
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>textVal</name>
  <!-- 该成员变量是否必传-->
  <required>true</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>false</rtexprvalue>
  </attribute>
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>headerTextKey</name>
  <!-- 该成员变量是否必传-->
  <required>false</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>false</rtexprvalue>
  </attribute>
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>headerTextVal</name>
  <!-- 该成员变量是否必传-->
  <required>false</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>false</rtexprvalue>
  </attribute>
  <attribute>
  <!--  自定义标签的成员变量名称-->
  <name>selectedVal</name>
  <!-- 该成员变量是否必传-->
  <required>false</required>
  <!--  是否支持EL表达式-->
  <rtexprvalue>true</rtexprvalue>
  </attribute>
  </tag>

---

测试界面：

效果：