taglib的简单过程.

[b]1. taglib的编写[/b]

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();
}
}

[b]2. tld文件[/b]

<?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>

[b]3. taglib的部署[/b]

[b][i]3.1 简单部署[/i][/b]

[i]3.1.1 方式一[/i]

编写tld文件，并且放置到web-inf目录或创建子目录，然后在jsp中，使用taglib指令，指定uri即可：
< %@ taglib divfix=”topxp” uri=”/web-inf/mytaglib.tld” %>
这个指令，直接指向一个tld文件。

[i]3.1.2 方式二[/i]

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

[b]3.2 打包部署[/b]
你也可以将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文件。