Paramètres de configuration du moteur JSF
Dans WebSphere Application Server, vous pouvez configurer les paramètres de configuration du moteur JavaServer Faces (JSF) pour obtenir des performances optimales dans un environnement de serveur de production et dans un environnement de développement.
Les paramètres du moteur JSF sont sensibles à la casse. Si la valeur spécifiée pour un paramètre est constituée de deux ou plusieurs mots séparés par un espace, vous devez la placer entre guillemets.
Options JSF pour MyFaces
Nom du paramètre JSF | Description | Valeur par défaut |
---|---|---|
org.apache.myfaces.PRETTY_HTML | Si cette propriété est réglée à true, le code HTML rendu est formaté de manière à être lisible par l'humain. Des lignes de séparation et des espaces additionnels sont insérés sans influencer le fond du code. | true |
org.apache.myfaces.ALLOW_JAVASCRIPT | Ce paramètre indique à MyFaces si le code JavaScript est autorisé dans la sortie HTML rendue. Si le code JavaScript est autorisé, les ancres command_link possèdent un code JavaScript qui soumet le formulaire correspondant. Dans le cas contraire, les informations d'enregistrement d'état et les paramètes imbriqués sont ajoutés en tant que paramètres URL. | true |
org.apache.myfaces.DETECT_JAVASCRIPT | false | |
org.apache.myfaces.AUTO_SCROLL | Si ce paramètre a pour valeur true, une fonction JavaScript pouvant restaurer l'ancien défilement vertical sur chaque demande est rendue. This feature is convenient if you have pages with long lists and you do not want the browser page to jump to the beginning of the page if you trigger a link or button action that stays on the same page. | false |
org.apache.myfaces.ADD_RESOURCE_CLASS | org.apache.myfaces.renderkit.html.util.DefaultAddResource | |
org.apache.myfaces.CHECK_EXTENSIONS_FILTER | Ce paramètre recherche un filtre Extensions-Filter correctement configuré si cela est requis par l'application Web. | true |
org.apache.myfaces.COMPRESS_STATE_IN_SESSION | Paramétrez cette option sur true pour compresser l'état sérialisé avant de l'écrire dans la session. Si cette option est paramétrée sur false, l'état n'est pas compressé. Cette option est applicable uniquement si la méthode de sauvegarde de l'état est définie sur server et si org.apache.myfaces.SERIALIZE_STATE_IN_SESSION est paramétré sur true. | true |
org.apache.myfaces.DISABLE_FLASH_SCOPE | Affectez à ce paramètre de contexte la valeur true pour désactiver la portée Flash qui empêche l'envoi de cookie. | false |
org.apache.myfaces.NUMBER_OF_VIEWS_IN_SESSION | Définit le nombre des vues les plus récentes enregistrées en session. Cette option est applicable uniquement si la méthode de sauvegarde de l'état est définie sur server. | 20 |
org.apache.myfaces.READONLY_AS_DISABLED_FOR_SELECTS | true | |
org.apache.myfaces.SERIALIZE_STATE_IN_SESSION | Paramétrez cette option sur true pour sérialiser l'état en un flot d'octets avant de l'écrire dans la session. Si cette option est paramétrée sur false, l'état n'est pas sérialisé en un flot d'octets. Cette option est applicable uniquement si la méthode de sauvegarde de l'état est définie sur server. | true |
org.apache.myfaces.STRICT_JSF_2_CC_EL_RESOLVER | S'assure que lors de l'appel de getType() sur une expression EL source, les composants travaillant avec les expressions EL enchaînées peuvent utiliser les informations de métadonnées ajoutées par composite:attribute. La définition de cette propriété sur true désactive la fonction. | false |
org.apache.el.parser.COERCE_TO_ZERO |
Autorise le langage d'expression (EL) utilisé par WebSphere Application Server à forcer le paramétrage des valeurs null et de type entier de chaîne vide sur une valeur 0. S'il ne l'autorise PAS, la valeur null ou de type entier de chaîne vide est conservée. La valeur par défaut est true, ce qui permet à une valeur null ou de type entier de chaîne vide d'être paramétrée sur une valeur 0.
Important : Pour empêcher qu'une valeur null soit paramétrée sur une valeur 0 dans une application MyFaces,
le paramètre de contexte suivant dans le fichier web.xml de l'application doit être défini pour
s'assurer que toutes les instances possibles d'une valeur vide ou null ne puissent pas être paramétrées sur une valeur zéro.
Vous définissez la propriété org.apache.el.parser.COERCE_TO_ZERO à l'aide de la console d'administration.
|
true |
org.apache.myfaces.DEBUG_PHASE_LISTENER | Active le DebugPhaseListener lors de la phase de projet de développement. | true |
com.ibm.ws.jsf.disablealternatefacesconfigsearch |
Désactive la recherche MyFaces pour META-INF/*.faces-config.xml uniquement pour l'application Web pour laquelle ce paramètre de contexte est défini. Si le paramètre de contexte et la propriété personnalisée du conteneur Web sont définis, le paramètre de contexte a priorité. |
false |
General JSF options
Nom du paramètre JSF | Description | Valeur par défaut |
---|---|---|
javax.faces.STATE_SAVING_METHOD | Indique l'emplacement dans lequel les informations d'état sont sauvegardées. Les valeurs possibles sont 'server' pour une sauvegarde dans HttpSession et 'client' pour une sauvegarde en tant que zone masquée dans le formulaire. | server |
javax.faces.CONFIG_FILES | Ce paramètre permet de spécifier une liste de chemins de ressources relatives au contexte, délimités par des virgules, dans lesquels l'implémentation JSF recherche des ressources de configuration d'applications avant de charger une ressource de configuration appelée /WEB-INF/facesconfig.xml, si une ressource existe. | s/o |
javax.faces.DEFAULT_SUFFIX | Indique le suffixe par défaut pour les ressources avec mappage d'extension qui contiennent des composants JSF. | .jsp |
javax.faces.LIFECYCLE_ID | Ce paramètre permet de configurer un ID de cycle de vie alternatif. | s/o |
com.ibm.ws.jsf.JSF_IMPL_CHECK | Indique que les fichiers JSP dans un module Web doivent être recompilés lorsque l'application est redémarrée suite au changement de l'implémentation de JSF utilisée. Après le redémarrage de l'application, lors de l'accès suivant à un fichier JSP pour ce module, le JSP est recompilé par rapport à l'implémentation de JSF indiquée dans la console d'administration. Les appels ultérieurs au JSP n'entraînent pas de recompilation. Cette option est paramétrée par défaut sur false. Cette option ne doit pas être utilisée dans un environnement de production mais à des fins de développement. | s/o |
Paramètres de contexte Sun RI ayant un comportement équivalent dans MyFaces
Nom du paramètre dans SUN RI | Description | Valeur par défaut dans SUN RI | Equivalent MyFaces | Valeur par défaut dans MyFaces |
---|---|---|---|---|
com.sun.faces.numberOfViewsInSession | Définit le nombre maximum de vues sérialisées stockées dans la session. Fonctionne avec la sauvegarde d'état côté serveur. | 15 | org.apache.myfaces.NUMBER_OF_VIEWS_IN_SESSION | 20 |
com.sun.faces.compressViewState | Lorsque cette propriété est true, la vue est compressée après avoir été sérialisée et avant d'être encodée en base64. Fonctionne avec la sauvegarde d'état côté client. A compter de l'édition 1.2_09, cette option affecte également la sauvegarde d'état côté serveur lorsque la propriété com.sun.faces.serializeServerState est réglée sur true (l'utilisation de cette option de compression réduit considérablement la taille de l'état sauvegardé dans la session, mais au prix d'une consommation accrue du temps processeur). | true | org.apache.myfaces.COMPRESS_STATE_IN_CLIENT pour la sauvegarde d'état côté client ou org.apache.myfaces.COMPRESS_STATE_IN_SESSION pour la sauvegarde d'état côté serveur | false pour la sauvegarde d'état côté client, true pour la sauvegarde d'état côté serveur |
com.sun.faces.validateXml | Lorsque la valeur est true, JSF valide les fichiers de configuration. | false | org.apache.myfaces.VALIDATE | false |
com.sun.faces.injectionProvider | Ce paramètre spécifie une classe qui implémente InjectionProvider. | s/o | Un fournisseur d'injection est fourni par la phase d'exécution de WebSphere Application Server. | s/o |
com.sun.faces.serializationProvider | Ce paramètre spécifie une classe qui implémente l'interface SPI SerializationProvider. This implementation represents a hook that the JSF implementation uses to enable the alternative Serialization implementations. | s/o | org.apache.myfaces.SERIAL_FACTORY - la classe doit implémenter la SPI org.apache.myfaces.shared_impl.util.serial.SerialFactory à la place de com.sun.faces.spi.SerializationProvider | s/o |
com.sun.faces.enabledJSStyleHiding | Si la valeur est true, le JavaScript en ligne traité par l'implémentation HTML ResponseWriter est rendu de manière à être masqué aux navigateurs des anciennes générations. | false | org.apache.myfaces.WRAP_SCRIPT_CONTENT_WITH_XML_COMMENT_TAG | true |
com.sun.faces.serializeServerState | Si ce paramètre est activé, l'état de composant (et non l'arborescence) est sérialisé avant d'être stocké dans la session. Ce comportement peut être souhaitable pour les applications qui ont des problèmes de fonctionnement lorsque l'état de la vue est sensible aux changements de modèle. | false | org.apache.myfaces.SERIALIZE_STATE_IN_SESSION | true |