转自:草叶居 http://www.topxp.org/?url=html/tech/4028813c0efa46d1010efa53e2ad0001.html
Taglib部署的三种方式
目录
1. Taglib的编写
2. tld文件
3. Taglib的部署
3.1 简单部署
3.1.1 方式一
3.1.2 方式二
3.2 打包部署
3.2.1 JSP使用方式一:用URI直接指定jar文件的位置
3.2.2 JSP使用方式二:使用定制的URI
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” 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>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文件命名为其它的名字,如topxpabc.tld。
在JSP中,需要使用下面的方式来定义:
<%@ taglib prefix=”topxp” uri=”http://www.topxp.org/taglib” %>
可以看到,在这样的情况下,我们可以在一个jar包中包含任意多个tld文件。
<script type="text/javascript"> </script> <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script>