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>