Taglib的打包部署和使用方式详解

 

1. Taglib的编写

Taglib用于将呈现逻辑进行封装。

它必须继承自TagSupport类。

下面是一个简单的例子：

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文件

    1.0

    1.2

    diego

    

       out

       org.topxp.taglib.OutTag

       empty

       

           name

           false

           false

       

    

3. Taglib的部署

3.1 简单部署

3.1.1 方式一

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

< %@ taglib divfix=”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 divfix=”topxp” uri=”/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文件：< uri > /uri >

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

    1.0

    1.2

    diego

    /uri>

    

       out

       org.topxp.taglib.OutTag

       empty

       

           name

           false

           false

       

    

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

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

< %@ taglib divfix=”topxp” uri=”” %>

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