自定义标签的简介和运用

自定义标签的简介和运用

一 自定义标签的简介：

1．使用自定义标签的目的：主要是移除jsp页面中的java代码

2．自定义标签的创建步骤：

（1）创建标签处理器----java类，要实现Tag接口（放置从jsp中移除的java

代码）

（2）编写一个扩展名为.tld的文件（标签库的描述符文件），用来指定标签处理器的类所对应的标签是什么，和jsp中自定义标签想对应

3．Jsp页面中使用自定义标签

直接写上该标签即可

4．标签处理器的介绍

标签处理器要继承Tag接口

1．Tag在javax.servelt.tagext.Tag,它的方法为：

（1）doEndTag()开始标签

（2）doStartTag()结束标签

注：开始标签和结束标签会自动调用标签处理器中的方法

（3）getParent()是获取它的父标签对象

（4）setPageContext()把当前页面的pageContex对象传给标签处理器，在toStart之前调用。

注：This.pageContext.getOut()可通过这个方法得到所有的内置对象

（5）release()方法释放资源

二 简单举例---获取IP地址

1．在java中要想得到客户端的IP为：

<%

//得到的是客户端的IP地址。是字符串类型的

String ip = request.getRemoteAddr();

out.print(ip);

%>

2．用自定义标签获取客户端的IP为：

（1）．先创建标签处理器，在标签处理器中获取IP，代码为：

public class CusTagDemo1 extends TagSupport {

public int doStartTag() throws JspException {

HttpServletRequest request = (HttpServletRequest) this.pageContext.getRequest();

JspWriter out = this.pageContext.getOut();

//得到的是客户端的IP地址,是字符串类型的

String ip = request.getRemoteAddr();

try {

out.print(ip);

} catch (IOException e) {

// TODO Auto-generated catch block

throw new RuntimeException();

}

return super.doStartTag();

}

}

注：pageContext能够获取java中的九个内置对象，

通过pageContext获取request：this.pageContext.getRequest();

this.pageContext.getRequest()获取的是ServeltRequest，要进行强制类型转换

（2）创建扩展名为.tld的文件，用来配置自定义标签

<?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">

<tlib-version>1.0</tlib-version>

<short-name>hbsi</short-name> 标签的前缀

<!-- 包含所有的标签，和标签绑定 -->

<uri>http://www.hbsi.edu.cn</uri>

<tag>

<name>viewIP</name> 标签后缀

<tag-class>com.hbsi.web.tag.CusTagDemo1</tag-class>所在的路径

<!-- 标签体的内容 -->

<body-content>empty</body-content>

</tag>

3．在jsp中调用

您的IP是： <hbis:viewIP/>

三 自定义标签的执行过程

JSP引擎将遇到自定义标签时，首先创建标签处理器类的实例对象，然后按照JSP规范定义的通信规则依次调用它的方法。

1、public void setPageContext(PageContext pc)， JSP引擎实例化标签处理器后，将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。

2、public void setParent(Tag t)，setPageContext方法执行完后，WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器，如果当前标签没有父标 签，则传递给setParent方法的参数值为null。

3、public int doStartTag()，调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。

4、public int doEndTag()，WEB容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时，WEB容器会去调用标签处理器的doEndTag方法。

5、public void release()，通常WEB容器执行完自定义标签后，标签处理器会驻留在内存中，为其它请求服务器，直至停止web应用时，web容器才会调用release方法。

简单概述：

先调用setPageContex方法--à调用setParent方法---à调用doStartTag方法-à调用doEndTag方法--à调用release方法（一般情况下调用）

四 自定义标签功能的扩展

1．完成页面逻辑，可以控制某一段程序是否被执行---继承Tag接口

（1）通过doStartTag()的返回值决定是否处理标签体的内容

//显示标签体的内容

return Tag.EVAL_BODY_INCLUDE;

//不显示标签体的内容

return Tag.SKIP_BODY;

（2）通过doEndTag()方法的返回值决定是否要继续处理jsp整个页面中该自定义标签之后的代码

//不处理整个jsp页面

return Tag.SKIP_PAGE;

//处理整个jsp页面

return Tag.EVAL_PAGE;

(3)通过doEndTag方法，遇到结束标签之后决定是否执行后续的部分

return Tag.SKIP_PAGE;

<hbsi:demo3/> 把此标签可以放在最前边，当前的jsp页面不会执行

2．控制jsp页面某一部分内容重复执行--- 继承IterationTag接口

控制器的代码---核心代码

public class CusTagDemo4 extends TagSupport {

public int doStartTag() throws JspException {

// TODO Auto-generated method stub

return Tag.EVAL_BODY_INCLUDE;

}

// 循环显示

int count = 5;

public int doAfterBody() throws JspException {

// TODO Auto-generated method stub

count--;

if (count > 0) {

return IterationTag.EVAL_BODY_AGAIN;

} else {

return IterationTag.SKIP_BODY;

}

}

}

注：执行的过程

（1） 将标签处理器实例化成对象

（2） 将调用标签处理器对象的setPageContex（）将jsp页面的pageContex对象做参数传给标签处理器

（3） 调用标签处理器对象的setParent（）将父标签对象做参数传给标签处理器

（4） 调用doStartTag（）方法返回值决定是否要执行标签体

（5） 标签体的处理

（6） 调用doAfterBody()方法---它的返回值可以决定是否要重复执行标签体的内容

调用doEndTag（）方法

3．修改jsp页面并输出---转换大小

控制器代码

//能够获取到标签体的内容并进行修改，然后输出到客户端

public class CusTagDemo5 extends BodyTagSupport {

public int doStartTag() throws JspException {

return BodyTag.EVAL_BODY_BUFFERED;

}

// 把内容封装在BodyContent对象，自动调用 setBodyTag方法，遇到尾标签调用doEndTag（） 调用方法

// BodyContent对象

public int doEndTag() throws JspException {

// 获得标签体内容

BodyContent bc = this.getBodyContent();

String str = bc.getString();

str = str.toUpperCase();

try {

pageContext.getOut().write(str);

} catch (IOException e) {

// TODO Auto-generated catch block

throw new RuntimeException();

}

return Tag.EVAL_PAGE;

}