Apache MyFaces Trinidad - Podręcznik początkowej konfiguracji
|
Przegląd
Zadaniem tego podręcznika jest pomoc w początkowym skonfigurowaniu
dynamicznej aplikacji WWW do korzystania z biblioteki JSF Apache MyFaces Trinidad ("Trinidad").
Informacje w nim zawarte powinny być wystarczające na potrzeby początkowej konfiguracji,
ale pełne i bieżące informacje można znaleźć w serwisie WWW środowiska
Trinidad.
Podręcznik
ten dotyczy konfigurowania środowiska Trinidad do
użycia z produktem Eclipse Web Tools Platform (WTP) i nie jest ogólnym
podręcznikiem konfigurowania struktury Trinidad (choć podstawowe pojęcia
mogą nie być specyficzne dla produktu WTP).
Konfigurowanie dynamicznego projektu WWW
Konfigurowanie biblioteki JSF
Podobnie jak wszystkie środowiska, środowisko Trinidad wymaga,
aby w ścieżce klas znajdowały się określone biblioteki.
Niektóre biblioteki
mogą być udostępniane przez środowisko wykonawcze serwera (na przykład
środowisko wykonawcze serwera JEE5 najprawdopodobniej udostępni implementację
JSF 1.2 i bibliotekę JSTL 1.2).
Jeśli wymagane biblioteki nie są udostępniane
przez środowisko wykonawcze serwera, zaleca się dodanie ich jako jednej lub
większej liczby bibliotek użytkownika (instrukcje można znaleźć w sekcji
Tworzenie i aktualizowanie bibliotek
JSF).
Konfigurowanie dynamicznego projektu WWW
Podczas tworzenia dynamicznego projektu WWW należy określić użycie konfiguracji
projektu JavaServer Faces (1.1 lub 1.2 w zależności od wymagań), tak jak
pokazano poniżej:
Projekt JavaServer Faces 1.2
W kreatorze należy przejść do strony Możliwości
JSF. Na tej
stronie należy wybrać utworzone wcześniej wymagane biblioteki JSF, tak jak
pokazano poniżej:
Możliwości JSF
UWAGA: Jeśli podczas tworzenia bibliotek JSF użyto
nazw innych niż te przedstawione powyżej, nazwy dostępnych bibliotek mogą się
różnić.
Zakończ kreator, aby utworzyć dynamiczny projekt WWW.
Dodatki deskryptora aplikacji WWW
Niektóre dodatki deskryptora aplikacji WWW (.../WEB-INF/web.xml) są wymagane, a
inne są opcjonalne.
UWAGA: Pełne i bieżące
informacje można znaleźć w zasobach elektronicznych serwisu WWW
Apache MyFaces
Trinidad.
Dodatki wymagane
Aby skonfigurować serwlet zasobów środowiska Trinidad (udostępniający arkusze
stylów, skrypty i obrazy w czasie wykonywania), deskryptor aplikacji WWW wymaga
następujących dodatków:
<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>
Aby skonfigurować filtr środowiska Trinidad, deskryptor aplikacji WWW wymaga
następujących dodatków:
<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>
UWAGA: W elemencie filter-mapping przedstawionym
powyżej zostało przyjęte, że wartością servlet-name standardowego serwletu JSF
jest faces. Wartość ta może różnić się w zależności od konfiguracji użytkownika i musi być
odpowiednio określona.
Dodatki opcjonalne
Następujące dodatki deskryptora aplikacji WWW są opcjonalne i zależne od
wymagań konkretnej aplikacji:
<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>
UWAGA: Niektóre dodatki opcjonalne są specyficzne dla
środowiska Trinidad.
Dodatki zasobu konfiguracji aplikacji JSF
Wymagany jest dodatek do zasobu konfiguracji aplikacji JSF (zwykle jest to plik
.../WEB-INF/faces-config.xml).
UWAGA: Pełne i bieżące
informacje można znaleźć w zasobach elektronicznych serwisu WWW
Apache MyFaces
Trinidad.
Dodatek wymagany
Aby skonfigurować podstawowy pakiet RenderKit środowiska Trinidad, wymagany jest
dodatek do zasobu konfiguracji aplikacji JSF:
<application>
<default-render-kit-id>org.apache.myfaces.trinidad.core</default-render-kit-id>
</application>