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>