自定义标签
标签语言格式
* <开始标签>标签体</结束标签>
* <开始标签 属性名="属性值">标签体</结束标签>
* <开始标签/>hello tag
自定义标签的开发及使用步骤
创建自定义标签类
自定义**Servlet**,自定**Filter**
HelloServlet exetend HttpServlet
LogFilter implemnets Filter
```
package com.donkee.tag;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class HelloTag extends BodyTagSupport {
private static final long serialVersionUID = 4592676587202231659L;
@Override
public int doStartTag() throws JspException {
JspWriter out = pageContext.getOut();
try {
out.print("Hello Custom Tag");
} catch (IOException e) {
e.printStackTrace();
}
return super.doStartTag();
}
}
```
标签库描述文件
* 在WEB-INF下面创建ztag.tld标签描述文件
```
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
<tlib-version>1.0</tlib-version> //标签库版本,不可更改
<jsp-version>2.0</jsp-version> //jsp版本,不可更改
<short-name>Example TLD</short-name> //可更改
<uri>http://zking.com/ztag</uri> <!--uri要唯一-->
<tag>
<name>Hello</name> //名称任意
<tag-class>com.donkee.tag.HelloTag</tag-class> //标签类全路径
<body-content>empty</body-content> //标签体设置:empty为空
</tag>
</taglib>
```
导入标签库
* 创建hello.jsp文件,在JSP通过taglib指令导入标签库描述文件,并通过指定后缀访问此自定义标签
```
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@ taglib prefix="z" uri="http://zking.com/ztag" %>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>hello tag</title>
</head>
<body>
<z:Hello/>
</body>
</html>
* 在浏览器中查看结果如下
```
Hello Custom Tag!
```
标签生命周期
![2021-06-06_143621](自定义标签打包\2021-06-06_143621.png)
```java
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class LifecycleTag extends BodyTagSupport {
public LifecycleTag() {
System.out.println("实列化...");
}
@Override
public int doStartTag() throws JspException {
System.out.println("标签开始....");
setValue("count", 1);
return EVAL_BODY_INCLUDE;
}
@Override
public int doAfterBody() throws JspException {
System.out.println("标签体...");
int count = (Integer)getValue("count");
if(count < 3) {
count++;
setValue("count", count);
return EVAL_BODY_AGAIN;
}
return SKIP_BODY;//跳转到doEndTag()方法
}
@Override
public int doEndTag() throws JspException {
System.out.println("标签结束....");
//执行JSP剩余页面内容,下次访问使用同一实例
return EVAL_PAGE;
//跳到realse()方法,释放资源,当前实例被释放;下次访问重新创建标签实例
// return SKIP_BODY;
}
}
```
1)当服务器打开时,就会加载WEB-INF下的资源文件,包括web.xml 和 tld文件,把它们加载到内存用一个Map存储,key就是tld文件中的uri
2)我们在浏览器输入http://localhost:8080/tag01/lifecycle.jsp来访问jsp页面
3)服务器读取lifecycle.jsp里的内容,当读到<%@ taglib prefix="z" uri="http://zking.com/mytag" %>这一句的时候,就会在内存中找是否存在uri为http://zking.com/mytag的tld文件,找不到就会报错
4)继续读取jsp页面,读到<z:lifecycle>这个标签的时候,就会通过uri去找到tld文件,在tld文件中找到lifecycle是否被定义,是的话就得到它的tag-class的内容,然后去找到它对应的标签处理程序
5)实例化标签处理程序,利用生成的对象调用它里面的方法
这里服务器对标签处理程序里的方法也有一定的调用顺序
A)void setPageContext(PageContext pc) --传入pageContext对象
B)void setParent(Tag t) --如果有父标签,传入父标签对象,如果没有,则传入null
C)int doStartTag() --开始执行标签时调用。
D)int doEndTag() --结束标签时调用
E)void release() --释放资源,当前实例被释放;下次访问重新创建标签实例
* SKIP_BODY:跳过主体
* EVAL_BODY_INCLUDE:计算标签主体内容并[输出]
* EVAL_PAGE:计算页面的后续部分
* SKIP_PAGE:跳过页面的后续部分
* EVAL_BODY_AGAIN:再计算主体一次
SKIP_BODY
1. 实例化标签助手类->doStartTag()------------------------>doEndTag()
//主要用开发简单标签
EVAL_BODY_INCLUDE SKIP_BODY
2. 实例化标签助手类->doStartTag()----------------------->doAfterBody()------------------------------------->doEndTag()...
EVAL_BODY_AGAIN
3. .....
数据交换
自定义标签与jsp的数据交换
jsp页面传给自定义标签,提供必性对应的set方法
标签将数据传给jsp页面,通过作用域通信对象