自定义标签的优势:
- 自定义标签可以降低jsp开发的复杂度和维护量,从html角度来说,可以使html不用去过多的关注那些比较复杂的商业逻辑(业务逻辑)。
- 利用自定义标签,可以软件开发人员和页面设计人员合理分工:页面设计人员可以把精力集中在使用标签(HTML,XML中或者JSP)创建网站上,而软件开发人员则可以将精力集中在实现底层功能上面,如国际化等,从而提高了工程生产力将具有共用特性的tag库应用于不同的项目中,体现了软件复用的思想。
步骤:
- 创建一个标签处理器类,并且实现SimpleTag接口(或者直接继承SimpleTagSupport)
- 在WEB-INF文件夹下新建一个.tld(标签库描述文件)为扩展名xml文件,并拷入固定的部分:并对描述文件进行处理,如下:
<description>HelloTag</description>
<display-name>Hello core</display-name>
<tlib-version>1.0</tlib-version>
<!-- 建议在JSP页面上使用的前缀 -->
<short-name>h</short-name>
<!-- 作为tld文件的id,用来唯一标识当前文件的TLD文件,
多个tld文件的URI不能重复,通过JSP页面的taglib的uri引用 -->
<uri>http://www.hxz.com/mytaag/core</uri>
3.对自定义标签进行描述:
<!-- 描述自定义的HelloTag标签 -->
<tag>
<!-- 标签的名字 -->
<name>hello</name>
<!-- 标签所在的类名 -->
<tag-class>com.xz.tag.HelloTag</tag-class>
<!-- 标签的类型 -->
<body-content>empty</body-content>
</tag>
4.在页面中进行使用;
附源文件:
tld文件:
<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
version="2.0">
<!-- 描述TLD文件 -->
<description>HelloTag</description>
<display-name>Hello core</display-name>
<tlib-version>1.0</tlib-version>
<!-- 建议在JSP页面上使用的前缀 -->
<short-name>h</short-name>
<!-- 作为tld文件的id,用来唯一标识当前文件的TLD文件,
多个tld文件的URI不能重复,通过JSP页面的taglib的uri引用 -->
<uri>http://www.hxz.com/mytaag/core</uri>
<!-- 描述自定义的HelloTag标签 -->
<tag>
<!-- 标签的名字 -->
<name>hello</name>
<!-- 标签所在的类名 -->
<tag-class>com.xz.tag.HelloTag</tag-class>
<!-- 标签的类型 -->
<body-content>empty</body-content>
</tag>
<tag>
<name>printcount</name>
<tag-class>com.xz.tag.NameCountTag</tag-class>
<body-content>empty</body-content>
<attribute>
<!-- 标签名 -->
<name>name</name>
<!-- 是否为必须 -->
<required>true</required>
<!-- rtexprvalue->[runtime expression value]
表示当前标签是否接受运行时动态表达式的值 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>value</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
</tag>
<tag>
<name>foreach</name>
<tag-class>com.xz.tag.TestForeach</tag-class>
<body-content>scriptless</body-content>
<attribute>
<!-- 标签名 -->
<name>items</name>
<!-- 是否为必须 -->
<required>true</required>
<!-- rtexprvalue->[runtime expression value]
表示当前标签是否接受运行时动态表达式的值 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>var</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>testJspFragMent</name>
<tag-class>com.xz.tag.TestJspFragment</tag-class>
<body-content>scriptless</body-content>
</tag>
</taglib>
继承自SimpleTag类的彷ForEach类:
package com.xz.tag;
import java.io.IOException;
import java.util.Collection;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;
public class TestForeach extends SimpleTagSupport {
private Collection<?> items;
public void setItems(Collection<?> items) {
this.items = items;
}
private String var;
public void setVar(String var) {
this.var = var;
}
@Override
public void doTag() throws JspException, IOException {
// TODO Auto-generated method stub
//*遍历items对应的集合
if(items!=null) {
for(Object obj:items) {
//把正在遍历里的对象输出到pageContext中,键:var 值:正在便利的对象
getJspContext().setAttribute(var, obj);
//把标签体的内容直接输出到页面上
getJspBody().invoke(null);
}
}
super.doTag();
}
}
遍历所需的Demo类:
package com.xz.pojo;
public class User {
private String name;
private String age;
public void setAge(String age) {
this.age = age;
}
public String getName() {
return name;
}
public String getAge() {
return age;
}
public void setName(String name) {
this.name = name;
}
public User(String name, String age) {
super();
this.name = name;
this.age = age;
}
public User() {
super();
// TODO Auto-generated constructor stub
}
}
JSP页面:
<%@page import="java.util.ArrayList"%>
<%@page import="com.xz.pojo.User"%>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@ taglib prefix="hxz" uri="http://www.hxz.com/mytaag/core" %>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
<%
ArrayList<User> users=new ArrayList<User>();
users.add(new User("hxz","11"));
users.add(new User("zy","12"));
users.add(new User("xy","13"));
request.setAttribute("users", users);
%>
<hxz:foreach var="user" items="${requestScope.users }">
姓名:${user.name } 年龄${user.age }<br>
</hxz:foreach>
<hxz:testJspFragMent>Hello World!</hxz:testJspFragMent>
</body>
</html>
运行结果: