Configuration des paramètres du moteur JSF

Pourquoi et quand exécuter cette tâche

WebSphere Application Server ne prend pas en charge la modification des paramètres d'extension des descripteurs de déploiement via la fonction des scripts d'administration de la console d'administration.

Pour ajouter, modifier ou supprimer des paramètres de configuration du moteur JSP, effectuez les opérations ci-dessous :

Procédure

  1. Ouvrez le fichier WEB-INF/web.xml. [AIX Solaris HP-UX Linux Windows][z/OS]

    Les paramètres de configuration du moteur JSP sont stockés dans le répertoire de configuration ou de fichiers binaires du module Web, dans le fichier WEB-INF/web.xml. Ouvrez le fichier WEB-INF/web.xml depuis :

    [AIX Solaris HP-UX Linux Windows][z/OS]
    • du répertoire de configuration. Exemple : {WAS_ROOT}/profiles/nomprofil/config/cells/nomcellule/applications/nomappentreprise/ deployments/nomdéployé/nommoduleweb
    • Le répertoire de fichiers binaires si une application a été déployée dans WebSphere Application Server avec l'indicateur Utilisation de la configuration binaire défini sur true. Exemple de répertoire de fichiers binaires : {WAS_ROOT}/profiles/nomprofil/installedApps/nomnoeud/Nomappentreprise/Nommoduleweb/
    [IBM i]

    Les paramètres de configuration du moteur JSF sont stockés dans le répertoire de configuration ou de fichiers binaires du module Web, dans le fichier WEB-INF/web.xml. Ouvrez le fichier WEB-INF/web.xml depuis :

    [IBM i]
    • le répertoire de configuration. Exemple : racine_profil/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/web.xml
    • Le répertoire de fichiers binaires si une application a été déployée dans WebSphere Application Server avec l'indicateur Utilisation de la configuration binaire défini sur true. Exemple de répertoire de fichiers binaires : racine_profil/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/web.xml
  2. Editez le fichier WEB-INF/web.xml.
    • Pour ajouter des paramètres de configuration, utilisez le format suivant :
      <context-param>
      		<description>descriptive text</description>
      		<param-name>parameter name</param-name>
      		<param-value>parameter value</param-value>
      </context-param>
    • Pour supprimer des paramètres de configuration, supprimez la ligne dans le fichier ou placez l'instruction entre les balises <!-- -->>.
  3. Enregistrez le fichier.
  4. Relancez l'application d'entreprise. Il n'est pas nécessaire de redémarrer le serveur pour que les modifications apportées aux paramètres prennent effet. Toutefois, certains paramètres de configuration du moteur JSP ont un impact sur le code source Java généré pour un JSP. Si un paramètre de ce type est modifié, vous devez reconvertir les fichiers JSP du module Web pour regénérer la source Java. Vous pouvez utiliser le compilateur par lots pour reconvertir tous les fichiers JSP d'un module Web. Il utilise les paramètres de configuration du moteur JSP définis dans le fichier web.xml, à moins que vous ne les remplaciez. La rubrique Configuration du moteur JSP répertorie les paramètres ayant un impact sur la source Java générée.

Exemple

Vous trouverez ci-après un exemple de fichier WEB-INF/web.xml.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	id="WebApp_ID" version="2.5">
	<display-name>Servlet 2.5 example</display-name>
	<welcome-file-list>
		<welcome-file>index.html</welcome-file>
		<welcome-file>index.htm</welcome-file>
		<welcome-file>index.jsp</welcome-file>
		<welcome-file>default.html</welcome-file>
		<welcome-file>default.htm</welcome-file>
		<welcome-file>default.jsp</welcome-file>
	</welcome-file-list>
	<context-param>
      	<param-name>javax.faces.CONFIG_FILES</param-name>
      	<param-value>/WEB-INF/faces-config.xml</param-value>
   	</context-param>
    <context-param>
        <param-name>javax.faces.STATE_SAVING_METHOD</param-name>
        <param-value>server</param-value>
    </context-param>
    <context-param>
        <param-name>com.ibm.ws.jsf.LOAD_FACES_CONFIG_AT_STARTUP</param-name>
        <param-value>true</param-value>
    </context-param>
    <servlet>
        <servlet-name>Faces Servlet</servlet-name>
        <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>Faces Servlet</servlet-name>
        <url-pattern>/faces/*</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>Faces Servlet</servlet-name>
        <url-pattern>*.faces</url-pattern>
    </servlet-mapping>
</web-app>

Icône indiquant le type de rubrique Rubrique de tâche



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=tweb_jsfengine
Nom du fichier : tweb_jsfengine.html