JSP自定义标签

最新推荐文章于 2025-11-26 21:22:25 发布

最新推荐文章于 2025-11-26 21:22:25 发布 · 79 阅读

文章标签：

本文详细阐述了自定义JSP标签在Web应用中的执行过程及开发流程，包括创建处理类、TLD文件声明、引入标签库等关键步骤。同时，介绍了JSP标签API和标签库描述符的使用，以及一个具体的实例展示如何实现自定义标签。最后，文章还探讨了JSP显示层的使用和相关技术的应用。

自定义JSP标签的执行过程

•当一个含有自定义标签的JSP页面被JSP引擎(Web容器)转译成Servlet时，JSP引擎遇到自定义的标签，会把这个自定义标签转化成对一个称为“标签处理类”的调用。之后，当这个JSP页面被执行时，JSP引擎就会调用这个“标签处理类”对象，并执行其内部定义的相应操作方法，从而完成相应的功能。

自定义JSP标签的开发流程

•使用Java处理类来开发自定义JSP标签时，主要分为下几个步骤。

–创建标签的处理类(TagHandle Class)。这个类用来定义标签的行为，并在JSP引擎遇到自定义标签时调用执行。

–创建标签库描述文件(TagLibrary Descriptor File)。

–在web.xml文件中声明TLD的位置。在JSP1.2以上规范中此步骤是可选的。

–在JSP文件中用taglib指令引入标签库，然后使用标签库描述文件中指定的标签名来使用它。

JSP标签API

•JSP1.1和1.2规范中常用的接口主要有以下3个。

–Tag：此接口定义对于所有标签处理类都需要实现的方法。

–IterationTag：此接口扩展了Tag接口，增加了控制重复执行标签主体的方法。

–BodyTag：此接口扩展了IterationTag接口，并增加了访问和操作标签主体内容的方法。

标签库描述符

•标签库描述符文件是一个以“.tld”结尾的标准XML文档，用来记录一个标签库内拥有哪些标签、每个标签包含哪些属性。

•以下是一个JSP2.0规范的标签库描述文件的内容：

•<taglib>元素是标签库描述符的根元素，它包含12个子元素，详细介绍如下。

–(1)<description>：标签库的一个文本描述。

–(2)<tlib-version>：指定标签库的版本。

–(3)<short-name>：为标签定义简短的名字，在taglib指令中可作为首选的前缀名使用。

–(4)<uri>：定义一个URI，用于唯一地标识此标签库。

–(5)<tag>：用于指定自定义标签的相关信息。

–(6)<display-name>：为标签库指定一个简短的别名。

–(7)<small-icon>：为标签库指定大小为16×16的小图标(gif或jpeg格式)，该图标可在图形界面工具中显示。

–(8)<large-icon>：为标签库指定大小为32×32的大图标(gif或jpeg格式)，该图标可在图形界面工具中显示。

–(9)<validator>：为标签库提供一个验证器。

–(10)<listener>：为标签库提供一个监听器。

–(11)<tag-file>：用于描述标签文件。

–(12)<function>：用于指定在表达式语言中使用的函数。

实例：

标签的处理类

package cn.csdn.web.tag;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.Tag;
import javax.servlet.jsp.tagext.TagSupport;

public class MyIfTagDemo2 extends TagSupport {
private static final long serialVersionUID = 1L;
@Override
public int doEndTag() throws JspException {
// TODO Auto-generated method stub
return Tag.EVAL_PAGE;
//return Tag.SKIP_PAGE;
}
}

标签库描述文件

<tag>
<description>control show body</description>
<name>MyIfTag2</name>
<tag-class>cn.csdn.web.tag.MyIfTagDemo2</tag-class>
<body-content>JSP</body-content>
</tag>
<tag>
<description>Loop control show body</description>
<name>MyLoopTag</name>
<tag-class>cn.csdn.web.tag.MyLoopTag</tag-class>
<body-content>JSP</body-content>
</tag>

JSP 显示层

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="http://www.sword.com" prefix="sword" %>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<base href="<%=basePath%>">
</head>

<body>
<span><b>对标签后的文本输出控制</b></span>
<sword:MyIfTag2></sword:MyIfTag2>
<h1>没忽略我</h1>
<hr color="red">
<span><b>循环控制输出</b></span>
<sword:MyLoopTag>
<h1>蝴蝶与花的故事</h1>
<h1>落花与流水的故事</h1>
</sword:MyLoopTag>
</body>
</html>