JSP自定义标签笔记

一、标签的作用

移除掉JSP中的Java脚本(<%%>)

二、编写自定义标签的步骤(自定义EL函数，步骤相同)

Tag接口：其中的方法都是由容器调用的。

常量：

SKIP_BODY:忽略标签的主体内容。只为doStartTag方法服务

EVAL_BODY_INCLUDE:不忽略标签的主体内容。只为doStartTag方法服务

SKIP_PAGE:忽略结束标签之后的内容。只为doEndTag方法服务

EVAL_PAGE:不忽略结束标签之后的内容。只为doEndTag方法服务

方法：

int doStartTag():容器调用。遇到自定义标签的开始标签时被调用。

int doEndTag():容器调用。遇到自定义标签的结束时被调用。

void setPageContext(PageContext pc):由容器调用。处理标签之前就会调用。

void setParent(Tag t):由容器调用。处理标签之前就会调用。目标传递进父标签，没有传递null。

void release() :由容器调用，释放标签类占用的资源。

IterationTag接口：继承Tag接口。增加重复执行主体内容的方法

int doAfterBody():执行完主体后会被容器调用该方法。

该方法的返回值只能是：Tag.SKIP_BODY,忽略主体，进入结束标签处理。

IterationTag.EVAL_BODY_AGAIN，再执行一次主体内容。

BodyTag接口：继承IterationTag接口。增加了获取主体内容的方法。

int EVAL_BODY_BUFFERED:给doStartTag()方法用的。只有返回该值，以下2个方法才会被容器调用。

void doInitBody():初始化主体。容器调用

void setBodyContent(BodyContent b) :设置主体内容。容器调用。BodyContent就代表着主体内容。

SimpleTag接口：

void doTag():遇到标签就执行。容器调用。

void setJspBody(JspFragment jspBody):容器调用。传入标签的主体内容。

void setJspContext(JspContext pc):容器调用。传入PageContext对象。

void setParent(JspTag parent):容器调用。传入父标签。

1、编写一个类，直接或间接实现javax.servlet.jsp.tagext.Tag接口

package cn.it.tag;

import java.io.IOException;

import javax.servlet.jsp.JspException;

import javax.servlet.jsp.tagext.TagSupport;

//TagSupport实现了Tag接口

public class ShowRemoteIpTag extends TagSupport {

public int doStartTag() throws JspException {

String remoteIp = pageContext.getRequest().getRemoteAddr();

try {

pageContext.getOut().write(remoteIp);

} catch (IOException e) {

e.printStackTrace();

}

return super.doStartTag();

}

}

2、在WEB-INF目录下建立一个扩展名为tld（Tag Libary Definition）的xml文件。

<?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>it</short-name>

<uri>http://www.itcn/jsp/jstl</uri>

<tag><!-- 描述标签 -->

<description>Show Remote Address</description>

<name>showRemoteIp</name>

<tag-class>cn.ittag.ShowRemoteIpTag</tag-class>

<body-content>empty</body-content><!-- 指示标签的主体内容：没有就写empty -->

</tag>

</taglib>

3、（可选的）在web.xml中对tld文件和名称空间进行映射对应。

<jsp-config>

<taglib>

<taglib-uri>http://www.it.cn/jsp/jstl</taglib-uri>

<taglib-location>/WEB-INF/it.tld</taglib-location>

</taglib>

</jsp-config>

4、在JSP中使用

<%@ taglib uri="http://www.it.cn/jsp/jstl" prefix="it"%>

七、标签的配置元素详解

tld文件：

taglib：根元素

tlib-version:版本号

short-name:引用标签时的短名称。一般与tld文件的文件名一致，好找。

uri：标签绑定的名称空间。只是一个名字，没有实际的意义。

tag：定义标签元素

name：标签的名称。

tag-class:标签的实现类的全名称。

body-content:指示标签的主体内容的类型。

可选值：

empty:没有主体内容。适用于传统和简单标签。

JSP:说明JSP文件中能出现啥，标签主体内容中就能出现啥。适用于传统标签。

scriptless：说明标签的主体内容不能是java脚本。适用于简单标签。

tagdependent：说明标签的主体内容是原封不动的传递给标签处理类的。

而不是传递的运算结果

attribute：定义标签的属性

name：属性名。对应标签处理类中的setter方法

required:是否是必须的属性

rtexprvalue：是否支持表达式（EL或java表达式）。默认是false。