JSP自定义标签

2024-01-13 18:44| 来源: 网络整理| 查看: 265

自定义标签就是用户（开发者）自己定义的标签。自定义标签可以让 JSP 页面中不含有 Java 代码，只含有 HTML 代码和部分标签，就能实现业务逻辑的调用。自定义标签的优点如下：减少 JSP 页面对脚本的需求和依赖性将 JSP 页面和业务逻辑分开，增加了程序的可维护性可重复调用相同的业务逻辑，增加了程序的可重用性使用自定义标签步骤如下：自定义标签实现类编写 tld 标签库描述文件在 JSP 页面中使用自定义标签自定义标签的语法使用 taglib 指令指定 tld 文件的路径。

其中：prefix 指定自定义标签的前缀，uri 指定 tld 文件的路径。使用自定义标签有以下 2 种格式：

或

标签体

其中：prefix 表示自定义标签的前缀，tagname 表示自定义标签的名称，attr 表示自定义标签的属性，value 表示自定义标签的属性值。简单示例下面创建一个简单的自定义标签。 1. 创建处理标签的Java类创建处理标签的 HelloTag 类，代码如下： package net.biancheng; import java.io.IOException; import javax.servlet.jsp.JspException; import javax.servlet.jsp.JspWriter; import javax.servlet.jsp.tagext.SimpleTagSupport; public class HelloTag extends SimpleTagSupport { public void doTag() throws JspException, IOException { JspWriter out = getJspContext().getOut(); out.println("欢迎来到编程帮，我们的网址是：www.biancheng.net"); } } 以上代码重写了doTag() 方法，getJspContext() 方法用来获取 JspContext 对象，并将 out.println 中的内容传递给 JspWriter 对象。

注意：SimpleTagSupport 实现了 SimpleTag 接口，该接口是 JSP 2.X 标签库新增的自定义标签接口类。该接口极其简单，提供了 doTag() 方法去处理自定义标签中的逻辑以及标签体。相对来说，JSP 1.X 比较复杂，处理标签的 Java 类需要继承 TagSupport 类，重写 doStartTag()、doAfterBody()、doEndTag() 等方法。

2. 创建tld标签库描述文件 tld 文件采用 XML 文件格式进行描述，后缀名为 .tld，用来将写好的类映射成 JSP 标签。tld 文件保存在 WEB-INF 目录下，为了管理方便，可以在目录下创建 tlds 文件夹。 custom.tld 代码如下： 1.0 2.0 Example TLD Hello net.biancheng.HelloTag empty 输出内容 tld 文件中只能有一对 taglib 标签，taglib 标签下可以有多个 tag 标签，每个 tag 标签代表一个自定义标签。

文章后面会对 tld 文件中的各个标签进行说明。

3. 使用自定义标签使用自定义标签和使用 JSTL 标签是一样的， JSP 文件中使用 Hello 标签代码如下。编程帮(www.biancheng.net) 运行结果如下。图 1 自定义标签运行结果 tld标签库描述文件 tld 文件中常用的标签有 taglib、tag、attribute 和 variable。下面以 custom.tld 文件为例介绍其含义。 1. 标签标签用来设置整个标签库信息，其说明如下表所示。属性说明 tlib-version 标签库版本号 jsp-version JSP版本号 short-name 当前标签库的前缀 uri 页面引用的自定义标签的 uri 地址 name 自定义标签名称 tag-class 自定义标签实现类路径 description 自定义标签的功能描述 attribute 自定义标签的指定属性，可以有多个 2. 标签标签用来定义标签具体的内容，其说明如下表所示。属性说明 name 自定义标签名称 tag-class 自定义标签实现类 body-content 有 3 个值：empty（表示没有标签体）、JSP（表示标签体可以加入 JSP 程序代码）、tagdependent（表示标签体中的内容由标签自己处理） description 自定义标签的功能描述 attribute 自定义标签功能的指定属性，可以有多个 variable 自定义标签的变量属性 3. 标签标签用来定义标签中的属性，其说明如下表所示。属性说明 name 属性名称 description 属性描述 required 指定属性是否是必须的，默认值：false rtexprvalue 属性值是否支持 JSP 表达式 type 定义该属性的 Java 类型，默认值：String fragment 如果声明了该属性，属性值将被视为一个 JspFragment

使用的属性时要注意元素顺序。

4. 标签标签用来定义标签中的变量属性，其说明如下表所示。属性说明 declare 变量声明 description 变量描述 name-from-attribute 指定的属性名称，其值为变量，在调用 JSP 页面时可以使用的名字 name-given 变量名（标签使用时的变量名） scope 变量的作用范围，有 3 个值：NESTED 开始和结束标签之间、AT_BEGIN 从开始标签到页面结束、AT_END 从结束标签之后到页面结束 variable-class 变量的 Java 类型，默认值：String 自定义标签属性在自定义标签中设置属性，自定义标签类中必须有相应的 setter 方法。为标签添加 message 属性，HelloTag 类代码如下： package net.biancheng; 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 HelloTag extends SimpleTagSupport { private String message; public void setMessage(String message) { this.message = message; } StringWriter sw = new StringWriter(); public void doTag() throws JspException, IOException { if (message != null) { // 从属性中使用 message JspWriter out = getJspContext().getOut(); out.println(message); } else { // 从内容中使用 message getJspBody().invoke(sw); getJspContext().getOut().println(sw.toString()); } } } 下面使用标签为标签添加 message 属性： 1.0 2.0 Example TLD Hello net.biancheng.HelloTag tagdependent message 这时就可以在 JSP 页面中使用 message 属性了，如下：编程帮(www.biancheng.net) 运行结果如图 1 所示。自定义标签的标签体可以像 JSTL 标签库一样在标签中包含消息内容，如在 Hello 标签中包含内容，JSP 使用格式如下：欢迎来到编程帮，我们的网址是：www.biancheng.net 修改 HelloTag 类，如下： package net.biancheng; import java.io.IOException; import java.io.StringWriter; import javax.servlet.jsp.JspException; import javax.servlet.jsp.tagext.SimpleTagSupport; public class HelloTag extends SimpleTagSupport { StringWriter sw = new StringWriter(); public void doTag() throws JspException, IOException { getJspBody().invoke(sw); getJspContext().getOut().println(sw.toString()); } } 修改 custom.tld 文件，如下： 1.0 2.0 Example TLD Hello net.biancheng.HelloTag tagdependent 运行结果如图 1 所示。

【本文地址】

公司简介

联系我们