tomcat - 如何在 JSP taglib 元素中定义示例？

Question

我目前正在编写一堆 JSP 标签供我们的设计师使用。在我的 .tld 文件中，我有一些 <tag>还有更多<tag-file>元素。

现在，我想给标签库的用户一些关于如何使用它们的例子。根据Sun's documentation两者 <tag-file>和 <tag>允许元素有 <example>元素。

这适用于 <tag> , 但每当我尝试在 <tag-file> 中举一个例子时Eclipse 和 Tomcat 都会抛出错误。

有人有这方面的经验吗？

Answer 1

<example>元素是在 Servlet 2.4/JSP 2.0 中引入的。

除了像下面这样将 taglib 根声明为 JSP taglib 2.0 之外

<taglib 
    xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
    version="2.0">

您是否也在使用支持 Servlet 2.4/JSP 2.0 的应用服务器？例如 Tomcat 5.x 或更新版本。如果没有，那么您需要升级。如果是这样，那么这个问题:是否在 web.xml 中声明了正确的 Servlet 版本(至少 2.4)？ ？如果没有，请确保您这样做:

<web-app 
    xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
    version="2.4">

或者，如果您已经在使用支持 Servlet 2.5 的应用服务器(例如 Tomcat 6.x)，那么只需声明 Servlet 2.5 是最新的:

<web-app 
    xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_5.xsd"
    version="2.5">

如果您不想升级应用服务器或更改 web.xml 中的 Servlet API 版本声明, 那么您需要忍受不能使用 <example> 的事实元素。