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