javaweb jsp自定义标签

一、自定义标签的作用
1、消除JSP中的java脚本。自定义标签也属于JSP中的一部分技术。
2、javax.servlet.jsp.tagext.Tag接口：标签处理类需要实现的接口


常量：
int EVAL_BODY_INCLUDE：为doStartTag服务，指示还要处理标签的主体内容。
int EVAL_PAGE：为doEndTag服务，指示还要处理结束标签后的其他JSP内容。
int SKIP_BODY：为doStartTag服务，指示忽略标签的主体内容。
int SKIP_PAGE：为doEndTag服务，指示忽略结束标签后的其他JSP内容。
方法：方法都是由容器调用，包括标签处理类也是由容器实例化的。
int doEndTag():遇到结束标签时，容器调用。
int doStartTag():遇到开始标签时，容器调用。
Tag getParent():获取父标签
void release():释放标签占用的资源
void setPageContext(PageContext pc):容器调用。标签处理类实例化后，容器会把PageContext对象传给你。
void setParent(Tag t):设置父标签。容器调用。


二、自定义标签的开发步骤，快速入门，执行原理和过程
1、定义一个类实现javax.servlet.jsp.tagext.Tag接口或者继承TagSupport，该类称为标签处理类
package com.itheima.tag;


import java.io.IOException;


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


public class ShowRemoteIpTag extends TagSupport {


public int doStartTag() throws JspException {


String ip = pageContext.getRequest().getRemoteAddr();
try {
pageContext.getOut().write(ip);
} catch (IOException e) {
e.printStackTrace();
}
return super.doStartTag();
}


}
2、在WEB-INF目录下建立一个扩展名为tld的xml文件。用于对标签处理类进行描述。（参考Tomcat中的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">
<description>dsfds</description>
<tlib-version>1.0</tlib-version>
<short-name>itheima</short-name>
<uri>http://www.itheima.com/jsp/tag</uri>
<tag>
<description>show remote ip</description>
<name>showRemoteIp</name>
<tag-class>com.itheima.tag.ShowRemoteIpTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
3、在web。xml中对tld的实际存放位置和tld中的uri进行匹配。（可选步骤，前提是tld放到了WEB-INF目录或者类路径下）
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<jsp-config>
<taglib>
<taglib-uri>http://www.itheima.com/jsp/tag</taglib-uri>
<taglib-location>/WEB-INF/itheima.tld</taglib-location>
</taglib>
</jsp-config>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
</web-app>
4、在JSP中使用
<%@ taglib uri="http://www.itheima.com/jsp/tag" prefix="itheima"%>


三、自定义标签可以完成的功能
1、IterationTag接口。扩展了Tag接口。增加了重复执行主体内容的方法
int doAfterBody():
Tag.SKIP_BODY:忽略主体内容
IterationTag.EVAL_BODY_AGAIN:执行自己again
2、BodyTag接口.扩展了Iteration接口。获取主体内容的方法。
int EVAL_BODY_BUFFERED:


void doInitBody() :容器来调用
void setBodyContent(BodyContent b):b封装了主体内容。容器来调用


四、传统标签详解
五、JSP中自定义标签核心类图
六、简单标签,执行原理和过程
1、javax.servlet.jsp.tagext.SimpleTag
方法：
void doTag():遇到标签容器调用。
JspTag getParent():获取父标签，如果有的话。
void setJspBody(JspFragment jspBody)：容器调用，传入标签的主体内容。JspFragment代表主体内容
void setJspContext(JspContext pc):容器调用。标签处理类实例化后，容器会把PageContext对象传给你。
void setParent(JspTag t):设置父标签。容器调用。


七、tld文件主要标签详解
taglib:根元素
short-name:引用时的短名称
uri：绑定的名称空间
tag：用于描述一个标签
name：标签的名称
tag-class：标签对应的处理类。全名
body-content:指示标签的主体内容的类型。
可选值：
empty：没有主体内容。
JSP:有主体内容。服务于传统标签。JSP文件中能出现啥，主体内容就能出现啥。
scriptless:服务于简单标签。主体内容不能出现java脚本或表达式。
tagdependent：把主体内容原封不动的传递给标签处理类。
attribute：用于描述属性
name：属性名称
required：true|false|yes|no。指示该属性是否是必须的。
rtexprvalue：true|false|yes|no。指示属性的取值是否支持表达式（EL或者Java表达式）