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的形式。