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

1. Taglib的编写 <o:p></o:p>

Taglib用于将呈现逻辑进行封装。 <o:p></o:p>

它必须继续自TagSupport类。 <o:p></o:p>

下面是一个简单的例子： <o:p></o:p>

package org.topxp.taglib;<o:p></o:p>

<o:p> </o:p>

import java.io.IOException;<o:p></o:p>

import java.util.Date;<o:p></o:p>

import javax.servlet.jsp.JspException;<o:p></o:p>

import javax.servlet.jsp.JspWriter;<o:p></o:p>

import javax.servlet.jsp.tagext.TagSupport;<o:p></o:p>

<o:p> </o:p>

public class OutTag extends TagSupport {<o:p></o:p>

<o:p> </o:p>

     /**<o:p></o:p>

<o:p> </o:p>

     * @see javax.servlet.jsp.tagext.TagSupport#doEndTag()<o:p></o:p>

<o:p> </o:p>

     */<o:p></o:p>

<o:p> </o:p>

    @Override<o:p></o:p>

<o:p> </o:p>

    public int doEndTag() throws JspException {<o:p></o:p>

<o:p> </o:p>

        JspWriter out = this.pageContext.getOut();<o:p></o:p>

<o:p> </o:p>

        try {<o:p></o:p>

<o:p> </o:p>

            out.println("当前的时间是：" new Date());<o:p></o:p>

<o:p> </o:p>

        } catch (IOException e) {<o:p></o:p>

<o:p> </o:p>

            throw new JspException(e);<o:p></o:p>

<o:p> </o:p>

        }<o:p></o:p>

<o:p> </o:p>

        return EVAL_PAGE;<o:p></o:p>

<o:p> </o:p>

    }<o:p></o:p>

<o:p> </o:p>

 <o:p></o:p>

<o:p> </o:p>

    /**<o:p></o:p>

<o:p> </o:p>

     * @see javax.servlet.jsp.tagext.TagSupport#doStartTag()<o:p></o:p>

<o:p> </o:p>

     */<o:p></o:p>

<o:p> </o:p>

    @Override<o:p></o:p>

<o:p> </o:p>

    public int doStartTag() throws JspException {<o:p></o:p>

<o:p> </o:p>

        return super.doStartTag();<o:p></o:p>

<o:p> </o:p>

    }<o:p></o:p>

<o:p> </o:p>

 }<o:p></o:p>

2. tld文件 <o:p></o:p>

<?xml version="1.0" encoding="ISO-8859-1" ?><o:p></o:p>

<o:p> </o:p>

<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.<o:p></o:p>

//DTD JSP Tag Library 1.2//EN" <o:p></o:p>

"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"><o:p></o:p>

<o:p> </o:p>

<taglib><o:p></o:p>

<o:p> </o:p>

    <tlib-version>1.0</tlib-version><o:p></o:p>

<o:p> </o:p>

    <jsp-version>1.2</jsp-version><o:p></o:p>

<o:p> </o:p>

    <short-name>diego</short-name><o:p></o:p>

<o:p> </o:p>

    <tag><o:p></o:p>

<o:p> </o:p>

       <name>out</name><o:p></o:p>

<o:p> </o:p>

       <tag-class>org.topxp.taglib.OutTag</tag-class><o:p></o:p>

<o:p> </o:p>

       <body-content>empty</body-content><o:p></o:p>

<o:p> </o:p>

       <attribute><o:p></o:p>

<o:p> </o:p>

           <name>name</name><o:p></o:p>

<o:p> </o:p>

           <required>false</required><o:p></o:p>

<o:p> </o:p>

           <rtexprvalue>false</rtexprvalue><o:p></o:p>

<o:p> </o:p>

       </attribute><o:p></o:p>

<o:p> </o:p>

    </tag><o:p></o:p>

<o:p> </o:p>

</taglib><o:p></o:p>

3. Taglib的部署 <o:p></o:p>

3.1 简单部署 <o:p></o:p>

<st1:chsdate isrocdate="false" month="12" w:st="on" islunardate="false" day="30" year="1899">3.1.1</st1:chsdate> 方式一 <o:p></o:p>

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

< %@ taglib divfix=”topxp” uri=”/WEB-INF/mytaglib.tld”%> <o:p></o:p>

这个指令，直接指向一个tld文件。 <o:p></o:p>

<st1:chsdate isrocdate="false" month="12" w:st="on" islunardate="false" day="30" year="1899">3.1.2</st1:chsdate> 方式二 <o:p></o:p>

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

3.2 打包部署 <o:p></o:p>

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

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

<st1:chsdate isrocdate="false" month="12" w:st="on" islunardate="false" day="30" year="1899">3.2.1</st1:chsdate> JSP使用方式一：用URI直接指定jar文件的位置 <o:p></o:p>

Jsp中可以使用下面的指令来指定tld文件的位置：<o:p></o:p>

< %@ taglib divfix=”topxp”uri=”/WEB-INF/lib/topxptaglib.jar” %> <o:p></o:p>

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

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

<st1:chsdate isrocdate="false" month="12" w:st="on" islunardate="false" day="30" year="1899">3.2.2</st1:chsdate> JSP使用方式二：使用定制的URI <o:p></o:p>

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

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

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

<?xml version="1.0" encoding="ISO-8859-1" ?><o:p></o:p>

<o:p> </o:p>

<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.<o:p></o:p>

//DTD JSP Tag Library 1.2//EN" <o:p></o:p>

"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"><o:p></o:p>

<o:p> </o:p>

<taglib><o:p></o:p>

<o:p> </o:p>

    <tlib-version>1.0</tlib-version><o:p></o:p>

<o:p> </o:p>

    <jsp-version>1.2</jsp-version><o:p></o:p>

<o:p> </o:p>

    <short-name>diego</short-name><o:p></o:p>

<o:p> </o:p>

    <uri>http://www.topxp.org/taglib</uri><o:p></o:p>

<o:p> </o:p>

    <tag><o:p></o:p>

<o:p> </o:p>

       <name>out</name><o:p></o:p>

<o:p> </o:p>

       <tag-class>org.topxp.taglib.OutTag</tag-class><o:p></o:p>

<o:p> </o:p>

       <body-content>empty</body-content><o:p></o:p>

<o:p> </o:p>

       <attribute><o:p></o:p>

<o:p> </o:p>

           <name>name</name><o:p></o:p>

<o:p> </o:p>

           <required>false</required><o:p></o:p>

<o:p> </o:p>

           <rtexprvalue>false</rtexprvalue><o:p></o:p>

<o:p> </o:p>

       </attribute><o:p></o:p>

<o:p> </o:p>

    </tag><o:p></o:p>

<o:p> </o:p>

</taglib><o:p></o:p>

这个时候，你可以将你的tld文件命名为其它的名字，如topxpabc.tld。<o:p></o:p>

在JSP中，需要使用下面的方式来定义： <o:p></o:p>

< %@ taglib divfix=”topxp”uri=”http://www.topxp.org/taglib” %> <o:p></o:p>

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