JSP自定义标签库

TLD: 即标签库的描述符

自定义JSP标签库的步骤如下：

1.创建相对应的Java类

假设有如下类，该类里有一个方法用于得到商品的类别数目。

public class EShop {
	public EShop() {
	}

	public static ArrayList getCats() {
		ArrayList values = new ArrayList();

		values.add(new Category("1", "Systems"));
		values.add(new Category("2", "Software"));
		values.add(new Category("3", "Books"));
		values.add(new Category("4", "Muisc"));
		return values;
	}
//ignore others

}

2.创建对应的TLD文件，用于包装Java类。通常放在WEB-INF下的tag文件夹中

e.g eshop-taglib.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">

	<description>A taglib for eshop functions.</description>
	<tlib-version>1.0</tlib-version>
	<short-name>EShopunctionTaglib</short-name>
	<uri>/EShopFunctionTagLibrary</uri>
	<function>
		<description>Obtain the catalog categories</description>
		<name>getCats</name>
		<function-class>test.begjsp.ch3.EShop</function-class>
		<function-signature>java.util.ArrayList getCats()</function-signature>
	</function>
</taglib>

注：tld文件的书写规范可以参考jstl标签库中的tld文件，复制一个过来修改即可

这里最重要的有三个标签 <name>, <function-class>, <function-signature>, 这三个标签要和相应java类对应

3.在web.xml文件中声明该标签库

  <jsp-config>
	  <taglib>
	  	<taglib-uri>
	  		/WEB-INF/tag/eshop-taglib.tld
	  	</taglib-uri>
	  	<taglib-location>
	  		/WEB-INF/tag/eshop-taglib.tld
	  	</taglib-location>
	  </taglib>
  </jsp-config>

<taglib-uri>用于指定关联的URI（即使用时声明的那个URI）

<taglib-location>用于指定TLD文件的存放位置

4.使用

在jsp页面使用该标签库时，首先要使用taglib指令指定该标签库文件，这和指定JSTL的标签库语法是一致的

这里的URI即在web.xml文件中指定的uri

<%@ taglib prefix="wxshop" uri="/WEB-INF/tag/eshop-taglib.tld"%>

在Jsp页面中得到所有的类别，可用如下方式

<c:set var="cats" value="${wxshop:getCats() }" scope="application">

该语句将所有的类别存放到了一个cats变量中，可以遍历它的内容

<c:forEach var="curCat" items="${cats}">
	${curCat.name}
</c:forEach>

可见，自定义标签库文件总是与JSTL标签库结合使用的，应该避免在页面中使用java的脚本片断。而是使用jstl+el的形式。