1.自定义标签的步骤:
1)编写一个标签处理器程序,继承SimpleTagSupport类
/**
* 标签处理器类
* @author APPle
*
*/
public class ShowIpTag extends SimpleTagSupport{
/**
* 执行标签
*/
@Override
public void doTag() throws JspException, IOException {
//得到request对象
PageContext pageContext = (PageContext)this.getJspContext();
HttpServletRequest request = (HttpServletRequest)pageContext.getRequest();
//得到客户ip
String ip = request.getRemoteHost();
//写出浏览器
pageContext.getOut().write("自定义标签实现获取客户端IP地址:"+ip);
}
}
2)在WEB-INT目录下建立tld文件,例如itcast.tld,内容如下:
<?xml version="1.0" encoding="UTF-8" ?>
<taglib 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-jsptaglibrary_2_1.xsd"
version="2.1">
<!-- 标签库版本 -->
<tlib-version>1.1</tlib-version>
<!-- 标签库的缩写:简单名称 -->
<short-name>itcast</short-name>
<!-- tld文件的唯一标记 -->
<uri>http://gz.itcast.cn</uri>
<!--标签定义 -->
<tag>
<!-- 标签名称 -->
<name>showIp</name>
<!-- 标签对应的处理器程序 -->
<tag-class>gz.itcast.c_tag.ShowIpTag</tag-class>
<!-- 标签体输出格式 -->
<body-content>scriptless</body-content>
</tag>
</taglib>
3)在jsp页面中导入自定义标签库,再使用标签库中的标签
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@taglib uri="http://gz.itcast.cn" prefix="itcast"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>第一个自定义标签</title>
</head>
<body>
<%
//得到客户IP地址
//String ip = request.getRemoteHost();
//out.write("客户的IP地址为: "+ip);
%>
<itcast:showIp></itcast:showIp>
</body>
</html>
2.自定义标签的执行过程
前提: tomcat服务器在加载day14web应用时,读取web.xml和tld文件。
浏览器: http://localhost:8080/day14/01.demo.jsp
<itcast:demo1></itcast:demo1>
1)服务器读取01.demo.jsp文件,从上下往下读取文件。
2)读到<%@taglib%/>指令,检查是否存在指定uri的tld文件。如果没找到,报错!!
3)读到demo1的标签。在tld文件中查询是否存在name名称为demo1的tag标签。如果找不到,报错!!
4)得到tag标签中的tag-class内容。标签处理类: gz.itcast.a_tag.DemoTag1
5)实例化DemoTag1对象
6)调用DemoTag1类中的方法
3.SimpleTag接口方法
void setJspContext(JspContext pc) 设置pageContext上下文件对象。传入当前jsp页面的PageContext对象。在标签处理类中通过getJspContext()方法得到PageContext对象
void setParent(JspTag parent) 设置父标签对象。传入父标签对象;如果没有父标签则不调用此方法。通过getParent()方法得到父标签对象。
void setJspBody(JspFragment jspBody) 设置标签体内容。把标签体内容封装到JspFragment对象中然后通过此方法传入。通过getJspBody()方法得到标签体内容。如果没有标签体则不调用次方法。
void doTag() 执行标签。
4.查询源代码了解标签的执行过程
private boolean _jspx_meth_itcast_005fdemo1_005f0(javax.servlet.jsp.tagext.JspTag _jspx_parent, PageContext _jspx_page_context)
throws Throwable {
PageContext pageContext = _jspx_page_context;
JspWriter out = _jspx_page_context.getOut();
// itcast:demo1
1)实例化DemoTag1对象
gz.itcast.a_tag.DemoTag1 _jspx_th_itcast_005fdemo1_005f0 = new gz.itcast.a_tag.DemoTag1();
org.apache.jasper.runtime.AnnotationHelper.postConstruct(_jsp_annotationprocessor, _jspx_th_itcast_005fdemo1_005f0);
2)调用setJspContext方法,传入pageContext
_jspx_th_itcast_005fdemo1_005f0.setJspContext(_jspx_page_context);
3)调用setParent方法,传入父标签对象(DemoTag2)
_jspx_th_itcast_005fdemo1_005f0.setParent(_jspx_parent);
4)调用setJspBody,传入标签体内容(JspFragment)
_jspx_th_itcast_005fdemo1_005f0.setJspBody(new Helper( 1, _jspx_page_context, _jspx_th_itcast_005fdemo1_005f0, null));
5)调用doTag,执行标签
_jspx_th_itcast_005fdemo1_005f0.doTag();
org.apache.jasper.runtime.AnnotationHelper.preDestroy(_jsp_annotationprocessor, _jspx_th_itcast_005fdemo1_005f0);
return false;
}