JavaWeb——自定义标签

一、自定义标签简介
 在JSP2.0以后，JSP页面中不建议使用脚本片段和JSP表达式，我们使用EL表达式来替换JSP表达式，主要用来在页面中输出一个对象，我们使用标签来替换脚本片段，比如JSP动作标签相当于request.getRequestDispatcher().forward();自定义标签就是让我们以标签的形式在JSP页面中去调用Java代码，每一个标签在背后都对应一个标签处理器类，有时候我们需要一些个性化的需求，所以我们还需要在jsp动作标签以外，来自定义标签。

二、自定义标签步骤
 1、创建标签处理器类
  创建标签处理器类有两种方式：一种是实现Tag接口；另一种是实现SimpleTag接口。实现Tag接口比较麻烦，所以我们一般采取实现SimpleTag接口的方式。
  SimpleTag接口：

//该方法在标签执行时调用，标签处理器类中主要要实现的方法 
void doTag();

//获取当前标签的父标签
JspTag getParent();

// 设置当前标签的标签体，由服务器调用
void setJspBody(JspFragment jspBody);

//设置当前标签的JspContext对象
//JspContext就是JSP中的PageContext对象，可以用来获取JSP页面中的其他隐含对象
//这个方法由服务器调用，服务器通过该方法将PageContext传进处理器类中
void setJspContext(JspContext pc);

// 设置当前标签的父标签，由服务器调用
void setParent(JspTag parent);

  一般我们在开发中都是通过继承SimpleTagSupport来创建标签处理器类，这样我们只需要重写父类的doTag方法，其他方法SimpleTagSupport都已经重写了，直接使用即：

@Override
public void doTag() throws JspException,IOException{
	//获取标签体
	JspFragment body = getJspBody();
	//获取out对象
	JspWriter out = getJspContext().getOut();
	out.print("------寂寞的分割线------");
	//将标签体的内容在页面中显示
	//body.invoke(out);
	//invoke方法可以传一个流，标签体中的内容会自动通过该流输出，如果传null，则默认在当前页面进行输出
	body.invoke(null);
	out.print("
--------孤独的分割线-------")
}

  创建一个有属性的自定义标签：

public class MyTag extends SimpleTagSupport{
	//定义一个boolean类型的属性
	private boolean test;
	
	/**
	 *当标签中有属性时，服务器会自动调用处理器类中相应的setter方法将属性值设置进来
	 *@param test
	 */
	public void setTest(boolean test){
		this.test = test;
	}
	
	@Override
	public void doTag() throws JspException,IOException{
		if(test)
			getJspBody().invoke(null);
	}
}

  注意：给属性设置值的setter方法必须是public的，否则该标签使用时会出错
 2、注册自定义标签：在tld文件中注册

<tag>
	<name>MyTagname>
	<tag-class>com.bdm.taglib.MyTagtag-class>
	<body-content>scriptlessbody-content>
	<attribute>
		<name>testname>
		<required>truerequired>
		<rtexprvalue>truertexprvalue>
	attribute>
tag>

 3、使用标签
  ①引入要使用的标签库

<%@ taglib prefix="a" uri="http://www.bdm.com/taglib/a" %>

   prefix：指定使用标签时的前缀，我们可以任意指定，但是习惯上和标签库short-name一致
   uri：指定要使用的标签库的uri标识，如果没有uri，则可以使用tld文件的路径
  ②在页面中使用标签

<前缀:标签名 属性="">
	标签体
前缀:标签名>

三、tld文件
 标签库描述文件，是xml格式的文件，用来注册自定义标签，主要用来在服务器中注册自定义标签的处理器类，tld文件一般放到WEB-INF文件夹中。
 示例：

<tlib-version>1.0tlib-version>

<short-name>ashort-name>

<uri>http://www.bdm.com/taglib/auri>
				

<tag>
	
	<name>MyTagname>
	
	<tag-class>com.bdm.taglib.MyTagtag-class>
	
	<body-content>emptybody-content>
tag>

 说明：
  body-content：用来设置当前标签体的形式
   empty——当前标签没有标签体，是一个自结束标签
   scriptless——当前标签体中的内容如果是一个EL表达式，会自动解析EL表达式
   JSP——当前标签的标签体可以是一个JSP脚本片段:由于jsp页面中很少使用脚本片段，该值很少使用
   tagdependent——当前标签体中的内容如果是一个EL表达式，不会自动解析，几乎不用
  一般情况下：有标签体用 scriptless，没有标签体 empty
  当标签中有属性时，我们需要在tag标签中添加一个attribute子标签

<attribute>
	<name>testname>
	<required>truerequired>
	<rtexprvalue>truertexprvalue>
attribute>

  name：属性名
  required：属性是否必须的
  rtexprvalue：如果属性的值是一个EL表达式，是否自动解析，一般都是true