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

Tableau 1. Options JSF pour MyFaces. The following table shows JSF parameter names, descriptions, and default values:
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.
<context-param>
	<param-name>javax.faces.
		INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL
	</param-name>
	<param-value>true</param-value>
</context-param>
Vous définissez la propriété org.apache.el.parser.COERCE_TO_ZERO à l'aide de la console d'administration.
  1. Développez Serveurs, puis sélectionnez Serveurs d'applications WebSphere. Cliquez sur le serveur appropriée dans la liste.
  2. Sous Infrastructure du serveur, développez Gestion des processus et Java > et cliquez sur Définition des processus.
  3. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
  4. Sous Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
  5. Cliquez sur Nouveau et ajoutez la propriété org.apache.el.parser.COERCE_TO_ZERO ayant la valeur false si vous ne souhaitez PAS qu'une valeur null soit paramétrée sur zéro.
  6. Cliquez sur Enregistrer pour enregistrer la modification et redémarrez le serveur d'applications WebSphere de sorte que la modification soit prise en compte.

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

Tableau 2. JSF options. The following table shows JSF parameter names, descriptions, and default values for any JSF implementation:
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

Tableau 3. Paramètres de contexte Sun RI ayant un comportement équivalent dans MyFaces. The following table shows SUN RI parameters names and MyFaces equivalent:
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

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_jsfengine
Nom du fichier : rweb_jsfengine.html