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>