Configuration des paramètres du moteur JSP

Comment ajouter, modifier ou supprimer les paramètres de configuration du moteur JSP.

Pourquoi et quand exécuter cette tâche

La remarque suivante s'applique aux références de fichier avec une extension .xmi dans cette rubrique :
Configurations prises en charge Configurations prises en charge: Pour les fichiers de liaison et d'extension IBM®, l'extension de nom de fichier .xmi ou .xml est différente selon que vous utilisiez un module ou une application antérieure à Java EE 5 ou un module ou une application ultérieure à Java™ EE 5. Un fichier de liaison ou d'extension IBM porte le nom ibm-*-ext.xmi ou ibm-*-bnd.xmi où * correspond au fichier d'extension ou de liaison, tel app, application, ejb-jar ou web. Les conditions suivantes s'appliquent :
  • Pour une application ou un module qui utilise une version Java EE antérieure à la version 5, l'extension de fichier doit être .xmi.
  • Pour une application ou un module qui utilise Java EE 5 ou version ultérieure, l'extension de fichier doit être .xml. Si des fichiers .xmi sont inclus dans l'application ou le module, le produit les ignore.

Toutefois, un module Java EE 5 ou version ultérieure peut exister dans une application qui inclut des fichiers antérieurs à Java EE 5 et utilise l'extension de nom de fichier .xmi.

Les fichiers ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi et ibm-portlet-ext.xmi continuent d'utiliser les extensions de fichier .xmi.

sptcfg
WebSphere Application Server ne prend pas en charge la modification des paramètres d'extension des descripteurs de déploiement via la console d'administration ou les scripts d'administration.
Pratiques recommandées Pratiques recommandées: Utilisez un outil d'assemblage, tel que Rational Application Developer, pour modifier les fichiers de liaison et d'extension IBM. Vous pouvez convertir des fichiers d'extension et de liaison de modules de XMI en XML à l'aide de l'outil IBM Bindings and Extensions Conversion Tool for Multi-Platforms.bprac

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/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.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/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml. Ouvrez le fichier WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml à partir :

    [AIX Solaris HP-UX Linux Windows][z/OS]
    • du répertoire de configuration, comme dans l'exemple suivant :
      {WAS_ROOT}/profiles/profilename/config/cells/cellname/applications/enterpriseappname/deployments/deployedname/webmodulename
    • du répertoire de fichiers binaires si une application a été déployée dans WebSphere Application Server alors que la valeur de l'option Utilisation de la configuration binaire était 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 JSP sont stockés dans le répertoire de configuration ou de fichiers binaires du module Web dans le fichier WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml. Ouvrez le fichier WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml à partir :

    [IBM i]
    • du répertoire de configuration, comme dans les exemples suivants :
      racine_profil/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xmi
      racine_profil/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xml
    • du répertoire de fichiers binaires si une application a été déployée dans WebSphere Application Server alors que la valeur de l'option Utilisation de la configuration binaire était true. Exemple de répertoire de fichiers binaires :
      racine_profil/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/ibm-web-ext.xmi
      racine_profil/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/ibm-web-ext.xml
  2. Editez le fichier WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml.
    • Pour ajouter des paramètres de configuration au fichier WEB-INF/ibm-web-ext.xmi, utilisez le format suivant :
      xmi:id="JSPAttribute_6" name="parametername" value="parametervalue"/> 
    • Pour ajouter des paramètres de configuration au fichier WEB-INF/ibm-web-ext.xml, utilisez le format suivant :
      <jsp-attribute name="parametername" value="parametervalue"/>
    • 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 ces paramètres sont modifiés, vous devez reconvertir les fichiers JSP dans le module Web pour régé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 ibm-web-ext.xmi ou ibm-web-ext.xml, à moins que vous ne les remplaciez. La rubrique Paramètres de configuration du moteur JSP identifie 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/ibm-web-ext.xmi. Les lignes en gras correspondent à des paramètres de configuration du moteur JSP.
<?xml version="1.0" encoding="UTF-8"?>
<webappext:WebAppExtension xmi:version="2.0" xmlns:xmi=http://www.omg.org/XMI
   xmlns:webappext="webappext.xmi" xmlns:webapplication="webapplication.xmi" xmi:id="WebAppExtension_1"   
   reloadInterval="9" reloadingEnabled="true" defaultErrorPage="error.jsp" additionalClassPath="" 
   fileServingEnabled="true" directoryBrowsingEnabled="false" serveServletsByClassnameEnabled="true" 
   autoRequestEncoding="true" autoResponseEncoding="false">
   <webApp href="WEB-INF/web.xml#WebApp_1"/>
   <jspAttributes xmi:id="JSPAttribute_1" name="useThreadTagPool" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_2" name="verbose" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_3" name="deprecation" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_4" name="reloadEnabled" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_5" name="reloadInterval" value="5"/>
   <jspAttributes xmi:id="JSPAttribute_6" name="keepgenerated" value="true"/>
   <!--<jspAttributes xmi:id="JSPAttribute_7" name="trackDependencies" value="true"/> -->
   
</webappext:WebAppExtension>
Vous trouverez ci-après un exemple de fichier WEB-INF/ibm-web-ext.xml. Les lignes en gras correspondent à des paramètres de configuration du moteur JSP.
<?xml version="1.0" encoding="UTF-8"?>
<web-ext
   xmlns="http://websphere.ibm.com/xml/ns/javaee"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd"
      version="1.0">

   <default-error-page uri="error.jsp"/>
   <jsp-attribute name="useThreadTagPool" value="true" />
   <jsp-attribute name="verbose" value="false" />
   <jsp-attribute name="deprecation" value="false" />
   <jsp-attribute name="reloadEnabled" value="true" />
   <jsp-attribute name="reloadInterval" value="5" />
   <jsp-attribute name="keepgenerated"  value="true" />
   <jsp-attribute name="trackDependencies" value="true" />
   <reload-interval value="9"/>
   <auto-encode-requests value="true"/>
   <auto-encode-responses value="false"/>
   <enable-directory-browsing value="false"/>
   <enable-file-serving value="false"/>
   <pre-compile-jsps value="false"/>
   <enable-reloading value="true"/>
   <enable-serving-servlets-by-class-name value="true"/>
</web-ext>
Avertissement : L'entier n de JSPattribute_n doit être unique dans le fichier.

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_jspengine
Nom du fichier : tweb_jspengine.html