Apache MyFaces Trinidad - Klargøringsvejledning

Oversigt

Denne vejledning er tænkt som en hjælp til den klargøring, der skal udføres, for at et dynamisk webprogram kan udnytte JSF-biblioteket Apache MyFaces Trinidad ("Trinidad"). Målet er, at der her skal være tilstrækkeligt med oplysninger til, at brugeren guides gennem den indledende konfiguration. Trinidad-webstedet indeholder dog altid de fuldstændige og mest aktuelle oplysninger. Denne vejledning er mere beregnet til konfiguration af Trinidad til brug med WTP (Eclipse Web Tools Platform) end som en generel Trinidad-konfigurationsguide (selv om kernekoncepterne ikke er specifikke for WTP).

Dynamisk konfiguration af webprojekt

JSF-bibliotekskonfiguration

Lige som alle andre strukturer kræver Trinidad, at bestemte biblioteker er på Classpath. Nogle biblioteker kan leveres ved server-runtime (f.eks. leverer en JEE5-server-runtime formodentlig en JSF 1.2-implementering og JSTL 1.2). Hvis påkrævede biblioteker ikke leveres ved server-runtime, anbefales det, at de tilføjes som et eller flere brugerbiblioteker (se Opret og opdatér JSF-biblioteker).

Konfiguration af dynamisk webprojekt

Ved oprettelse af et dynamisk webprojekt skal du angive brugen af JavaServer Faces-projekt (v1.1 eller v1.2 afhængigt af kravene) "Configuration", som vist nedenfor:

JavaServer Faces v1.2-projekt

Fortsæt gennem guiden, indtil siden JSF-muligheder nås. På denne side skal du vælge de påkrævede JSF-biblioteker, der tidligere er oprettet, som vist nedenfor:

JSF-muligheder

Bemærk: Hvis JSF-biblioteker er oprettet med andre navne end vist nedenfor, kan de tilgængelige biblioteksnavne være forskellige.

Afslut guiden for at oprette det dynamiske webprojekt.

Tilføjelser til webprogramdeskriptor

Nogle tilføjelser til webprogramdeskriptoren (.../WEB-INF/web.xml) er påkrævede, og nogle tilføjelser er valgfri.

Bemærk: Undersøg onlineressourcerne på webstedet Apache MyFaces Trinidad for at få udførlige og aktuelle oplysninger.

Påkrævede tilføjelser

Følgende tilføjelser skal anvendes til webprogrammets deskriptor for at konfigurere Trinidad's ressourceminiserver (som servicerer typografiark, scripts og billeder på tidspunktet for programkørsel):

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

Følgende tilføjelser skal anvendes til webprogrammets deskriptor for at konfigurere Trinidad's filter:

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

Bemærk: Den ovenfor viste filter-mapping antager, at standard-JSF-miniserveren servlet-name angives som "faces" - dette kan være anderledes afhængigt af brugerkonfigurationen, og det skal evt. angives på anden måde.

Valgfri tilføjelser

Følgende tilføjelser til webprogrammets deskriptor er valgfri - de afhænger af programmets specifikke krav:

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

Bemærk: Nogle af disse valgfri tilføjelser er specifikke for Trinidad - andre er ikke.

Tilføjelser til JSF-programkonfigurationressource

En tilføjelse til JSF-programkonfigurationsressourcen (typisk .../WEB-INF/faces-config.xml) er påkrævet.

Bemærk: Undersøg onlineressourcerne på webstedet Apache MyFaces Trinidad for at få udførlige og aktuelle oplysninger.

Påkrævet tilføjelse

Følgende tilføjelse skal anvendes til JSF-programkonfigurationsressourcen for at konfigurere Trinidad's kernegengivelsespakke:

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