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

Question

我目前正在编写一堆 JSP 标签供我们的设计人员使用。在我的 .tld 文件中，我有一些 和更多 元素。

现在，我想向标签库的用户提供一些如何使用它们的示例。根据Sun 的文档，< tag-file> 和 元素允许有一个 元素。

这对于 效果很好，但是每当我尝试将示例放入 时，Eclipse 和 Tomcat 都会抛出错误。

有人有这方面的经验吗？

Answer 1

元素是在 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 版本声明，那么您需要接受无法使用 的事实元素。

Answer 2

它适用于 Tomcat 6.0。这是我的文件，

<tagtoc name="Configuration Components">
  <tag-file>
    <description>Get configured value</description>
    <display-name>get</display-name>
    <name>get</name>
    <path>/META-INF/tags/config/get.tag</path>
    <example>
       <![CDATA[
               <config:get key="username" echo="true" />
      ]]>
      <usage>
        <comment>
          <p>
            See config-test.jsp in the example application.
          </p>
        </comment>
      </usage>
    </example>
  </tag-file>

...