Parámetros de configuración del motor JSF
En WebSphere Application Server, puede configurar los parámetros de configuración del motor de JSF (JavaServer Faces) para obtener un rendimiento óptimo en un entorno de servidor de producción y en un entorno de desarrollo.
Los parámetros del motor de JSF son sensibles a las mayúsculas y minúsculas. Si el valor especificado para un parámetro está compuesto por dos o más palabras separadas por espacios, debe indicar el valor entre comillas.
Opciones de JSF para MyFaces
Nombre del parámetro JSF | Descripción | Valor por omisión |
---|---|---|
org.apache.myfaces.PRETTY_HTML | Si este valor es true, el código HTML presentado se formatea de modo que sea legible por el usuario. Se escriben separadores de línea y espacios en blanco adicionales, que no influyen en el código HTML. | true |
org.apache.myfaces.ALLOW_JAVASCRIPT | Este parámetro indica a MyFaces si se permite código JavaScript en la salida HTML representada. Si se permite JavaScript, las anclas command_link tienen código JavaScript que envía el formulario correspondiente. Si no se permite JavaScript, la información para guardar el estado y los parámetros anidados se añaden como parámetros URL. | true |
org.apache.myfaces.DETECT_JAVASCRIPT | false | |
org.apache.myfaces.AUTO_SCROLL | Si es true, se presenta una función JavaScript que puede restaurar el desplazamiento vertical anterior en cada solicitud. Esta característica es muy útil cuando tiene páginas con listas largas y no desea que la página del navegador salte al principio de la página si activa la acción de un enlace o botón que le remite a la misma página. | false |
org.apache.myfaces.ADD_RESOURCE_CLASS | org.apache.myfaces.renderkit.html.util.DefaultAddResource | |
org.apache.myfaces.CHECK_EXTENSIONS_FILTER | Este parámetro comprueba que Extensions-Filter esté bien configurado, si la aplicación web lo necesita. | true |
org.apache.myfaces.COMPRESS_STATE_IN_SESSION | Establezca esta opción en true para comprimir el estado serializado antes de grabarlo en la sesión. Si esta opción está establecida en false, el estado no se comprime. Esta opción sólo se puede aplicar si el método de guardado del estado se establece en el servidor y si org.apache.myfaces.SERIALIZE_STATE_IN_SESSION se establece en true. | true |
org.apache.myfaces.DISABLE_FLASH_SCOPE | Establezca este parámetro de contexto en true para inhabilitar Flash Scope lo que hace que la cookie no se envíe. | false |
org.apache.myfaces.NUMBER_OF_VIEWS_IN_SESSION | Define el número de últimas vistas almacenadas en la sesión. Esta opción sólo se puede aplicar si el método de guardado del estado se establece en el servidor. | 20 |
org.apache.myfaces.READONLY_AS_DISABLED_FOR_SELECTS | true | |
org.apache.myfaces.SERIALIZE_STATE_IN_SESSION | Establezca esta opción en true para serializar el estado en una secuencia de bytes antes de grabarlo en la sesión. Si esta opción se establece en false, el estado no se serializa en una secuencia de bytes. Esta opción sólo se puede aplicar si el método de guardado del estado se establece en el servidor. | true |
org.apache.myfaces.STRICT_JSF_2_CC_EL_RESOLVER | Comprueba que, cuando se llama a un getType() sobre la expresión EL de origen, los componentes que trabajan con expresiones EL encadenadas pueden utilizar la información de metadatos que ha añadido el atributo composite:. Establecer esta propiedad en true inhabilita esta función. | false |
org.apache.el.parser.COERCE_TO_ZERO |
Permite al lenguaje de expresión (EL) que utiliza WebSphere
Application Server forzar los valores de entero de serie vacía o nula en
el valor 0 o para NO permitir forzar a un valor 0 y retener el entero de
serie nula o vacía.
El valor predeterminado es true y permite que un valor
de entero de serie nula o vacía se pueda convertir en un valor 0.
Importante: Para que un valor nulo no se pueda convertir a un valor 0 en una
aplicación MyFaces, debe establecerse el siguiente parámetro de contexto
en el web.xml de la aplicación, para asegurarse de que
ninguna de las posibles instancias de un valor vacío o nulo pueda forzarse
a un valor cero.
La propiedad org.apache.el.parser.COERCE_TO_ZERO
se establece utilizando la consola administrativa.
|
true |
org.apache.myfaces.DEBUG_PHASE_LISTENER | Habilita DebugPhaseListener en la tabla de proyecto de desarrollo. | true |
com.ibm.ws.jsf.disablealternatefacesconfigsearch |
Inhabilita la búsqueda de MyFaces de META-INF/*.faces-config.xml sólo para la aplicación web donde se ha establecido este parámetro de contexto. Si se han establecido el parámetro de contexto y la propiedad personalizada del contenedor web, el parámetro de contexto tiene prioridad. |
false |
Opciones de JSF generales
Nombre del parámetro JSF | Descripción | Valor por omisión |
---|---|---|
javax.faces.STATE_SAVING_METHOD | Especifica la ubicación donde se guarda la información de estado. Los valores válidos son 'server', que se guarda en HttpSession, y 'client', que se guarda como campo oculto en el formulario. | server |
javax.faces.CONFIG_FILES | Utilice este parámetro para especificar una lista separada con comas de vías de acceso de recursos relativas al contexto en las que la implementación de JSF busca recursos de configuración de aplicaciones antes de cargar un recurso de configuración denominado /WEB-INF/facesconfig.xml, si existe un recurso. | No disponible |
javax.faces.DEFAULT_SUFFIX | Especifica el sufijo por omisión para los recursos correlacionados por extensión que contienen componentes JSF. | .jsp |
javax.faces.LIFECYCLE_ID | Utilice este parámetro para configurar un ID de ciclo de vida alternativo. | No disponible |
com.ibm.ws.jsf.JSF_IMPL_CHECK | Especifica que los archivos JSP de un módulo web se deben volver a compilar cuando se reinicia la aplicación, porque la implementación de JSF utilizada se ha modificado. Después de reiniciar la aplicación, cuando se vuelve a acceder al archivo JSP para este módulo, se vuelve a compilar el archivo JSP con la implementación seleccionada de JSF, especificada en la consola de administración. Las siguientes llamadas al archivo JSP no provocan una nueva compilación. El valor predeterminado de esta opción es false. Utilice esta opción para el desarrollo, no en un entorno de producción. | No disponible |
Parámetros de contexto de Sun RI que tienen un comportamiento equivalente en MyFaces
Nombre del parámetro SUN RI | Descripción | Valor predeterminado de RI | MyFaces equivalente | Valor predeterminado de MyFaces |
---|---|---|---|---|
com.sun.faces.numberOfViewsInSession | Define el número máximo de vistas serializadas almacenadas en la sesión. Funciona con el guardado del estado del servidor. | 15 | org.apache.myfaces.NUMBER_OF_VIEWS_IN_SESSION | 20 |
com.sun.faces.compressViewState | Si es true, la vista se comprime después de serializarse y antes de codificarse en base64. Funciona con el guardado del estado del cliente. A partir de 1.2_09, esta opción también afecta el guardado de estado del lado del servidor cuando com.sun.faces.serializeServerState se establece en true (esto tiene un gran impacto sobre el tamaño del estado en la sesión cuando se utiliza esta opción, a costa de más CPU.) | true | org.apache.myfaces.COMPRESS_STATE_IN_CLIENT para el guardado de estado del lado del cliente u org.apache.myfaces.COMPRESS_STATE_IN_SESSION para el guardado de estado del lado del servidor | false para el guardado de estado del lado del cliente, true para el guardado de estado del lado del servidor |
com.sun.faces.validateXml | Cuando es true, JSF valida los archivos de configuración. | false | org.apache.myfaces.VALIDATE | false |
com.sun.faces.injectionProvider | Este parámetro especifica una clase que implemente InjectionProvider. | No disponible | El proveedor de inyección lo proporciona el entorno de ejecución de WebSphere Application Server | No disponible |
com.sun.faces.serializationProvider | Este parámetro especifica una clase que implementa la SPI de SerializationProvider. Esta implementación representa un gancho que la implementación JSF utiliza para habilitar el uso de implementaciones de serialización alternativas. | No disponible | org.apache.myfaces.SERIAL_FACTORY - la clase debe implementar la SPI de org.apache.myfaces.shared_impl.util.serial.SerialFactory en lugar de com.sun.faces.spi.SerializationProvider | No disponible |
com.sun.faces.enabledJSStyleHiding | Si es true, se presenta el JavaScript incorporado presentado por la implementación de ResponseWriter HTML, de forma que el script está oculto para las implementaciones anteriores de navegador. | false | org.apache.myfaces.WRAP_SCRIPT_CONTENT_WITH_XML_COMMENT_TAG | true |
com.sun.faces.serializeServerState | Si está habilitado, se serializa el estado del componente (no el árbol) antes de almacenarse en la sesión. Esto puede ser útil para las aplicaciones que tienen problemas cuando el estado de la vista es sensible a los cambios de modelo. | false | org.apache.myfaces.SERIALIZE_STATE_IN_SESSION | true |