自定义标签类
使用标签可以替换 jsp 页面上的脚本,让页面更加简洁,维护更加方便,增加程序安全性。
在 javaee api 中有一个接口 javax.servlet.jsp.tagext.JspTag , 它是所有的标签的根接口。
在 jsp2.0 以后,定义了一个更加简单的 javax.servlet.jsp.tagext.SimpleTag,这个接口就描述了如何自定义标签。
标签的分类:
- 传统标签
- 简单标签 SimpleTag
SimpleTag 体系
SimpleTag 有一个实现类 SimpleTagSupport ,自定义标签类一般会继承它。
定义一个标签的步骤:
- 定义一个标签类让它实现 SimpleTag 接口或继承 SimpleTagSupport 类
- 做一个标签的描述文件 .tld 文件,在这个文件中来对标签进行描述
- 在 jsp 页面上使用自定义标签。
关于 SimpleTag 接口的方法描述
- doTag 方法它的作用:描述标签的功能 (会被自动调用)
- setJspContext : 它的参数是JspContext,它的作用是将页面的pageContext对象传递到标签类中。(很大用途,用于获取其他八大对象)
- setJspBody : 将标签体的内容缓存到内存对象中,而参数JspFragment 相当于标签体内容。
- getParent setParent 将标签的父标签引入。(基本不用)
下面是一个自定义标签类:(是一个多次打印标签体内容的 java 类)
package online.mytag; import java.io.IOException; import java.io.StringWriter; import javax.servlet.jsp.JspException; import javax.servlet.jsp.JspWriter; import javax.servlet.jsp.tagext.SimpleTagSupport; public class PrintTag extends SimpleTagSupport { private int count; public int getCount() { return count; } public void setCount(int count) { this.count = count; } @Override public void doTag() throws JspException, IOException { //创建一个流,用于接收标签体的内容 StringWriter sw = new StringWriter(); getJspBody().invoke(sw); String str = sw.toString(); JspWriter out = getJspContext().getOut(); for (int i = 0; i < count; i++) { out.write(str); } } }
下面是一个自定义标签类:(用于获取浏览器端的 ip 地址)
package online.mytag; import java.io.IOException; import javax.servlet.jsp.JspException; import javax.servlet.jsp.PageContext; import javax.servlet.jsp.tagext.SimpleTagSupport; public class IpTag extends SimpleTagSupport { /** * 向浏览器输出浏览器的ip */ @Override public void doTag() throws JspException, IOException { String ip = (String)((PageContext)(getJspContext())).getRequest().getRemoteAddr(); getJspContext().getOut().write(ip); } }
上面两个标签实现类对应的 .tld 文件:
<?xml version="1.0" encoding="UTF-8"?> <taglib version="2.1" 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"> <tlib-version>1.0</tlib-version> <short-name>my</short-name> <!-- 这里是使用该标签时taglib的refer属性值:<%@taglib uri="online.mytag.IpTag" prefix="my"%> --> <uri>http://java.sun.com/jsp/jstl/mytag</uri> <!-- 这里是使用该标签时taglib的uri属性 --> <tag> <!-- 这里的每一个<tag>都指定一个标签java类 --> <description>输出浏览器端的ip</description> <!-- 一些描述,也就是注释 --> <name>getIp</name> <!-- 使用该标签类时的标签名 --> <tag-class>online.mytag.IpTag</tag-class> <!-- 标签类的全类名 --> <body-content>empty</body-content> <!-- 这个属性说明是否有标签体 --> </tag> <tag> <description>根据标签属性值循环输出标签体</description> <name>print</name> <tag-class>online.mytag.PrintTag</tag-class> <body-content>scriptless</body-content> <attribute> <!-- 指的是标签类中的字段,有几个字段,就有几个attribute标签 --> <description>循环的次数</description> <name>count</name> <!-- 使用该标签时,标签中的属性名 --> <required>true</required> <!-- 指明该属性是否是必需的 --> <rtexprvalue>true</rtexprvalue> <!-- 指明该属性是否支持el表达式 --> </attribute> </tag> </taglib>
在 jsp 页面中使用自定义标签:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%> <%@taglib uri="online.mytag.IpTag" prefix="my"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <my:getIp/> <my:print count="2"> hello tag </my:print> </body> </html>
画个图说明下 tag 标签下的子标签:(注意: attribute 对应的字段必须在标签类中提供对应的 get/set 方法)
总结下自定义标签:
我们使用的是简单标签,也就是通过实现 SimpleTag 或继承 SimpleTagSupport 来实现自定义标签。
基本步骤:
1.创建标签类 implements SimpleTag extends SimpleTagSupport类
- JspContext 它就代表的是jsp页面上的pageContext对象
- JspFragment 它就代表的是标签体中的内容,通过它的 invoke() 方法可以将标签体的内容指定到 invoke() 方法参数的输出流输出,如果为 null ,默认是当前 jsp 页面关联的 out 对象。
2.在WEB-INF/创建一个 .tld 文件
- 使用 <tag> 来描述标签
- 使用 <tag> 下的 <name> 来定义标签名称
- 使用 <tag> 下的 <tag-class> 来定义标签类的
- 使用 <tag> 下的 <body-content> 来描述标签体中是否有内容,可以使用的值有两个 :empty scriptless
- 使用 <tag> 下的 <attribute> 来描述属性,但是必须在标签类中提供对应的get/set方法
- 使用 <attribute> 下的 <name> 来声明属性名称
- 使用 <attribute> 下的 <required> 来声明属性是否必须存在
- 使用 <attribute> 下的 <rtexprvalue> 来声明属性是否可以使用el表达式
注意:
- 在 .tld 文件创建时,要选择 2.0 以上版本,并且 .tld 文件创建后有缺陷,需要手动将 schemaLocation 中第一个值复制一份放到 xsd 文件前
(xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd")
3.在 jsp 页面上使用 taglib 导入标签
- 使用标签必须使用 taglib 先导入标签才能用。