Как определить пример в элементе JSP taglib <tag-file>?

Question

В настоящее время я пишу кучу тегов JSP для использования нашими дизайнерами. В моем файле .tld у меня есть <tag> и еще много <tag-file> элементов.

Теперь я хочу дать пользователям библиотеки тегов несколько примеров того, как их использовать. Согласно документации Sun элементам <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 или новее. Если нет, то вам нужно обновить. Если так, то этот вопрос: правильная ли версия сервлета (по крайней мере 2.4) была объявлена ​​в web.xml? Если нет, то убедитесь, что вы делаете это:

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

Если вы не хотите обновлять сервер приложений или изменять объявление версии Servlet API в web.xml, вам необходимо учитывать тот факт, что вы не можете использовать элемент <example>.

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>

...