Apache MyFaces Trinidad - Příručka pro počáteční nastavení
|
Přehled
Tato příručka má za cíl pomoci s počátečním nastavením dynamické webové aplikace pro využití knihovny JSF Apache MyFaces Trinidad ("Trinidad").
I když je cílem poskytnout zde dostačující informace, které uživatele provedou počátečním nastavením, jako zdroj úplných a aktuálních informací je třeba vždy považovat web Trinidad.
Tato příručka je, spíše než jako příručka o obecném nastavení knihovny Trinidad, určena k nastavení knihovny Trinidad pro použití s platformou webových nástrojů Eclipse Web Tools Platform ("WTP"), přestože základní koncepty nemusejí být specifické pro WTP. Nastavení dynamického webového projektu
Konfigurace knihovny JSF
Trinidad, jako každý rámcový systém, vyžaduje, aby v cestě ke třídě byly určité knihovny.
Některé knihovny může poskytovat běhové prostředí serveru (například serverové běhové prostředí JEE5 pravděpodobně poskytne implementaci JSF 1.2 a JSTL 1.2).
Pokud běhové prostředí serveru nezajistí nezbytné knihovny, doporučujeme jejich přidání metodou přidání uživatelských knihoven (pokyny naleznete v tématu Vytváření a aktualizace knihoven JSF).
Konfigurace dynamického webového projektu
Při vytvoření dynamického webového projektu uveďte použití projektu JavaServer Faces (v1.1 nebo v1.2, záleží na požadavcích) Project "Configuration", jak je uvedeno níže:
JavaServer Faces v1.2 Project
Pokračujte podle průvodce až na stránku Schopnosti JSF. Na této stránce vyberte požadované knihovny JSF, které byly předtím vytvořeny, jak ukazuje obrázek níže:
Schopnosti JSF
POZNÁMKA: Pokud byly knihovny JSF vytvořeny s jinými názvy, než je zobrazeno výše, mohou se dostupné názvy knihoven lišit.
Dokončením průvodce vytvořte dynamický webový projekt. Doplnění deskriptoru webové aplikace
Některá doplnění deskriptoru webové aplikace (.../WEB-INF/web.xml) jsou nezbytná, některá doplnění jsou nepovinná.
POZNÁMKA: Úplné a aktuální informace naleznete online na webu Apache MyFaces Trinidad.
Nezbytná doplnění
Při konfiguraci servletu prostředků Trinidad (který za běhu poskytuje seznamy stylů, skripty a obrázky) je třeba provést následující doplnění deskriptoru webové aplikace:
<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>
Následující doplnění deskriptoru webové aplikace je třeba provést ke konfiguraci filtru 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>
POZNÁMKA: Zobrazené mapování filter-mapping předpokládá, že standardní název servletu JSF, servlet-name, je zadán jako "faces" - to se může lišit v závislosti na nastavení uživatele, takže je třeba jej správně uvést.
Nepovinná doplnění
Následující doplnění deskriptoru webové aplikace jsou nepovinná a závisí na specifických požadavcích vaší aplikace:
<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>
POZNÁMKA: Některá z těchto nepovinných doplnění jsou specifická pro Trinidad, některá ne.
Doplnění prostředku konfigurace aplikace JSF
Je třeba provést doplnění prostředku konfigurace aplikace JSF (zpravidla .../WEB-INF/faces-config.xml).
POZNÁMKA: Úplné a aktuální informace naleznete online na webu Apache MyFaces Trinidad.
Nezbytné doplnění
Ke konfiguraci hlavní sady RenderKit knihovny Trinidad je třeba provést následující doplnění prostředku konfigurace aplikace JSF:
<application>
<default-render-kit-id>org.apache.myfaces.trinidad.core</default-render-kit-id>
</application>