Apache MyFaces Trinidad - Руководство по первоначальной установке

Обзор

Это руководство предназначено для первоначальной установки динамического веб-приложения для предоставления возможности использования библиотеки JSF Apache MyFaces Trinidad ("Trinidad"). Хотя это руководство содержит достаточную информацию для выполнения первоначальной установки пользователем, веб-сайт Trinidad всегда рекомендуется рассматривать как источник полной и новейшей информации. Это руководство нацелено на установку Trinidad для использования с платформой веб-инструментов Eclipse ("WTP") в большей степени, чем общее руководство по установке Trinidad (несмотря на то, что основные концепции могут не соответствовать WTP).

Настройка динамического веб-проекта

Конфигурация библиотек JSF

Как и всем инфраструктурам, Trinidad требуются определенные библиотеки для нахождения пути к классам. Некоторые библиотеки могут быть предоставлены сервером во время выполнения (например, сервер JEE5 во время выполнения может предоставить реализацию JSF 1.2 и JSTL 1.2). Когда нужные библиотеки не предоставляются сервером во время выполнения, рекомендуется, чтобы они были добавлены как одна или несколько пользовательских библиотек (обратитесь к разделу Создание и обновление библиотек JSF).

Настройка динамического веб-проекта

При создании динамического веб-проекта определите использование "конфигурации" проекта JavaServer Faces (v1.1 или v1.2 в зависимости от требований), как показано далее:

Проект JavaServer Faces v1.2

Пройдите через мастера до страницы Возможности JSF. На этой странице выберите ранее созданные нужные библиотеки, как показано далее:

Возможности JSF

ПРИМЕЧАНИЕ: Если библиотеки JSF были созданы с другими именами, то доступные имена библиотек могут быть другими.

Завершите работу мастера для создания динамического веб-проекта.

Дополнения дескриптора веб-приложения

Одни дополнения дескриптора веб-приложения (.../WEB-INF/web.xml) необходимы, а другие - необязательны.

ПРИМЕЧАНИЕ:Для получения полной и новейшей информации обращайтесь к электронным ресурсам на веб-сайте Apache MyFaces Trinidad.

Необходимые дополнения

Следующие дополнения дескриптора веб-приложения необходимы для настройки сервлета ресурсов Trinidad (который обслуживает таблицы стилей, сценарии и изображения во время выполнения):

  <servlet>
    <servlet-name>resources</servlet-name>
    <servlet-class>org.apache.myfaces.trinidad.webapp.ResourceServlet</servlet-class>
  </servlet>

  <servlet-mapping>
    <servlet-name>resources</servlet-name>
    <url-pattern>/adf/*</url-pattern>
  </servlet-mapping>

Следующие дополнения дескриптора веб-приложения необходимы для настройки фильтра Trinidad:

  <filter>
    <filter-name>trinidad</filter-name>
    <filter-class>org.apache.myfaces.trinidad.webapp.TrinidadFilter</filter-class>
  </filter>

  <filter-mapping>
    <filter-name>trinidad</filter-name>
    <servlet-name>faces</servlet-name>
  </filter-mapping>

ПРИМЕЧАНИЕ: Приведенные отображения фильтра предполагают, что стандартное имя сервлета JSF servlet-name определяется как "лица" - оно может зависеть от пользовательской настройки и поэтому должно определяться соответственно.

Необязательные дополнения

Следующие дополнения дескриптора веб-приложения являются необязательными, в зависимости от конкретных требований приложения:

  <context-param>
    <param-name>javax.faces.STATE_SAVING_METHOD</param-name>
    <param-value>client</param-value>
  </context-param>

  <context-param>
    <param-name>javax.faces.DEFAULT_SUFFIX</param-name>
    <param-value>.jspx</param-value>
  </context-param>

  <context-param>
    <param-name>org.apache.myfaces.trinidad.USE_APPLICATION_VIEW_CACHE</param-name>
    <param-value>false</param-value>
  </context-param>

  <context-param>
    <param-name>org.apache.myfaces.trinidad.CHECK_FILE_MODIFICATION</param-name>
    <param-value>false</param-value>
  </context-param>

  <context-param>
    <param-name>org.apache.myfaces.trinidad.CHANGE_PERSISTENCE</param-name>
    <param-value>session</param-value>
  </context-param>

  <context-param>
    <param-name>org.apache.myfaces.trinidad.resource.DEBUG</param-name>
    <param-value>false</param-value>
  </context-param>

ПРИМЕЧАНИЕ: Одни из этих дополнений специфичны для Trinidad, а другие = нет.

Дополнения ресурса конфигурации приложения JSF

Требуется дополнение ресурса конфигурации приложения JSF (обычно .../WEB-INF/faces-config.xml).

Обязательное дополнение

Для настройки базового RenderKit Trinidad необходимо следующее дополнение ресурса конфигурации приложения JSF:

  <application>
    <default-render-kit-id>org.apache.myfaces.trinidad.core</default-render-kit-id>
  </application>