在本章中，我们将讨论JSP中的自定义标签。自定义标签是用户定义的JSP语言元素。当包含自定义标签的JSP页面被转换成一个servlet时，标签被转换为一个名为标签处理程序的对象的操作。 然后，Web容器在执行JSP页面的servlet时调用这些操作。
JSP标签扩展允许创建可以直接插入JSP的新标签。JSP 2.0规范引入了用于编写这些自定义标签的简单标签处理程序。
要编写自定义标签，可以简单地扩展SimpleTagSupport类并覆盖doTag()方法，可以在这个方法中放置代码来为标签生成内容。
创建标签示例
为了更好的演示如何使用JSP中的自定义标签，打开Eclipse创建一个动态Web项目：CustomTags，其项目结构如下所示 -
假设要定义一个名为的自定义标签，并且希望以下列方式来使用它：
要创建自定义JSP标记，必须首先创建一个充当标记处理程序的Java类。在这个示例中创建一个HelloTag类，如下所示：
文件：HelloTag.java
package com.yiibai;
import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;
public class HelloTag extends SimpleTagSupport {
public void doTag() throws JspException, IOException {
JspWriter out = getJspContext().getOut();
out.println("您好，这是一个自定义标签内容!");
}
}
上述代码只是简单的编码，其中doTag()方法使用getJspContext()方法获取当前的JspContext对象，并使用它发送“Hello Custom Tag！”到当前的JspWriter对象
最后，创建以下标签库文件：{webapps}/WEB-INF/custom.tld ， 内容如下 -
1.0
2.0
Custom TLD
Hello
com.yiibai.HelloTag
empty
在JSP程序中使用上面定义的自定义标签Hello，如下所示：
pageEncoding="UTF-8"%>
自定义标签示例
以下是自定义标签输出的内容：
调用上述JSP，这应该产生以下结果 -
访问标签体
可以在标签正文中添加一条消息，如标准标签所示。 考虑想定义一个名为的自定义标签，并且使用下面的方式来使用它 -
This is message body
在上述标签代码中进行以下更改来处理标签的正文 -
package com.yiibai;
import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;
import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;
public class HelloTag extends SimpleTagSupport {
StringWriter sw = new StringWriter();
public void doTag()
throws JspException, IOException {
getJspBody().invoke(sw);
getJspContext().getOut().println(sw.toString());
}
}
这里，由调用产生的输出首先捕获到一个StringWriter中，然后再写入与该标签关联的JspWriter。需要更改TLD文件，如下所示：
文件：custom.tld
1.0
2.0
Example TLD with Body
Hello
com.yiibai.HelloTag
scriptless
现在在正文中调用上面的标签，如下所示：
文件：index2.jsp
pageEncoding="UTF-8"%>
自定义标签示例
以下是自定义标签输出的内容：
这是标签体的内容
执行上面示例代码，将得到以下结果 -
自定义标签属性
也可以使用各种属性以及自定义标签。要接受属性值，自定义标签类需要实现setter方法，与JavaBean setter方法相同，如下所示：
文件：CTagAttr.java
package com.yiibai;
import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;
public class CTagAttr extends SimpleTagSupport {
private String message;
public void setMessage(String msg) {
this.message = msg;
}
StringWriter sw = new StringWriter();
public void doTag()
throws JspException, IOException {
if (message != null) {
/* Use message from attribute */
JspWriter out = getJspContext().getOut();
out.println( message );
} else {
/* use message from the body */
getJspBody().invoke(sw);
getJspContext().getOut().println(sw.toString());
}
}
}
属性的名称是message，所以setter方法是setMessage()。现在使用元素在TLD文件中添加此属性，如下所示：
1.0
2.0
Example TLD with Body
Hello
com.yiibai.CTagAttr
scriptless
message
在JSP中使用HelloTag的message属性如下 -
文件：ctagattr.jsp
pageEncoding="UTF-8"%>
自定义标签属性示例
以下是自定义标签输出的内容：
这将产生以下结果 -
下面是包括的属性及说明 -
编号
属性
描述
1
name
name元素定义属性的名称。每个属性名称对于特定标签必须是唯一的。
2
required
此规范如果此属性是必需的或是可选的。则可设置为：false。
3
rtexprvalue
声明tag属性的运行时表达式值是否有效
4
type
定义此属性的Java类类型。 默认情况下，它被假定为String类型
5
description
可以提供信息描述。
6
fragment
声明此属性值是否应被视为JspFragment。
以下是指定属性相关属性的示例 -
.....
attribute_name
false
java.util.Date
false
.....
如果使用两个属性，则可以按如下所示修改TLD：
.....
attribute_name1
false
java.util.Boolean
false
attribute_name2
true
java.util.Date
.....
JSP自定义标签属性操作数据库示例
在上面几个示例中，我们已经演示了如何创建一个自定义标签，打印给定标签名称和特定属性内容。这里将进一步演示如何在自定义标签中读取数据库表中的数据记录。假设要使用自定义标签来显示最新入职的3名员工，参考以下实现步骤。
创建数据库和表 -
DROP TABLE IF EXISTS `employees`;
CREATE TABLE `employees` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(64) NOT NULL DEFAULT '',
`age` int(3) unsigned NOT NULL DEFAULT '0',
`education` varchar(32) DEFAULT '' COMMENT '学历',
`address` varchar(254) DEFAULT NULL,
`salary` float(8,2) unsigned DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM AUTO_INCREMENT=16 DEFAULT CHARSET=utf8;
-- ----------------------------
-- Records of employees
-- ----------------------------
INSERT INTO `employees` VALUES ('1', '李家诚', '23', '其它', '海口市人民大道1800号', '8900.00');
INSERT INTO `employees` VALUES ('2', '张辉', '28', '本科', '广州天河区珠村市场', '19999.99');
INSERT INTO `employees` VALUES ('3', '林贤弟', '29', '博士', '广州白云区龙塘村120号', '18990.99');
INSERT INTO `employees` VALUES ('4', '王小简', '23', '本科', '海口人民大道1688号', '899.98');
INSERT INTO `employees` VALUES ('5', '蔡世杰', '27', '专科', '上海市宝山区联杨路2211弄26号', '15800.00');
创建一个Java类文件：Employee.java
package com.yiibai;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.TagSupport;
import java.sql.*;
public class EmployeeTag extends TagSupport {
private String number;
public String getNumber() {
return number;
}
public void setNumber(String number) {
this.number = number;
}
public int doStartTag() throws JspException {
JspWriter out = pageContext.getOut();
try {
Class.forName("com.mysql.jdbc.Driver");
Connection con = DriverManager.getConnection("jdbc:mysql://localhost/testdb?useSSL=false&characterEncoding=utf8", "root", "123456");
PreparedStatement ps = con.prepareStatement("SELECT name,education,age FROM `employees` ORDER BY id DESC limit "+this.number);
//ps.setInt(1, Integer.parseInt(this.number));
System.out.println("number => "+this.number);
ResultSet rs = ps.executeQuery();
if (rs != null) {
// column name
out.write("
out.write("
");
out.write("
姓名学历年龄");
out.write("
");
// column value
while (rs.next()) {
out.write("
");
out.write("
" + rs.getString("name") + "" + rs.getString("education") + "" + rs.getString("age") + "");
out.write("
");
}
out.write("
");
}
con.close();
} catch (Exception e) {
System.out.println(e);
}
return SKIP_BODY;
}
}
文件：empl.tld
/p>
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"/j2ee/dtd/web-jsptaglibrary_1_2.dtd">
1.2
2.0
c
yiibai
NewEmpl
com.yiibai.EmployeeTag
number
true
文件：new_empl.jsp
pageEncoding="UTF-8"%>
自定义标签+数据库
最新加入的3位员工：
在编写完成上面示例代码后，运行这个JSP文件，应该会看到以下结果 -
¥ 我要打赏
纠错/补充
收藏
加QQ群啦，易百教程官方技术学习群
注意：建议每个人选自己的技术方向加群，同一个QQ最多限加 3 个群。
