Apache MyFaces Trinidad - Kezdeti beállítási útmutató

Áttekintés

Ez az útmutató segítséget nyújt egy Apache MyFaces Trinidad ("Trinidad") JSF függvénytárat használó dinamikus webalkalmazás kezdeti beállításához. Bár az útmutatónak a szándék szerint elegendő információt kell tartalmaznia ahhoz, hogy végigvezesse a felhasználót a kezdeti beállításon, a teljes és aktuális információk forrásaként mégis a Trinidad webhelyet kell figyelembe venni. Az útmutató célja inkább a Trinidad beállítása az Eclipse Web Tools Platform ("WTP") keretrendszeren belüli használatára, és nem annyira egy általános Trinidad beállítási útmutatás (habár a központi alapelvek nem csak a WTP esetén érvényesek).

Dinamikus webprojekt beállítása

JSF függvénytár konfiguráció

Mint minden keretrendszer, a Trinidad is megköveteli bizonyos függvénytárak jelenlétét az osztályútvonalon. Néhány könyvtárat biztosíthat a kiszolgáló futási környezet (például egy Java EE 5 kiszolgáló futási környezet valószínűleg biztosít egy JSF 1.2 megvalósítást és a JSTL 1.2 változatot). Amikor a kiszolgáló futási környezet nem biztosítja a szükséges függvénytárakat, akkor javasolt ezeket felhasználói függvénytár(ak)ként hozzáadni (tanulmányozza ezt: JSF függvénytárak létrehozása és frissítése).

Dinamikus webprojekt konfiguráció

Egy dinamikus webprojekt létrehozásakor adja meg a JavaServer Faces (1.1 vagy 1.2 változat a követelményektől függően) projekt "konfigurációt", az alábbiak szerint:

JavaServer Faces v1.2 projekt

Folytassa a varázslót a JSF képességek oldalig. Ezen az oldalon válassza ki a korábban létrehozott szükséges JSF függvénytárakat, az alábbiak szerint:

JSF képességek

Megjegyzés: Ha a JSF függvénytárakat a fentitől eltérő nevekkel hozta létre, akkor a rendelkezésre álló függvénytárnevek eltérőek lehetnek.

Fejezze be a varázslót a dinamikus webprojekt létrehozásához.

Webalkalmazás leírófájl bővítések

A webalkalmazás leírófájljához (.../WEB-INF/web.xml) bizonyos sorokat feltétlenül hozzá kell adni, más bővítések elhagyhatók.

Megjegyzés: A teljes és aktuális információkért tekintse meg az online információforrásokat az Apache MyFaces Trinidad webhelyen.

Kötelező bővítések

A következő bővítéseket feltétlenül el kell végezni a webalkalmazás leírójában a Trinidad resource (erőforrás) szervletének beállításához (ez szolgáltatja a stíluslapokat, parancsfájlokat és képeket futási időben):

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

A következő bővítéseket is el kell végezni a webalkalmazás leírójában a Trinidad szűrő beállításához:

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

Megjegyzés: A fenti filter-mapping feltételezi, hogy a "faces" szabványos JSF szervlet servlet-name van megadva - ez a felhasználói beállítástól függően eltérő lehet, így annak megfelelően kell megadni.

Elhagyható bővítések

A webalkalmazás leírójának alábbi bővítései elhagyhatók, az adott alkalmazás követelményeitől függően:

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

Megjegyzés: Ezen elhagyható bővítések egy része Trinidad-specifikus, mások nem.

JSF alkalmazás konfigurációs erőforrás bővítések

A JSF alkalmazás konfigurációs erőforrások (általában .../WEB-INF/faces-config.xml) bővítése ugyancsak szükséges.

Megjegyzés: A teljes és aktuális információkért tekintse meg az online információforrásokat az Apache MyFaces Trinidad webhelyen.

Kötelező bővítés

A következő bővítést feltétlenül hozzá kell adni a JSF alkalmazás konfigurációs erőforráshoz a Trinidad törzs RenderKit konfigurálásához:

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