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