Apache MyFaces Trinidad: Guía de configuración inicial


Visión general

Esta guía pretende servir de ayuda en la configuración inicial de una aplicación web dinámica para utilizar la biblioteca JSF Apache MyFaces Trinidad ("Trinidad"). Aunque el objetivo es que esta guía constituya información suficiente para guiar al usuario a través de la configuración inicial, el sitio web de Trinidad debe siempre tenerse en cuenta como fuente de información completa y actualizada. Esta guía está realizada para la configuración Trinidad para utilizarla con la Plataforma de herramientas web de Eclipse ("WTP") más que como guía de configuración general de Trinidad (aunque los conceptos centrales pueden no ser específicos de WTP).

Configuración de proyectos web dinámicos

Configuración de la biblioteca JSF

Como todas las infraestructuras, Trinidad necesita que determinadas bibliotecas estén en la vía de acceso de clases. Algunas bibliotecas puede proporcionarlas el tiempo de ejecución de servidor (por ejemplo, un tiempo de ejecución de servidor JEE5 proporcionará probablemente una implementación JSF 1.2 y JSTL 1.2). Cuando el tiempo de ejecución de servidor no proporciona las bibliotecas necesarias, es recomendable que se añadan como una o varias bibliotecas de usuario (consulte Crear y actualizar bibliotecas JSF).

Configuración de proyectos web dinámicos

Al crear un proyecto web dinámico, especifique la utilización de la "Configuración" de Proyecto JavaServer Faces (v1.1 o v1.2, según los requisitos), tal como se muestra a continuación:

Proyecto JavaServer Faces v1.2
Proyecto JavaServer Faces v1.2
Desplácese por el asistente hasta que alcance la página Posibilidades JSF. En esta página, seleccione las bibliotecas JSF necesarias según se han creado anteriormente, tal como se muestra a continuación:

Capacidades JSF
Posibilidades de JSF

NOTA: si las bibliotecas JSF se han creado con nombres que no son los mostrados más arriba, los nombres de biblioteca disponibles pueden diferir.

Siga el asistente hasta el final para crear el proyecto web dinámico.

Adiciones de descriptor de aplicaciones web

Algunas adiciones al descriptor de la aplicación web (.../WEB-INF/web.xml) son necesarias y algunas adiciones son opcionales.

NOTA: Consulte los recursos en línea en el sitio web Apache MyFaces Trinidad para obtener una información completa y actual.

Adiciones necesarias

Es necesario añadir lo siguiente al descriptor de la aplicación web para configurar el servlet del recurso Trinidad (que sirve hojas de estilos, scripts e imágenes en tiempo de ejecución):

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

Es necesario añadir lo siguiente al descriptor de la aplicación web para configurar el filtro de Trinidad:

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

NOTA: con el filter-mapping que se muestra más arriba, se da por supuesto que se ha especificado el servlet-name del servlet JSF estándar como "faces"; esto puede diferir según la configuración del usuario y así debe especificarse adecuadamente.

Adiciones opcionales

Las adiciones siguientes al descriptor de la aplicación web son opcionales, según los requisitos específicos de la aplicación:

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

NOTE: algunas de estas adiciones opcionales son específicas de Trinidad y algunas no lo son.

Adiciones de recurso de configuración de aplicaciones JSF

Es necesario realizar una adición del recurso de configuración de aplicaciones JSF (normalmente .../WEB-INF/faces-config.xml).

NOTA: Consulte los recursos en línea en el sitio web Apache MyFaces Trinidad para obtener una información completa y actual.

Adición necesaria

Es necesario añadir lo siguiente al recurso de configuración de aplicaciones JSF para configurar el RenderKit de núcleo Trinidad's:

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