传统标签和简单标签
- 可发自定义标签,其核心就是编写处理器类,一个标签对应一个标签处理器类,而一个标签库则是很多标签处理器的集合。所有标签处理器类都要实现JspTag接口,该接口没有定义任何方法,主要作为Tag和SimpleTag接口的父接口。
- 在JSP2.0以前,所有标签处理器类都必须实现Tag接口,这样的标签称为传统标签。
- JSP2.0规范又定义了一种新的类型的标签,称为简单标签,其对应的处理器类要实现SimpleTag接口
自定义标签的开发与应用步骤
- 编写完成标签功能的Java类(标签处理器)
- 编写标签库描述(tld)文件,在tld文件中对自定义中进行描述
- 在JSP页面中导入和使用自定义标签
自定义标签
(1)创建一个标签处理器类:实现SimpleTag接口
(2)在WEB-INF文件夹下新建一个.tld(标签库描述文件)为扩展名的xml文件。
(3)在tld文件中描述自定义的标签:
<?xml version="1.0" encoding="ISO-8859-1"?>
<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.0</tlib-version>
<!--建议在JSP页面上使用的标签前缀-->
<short-name>myshortname</short-name>
<!--作为tld文件的id,用来唯一标识当前的TLD文件,多个tld文件的URI不能重复。
通过JSP页面的taglib标签的uri属性来引用-->
<uri>http://mycompany.com</uri>
<!-- Invoke 'Generate' action to add tags or functions -->
<!--描述自定义的HelloSimpleTag标签-->
<tag>
<!--标签名:在JSP页面上使用标签时的名字-->
<name>hello</name>
<!--标签所在的全类名-->
<tag-class>com.demo.tag.HelloSimpleTag</tag-class>
<!--标签体的类型-->
<body-content>empty</body-content>
</tag>
</taglib>
(4)在JSP页面上使用自定义标签
》使用taglib指令导入标签库描述文件
<%@taglib prefix="yhs" uri="http://mycompany.com" %>
》使用自定义的标签:
<yhs:hello/>
需要导入两个包:
<dependency>
<groupId>javax.servlet.jsp.jstl</groupId>
<artifactId>javax.servlet.jsp.jstl-api</artifactId>
<version>1.2.2</version>
</dependency>
<!-- https://mvnrepository.com/artifact/taglibs/standard -->
<dependency>
<groupId>taglibs</groupId>
<artifactId>standard</artifactId>
<version>1.1.2</version>
</dependency>
创建一个类实现SimpleTag接口
package com.demo.tag;
import javax.servlet.jsp.JspContext;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.JspFragment;
import javax.servlet.jsp.tagext.JspTag;
import javax.servlet.jsp.tagext.SimpleTag;
import java.io.IOException;
public class HelloSimpleTag implements SimpleTag {
@Override
public void doTag() throws JspException, IOException {
System.out.println("doTag");
}
@Override
public void setParent(JspTag jspTag) {
System.out.println("setParent");
}
@Override
public JspTag getParent() {
System.out.println("getParent");
return null;
}
@Override
public void setJspContext(JspContext jspContext) {
System.out.println("setJspContext");
}
@Override
public void setJspBody(JspFragment jspFragment) {
System.out.println("setJspBody");
}
}