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文件
<?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 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 >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 divfix=”topxp” uri=”http://www.topxp.org/taglib” %>
可以看到，在這樣的情況下，我們可以在一個jar包中包含任意多個tld文件。
from:http://java.ccidnet.com/art/3559/20070824/1188833_1.html