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).
ПРИМЕЧАНИЕ:Для получения полной и новейшей информации обращайтесь к электронным ресурсам на веб-сайте Apache MyFaces Trinidad.
Обязательное дополнение
Для настройки базового RenderKit Trinidad необходимо следующее дополнение ресурса конфигурации приложения JSF:
<application>
<default-render-kit-id>org.apache.myfaces.trinidad.core</default-render-kit-id>
</application>