Taglib打包部署和使用方式

 

1.     Taglib的编写

Taglib用于将呈现逻辑进行封装。它必须继承自TagSupport类。

 

关于Taglib的编写，请参考有关文章：

 

http://www-128.ibm.com/developerworks/cn/java/j-taglib/

 

下面是一个简单的例子：

 

package org.topxp.taglib;   import java.io.IOException; import java.util.Date;   import javax.servlet.jsp.JspException; import javax.servlet.jsp.JspWriter; import javax.servlet.jsp.tagext.TagSupport;   public class OutTag extends TagSupport {       /**      * @see javax.servlet.jsp.tagext.TagSupport#doEndTag()      */     @Override     public int doEndTag() throws JspException {         JspWriter out = this.pageContext.getOut();         try {             out.println("当前的时间是："+new Date());         } catch (IOException e) {             throw new JspException(e);         }         return EVAL_PAGE;     }       /**      * @see javax.servlet.jsp.tagext.TagSupport#doStartTag()      */     @Override     public int doStartTag() throws JspException {         return super.doStartTag();     }   }

 

 

2.     tld文件

<?xml version="1.0" encoding="ISO-8859-1" ?> <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> <taglib>     <tlib-version>1.0</tlib-version>     <jsp-version>1.2</jsp-version>     <short-name>diego</short-name>     <tag>        <name>out</name>        <tag-class>org.topxp.taglib.OutTag</tag-class>        <body-content>empty</body-content>        <attribute>            <name>name</name>            <required>false</required>            <rtexprvalue>false</rtexprvalue>        </attribute>     </tag> </taglib>

 

3.     Taglib的部署

 

3.1  简单部署

 

3.1.1           方式一

编写tld文件，并且放置到WEB-INF目录或创建子目录，然后在JSP中，使用taglib指令，指定URI即可：

 

<%@ taglib prefix=”topxp” uri=”/WEB-INF/mytaglib.tld” %>

这个指令，直接指向一个tld文件。

 

3.1.2           方式二

也可以在web.xml中用taglib-uri和taglib-location标记来定义它的URI和位置的映射，然后在JSP中指定URI的时候，就直接使用在web.xml中定义的URI即可，这个就不举例子了。

 

3.2  打包部署

 

你也可以将taglib打成jar包，这个时候，你的taglib描述文件（tld文件），必须被放置在jar文件内的META-INF目录（或子目录）下。你可以在这个目录下，放置多个tld文件。

 

如果将taglib打包，这个jar包必须被放置在web-inf/lib目录下。在jar包的meta-inf目录下的tld文件，都可以被自动发现，不需要显式的定义其位置。

 

3.2.1           JSP使用方式一：用URI直接指定jar文件的位置

Jsp中可以使用下面的指令来指定tld文件的位置：

 

<%@ taglib prefix=”topxp” ur i=”/WEB-INF/lib/topxptaglib.jar” %>

 

在这种情况下，因为没有直接指定tld文件的位置，所以，tld文件必须遵守一定的命名规则。规则就是：

Tld文件必须命名为：taglib.tld。这样，在meta-inf目录下，只能放置一个tld文件，无法支持多个tld文件。

 

3.2.2           JSP使用方式二：使用定制的URI

如果需要在一个jar包中包含多个tld文件，你必须使用某种方式来区分这些tld文件，这种方式就是：

在tld文件中，用<uri>标记来区别不同的tld文件。如，可以加入下面的<uri>标记进topxptaglib.jar中的tld文件：< ur i>http://www.topxp.org/taglib</uri>

 

在我们的例子中，假设命名为topxp.tld，下面就是topxp.tld文件的内容，请注意添加了<uri>标记：

 

<?xml version="1.0" encoding="ISO-8859-1" ?> <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> <taglib>     <tlib-version>1.0</tlib-version>     <jsp-version>1.2</jsp-version>     <short-name>diego</short-name>     <uri>http://www.topxp.org/taglib</uri>     <tag>        <name>out</name>        <tag-class>org.topxp.taglib.OutTag</tag-class>        <body-content>empty</body-content>        <attribute>            <name>name</name>            <required>false</required>            <rtexprvalue>false</rtexprvalue>        </attribute>     </tag> </taglib>

 

 

这个时候，你可以将你的tld文件命名为其它的名字，如topxp.tld。

在JSP中，需要使用下面的方式来定义：

 

<%@ taglib prefix=”topxp” ur i=”http://www.topxp.org/taglib” %>

 

可以看到，在这样的情况下，我们可以在一个jar包中包含任意多个tld文件。

 

4.     JSTL版本差异

 

Jstl1.0和jstl1.1版本之间，有一个差异是，其URI地址的变化。打开实现包：standard.jar文件，在meta-inf目录下，列出了jstl中所有的标签库描述文件。

 

打开不同版本的TLD文件，就能看到其URI地址的变化。

拿core标签库举例：

在1.0中，其URI定义为：

http://java.sun.com/jstl/core

在1.1中，其URI定义变为：

    http://java.sun.com/jsp/jstl/core

 

所以，在JSP中使用的时候，其URI也要做相应的变化：

 

如，在1.1中：<%@ taglib prefix="c"  uri="http://java.sun.com/jsp/jstl/core" %>

 

特别注意：当使用j2ee1.4以上的规范时（这个规范对应的其它技术的版本分别为：servlet2.4、JSP2.0等），必须使用JSTL1.1版本！！

 

在web.xml中，可以得知当前使用的版本：

如：

<web-app id="WebApp_ID" version="2.4" 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-app_2_4.xsd">

这样的定义，就是使用servlet2.4规范，其对应的就是j2ee1.4和JSP2.0及JSTL1.1。