Parameter der JSP-Engine konfigurieren

Im Folgenden wird beschrieben, wie Sie Konfigurationsparameter der JSP-Engine hinzufügen, ändenr und löschen.

Informationen zu diesem Vorgang

Die folgende Anmerkung gilt für die Dateien mit der Erweiterung ".xmi" in diesem Artikel:
Unterstützte Konfigurationen Unterstützte Konfigurationen: Bei IBM® Erweiterungs- und Bindungsdateien weicht der Name der XMI- oder XML-Datei ab, je nachdem, ob Sie eine Java™ EE-Anwendung bzw. ein Java EE-Modul vor oder nach Version 5 verwenden. Eine IBM Erweiterungs- bzw. Bindungsdatei heißt "ibm-*-ext.xmi" bzw. "ibm-*-bnd.xmi". Das Platzhalterzeichen "*" steht für den Typ der Erweiterungs- oder Bindungsdatei, z. B. "app", "application", "ejb-jar" oder "web". Es gelten die folgenden Bedingungen:
  • Für eine Anwendung oder ein Modul, die bzw. das Java EE vor Version 5 verwendet, muss die Dateierweiterung ".xmi" sein.
  • Für eine Anwendung oder ein Modul, die bzw. das Java EE ab Version 5 verwendet, muss die Dateierweiterung ".xml" sein. Wenn Dateien mit der Erweiterung ".xmi" in der Anwendung oder im Modul enthalten sind, werden diese vom Produkt ignoriert.

Ein Modul von Java EE Version 5 oder einer höheren Version kann jedoch in einer Anwendung, die Dateien einer älteren Java EE-Version als Version 5 enthält, koexistieren.

Die Dateien ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi und ibm-portlet-ext.xmi können die Dateierweiterung ".xmi" weiterhin verwenden.

sptcfg
WebSphere Application Server unterstützt nicht die Änderung der Erweiterungsparameter des Implementierungsdeskriptors über die Administrationskonsole oder administratives Scripting.
Bewährtes Verfahren Bewährtes Verfahren: Verwenden Sie ein Assembliertool wie Rational Application Developer, um die IBM Erweiterung und die Bindungsdateien zu ändern. Sie können Erweiterungs- und Bindungsdateien innerhalb von Modulen von XMI in XML konvertieren, indem Sie das IBM Bindings and Extensions Conversion Tool for Multi-Platforms verwenden.bprac

Führen Sie die folgenden Schritte aus, um Konfigurationsparameter der JSP-Engine hinzuzufügen, zu ändern oder zu löschen.

Vorgehensweise

  1. Öffnen Sie die Datei WEB-INF/ibm-web-ext.xmi oder die Datei WEB-INF/ibm-web-ext.xml. [AIX Solaris HP-UX Linux Windows][z/OS]

    Die Konfigurationsparameter der JSP-Engine sind im Konfigurationsverzeichnis eines Webmoduls oder im Verzeichnis für Binärwerte eines Webmoduls in der Datei WEB-INF/ibm-web-ext.xmi bzw. WEB-INF/ibm-web-ext.xml gespeichert. Öffnen Sie die Datei WEB-INF/ibm-web-ext.xmi oder die Datei WEB-INF/ibm-web-ext.xml

    [AIX Solaris HP-UX Linux Windows][z/OS]
    • im Konfigurationsverzeichnis, wie im folgenden Beispiel gezeigt:
      {WAS_ROOT}/profiles/Profilname/config/cells/Zellenname/applications/Name_der_Unternehmensanwendung/deployments/Name_der_implementierten_Anwendung/Name_des_Webmoduls
    • im Verzeichnis für Bindärdateien, wenn eine Anwendung in WebSphere Application Server mit dem Flag Binärkonfiguration verwenden (Einstellung: true) implementiert wurde. Ein Beispiel für das Verzeichnis mit Binärdateien ist
      {WAS_ROOT}/profiles/Profilname/installedApps/nodename/Name_der_Unternehmensanwendung/Name_des_Webmoduls/
      .
    [IBM i]

    Die Konfigurationsparameter der JSP-Engine sind im Konfigurationsverzeichnis eines Webmoduls oder im Verzeichnis für Binärwerte eines Webmoduls in der Datei WEB-INF/ibm-web-ext.xmi bzw. WEB-INF/ibm-web-ext.xml gespeichert. Öffnen Sie die Datei WEB-INF/ibm-web-ext.xmi oder die Datei WEB-INF/ibm-web-ext.xml

    [IBM i]
    • im Konfigurationsverzeichnis, wie in den folgenden Beispielen gezeigt:
      Profilstammverzeichnis/config/cells/Zellenname/applications/Name_der_Unternehmensanwendung/deployments/Name_der_implementierten_Anwendung/Name_des_Webmoduls/WEB-INF/ibm-web-ext.xmi
      Profilstammverzeichnis/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xml
    • im Verzeichnis für Bindärdateien, wenn eine Anwendung in WebSphere Application Server mit dem Flag Binärkonfiguration verwenden (Einstellung: true) implementiert wurde. Beispiel für ein Verzeichnis mit Binärdateien:
      Profilstammverzeichnis/installedApps/Knotenname/Anwendungsname.ear/Anwendungsname.war/WEB-INF/ibm-web-ext.xmi
      Profilstammverzeichnis/installedApps/Knotenname/Anwendungsname.ear/Anwendungsname.war/WEB-INF/ibm-web-ext.xml
  2. Bearbeiten Sie die Datei WEB-INF/ibm-web-ext.xmi oder die Datei WEB-INF/ibm-web-ext.xml.
    • Verwenden Sie das folgende Format, wenn Sie der Datei WEB-INF/ibm-web-ext.xmi Konfigurationsparameter hinzufügen möchten:
      xmi:id="JSPAttribute_6" name="Parametername" value="Parameterwert"/> 
    • Verwenden Sie das folgende Format, wenn Sie der Datei WEB-INF/ibm-web-ext.xml Konfigurationsparameter hinzufügen möchten:
      <jsp-attribute name="parametername" value="parametervalue"/>
    • Wenn Sie Konfigurationsparameter löschen möchten, können Sie entweder die entsprechende Zeile aus der Datei löschen oder die Anweisung in die Tags <!-- --> einschließen.
  3. Speichern Sie die Datei.
  4. Starten Sie Enterprise Application Server erneut. Es ist nicht erforderlich, den Server erneut zu starten, damit die Parameteränderungen wirksam werden. Einige Konfigurationsparameter für die JSP-Engine wirken sich jedoch auf den Java-Quellcode aus, der für eine JSP generiert wird. Wenn ein solcher Parameter geändert wird, müssen Sie die JSP-Dateien im Webmodul erneut übersetzen, um den Java-Quellcode neu zu generieren. Mit dem Stapelcompiler können Sie alle JSP-Dateien in einem Webmodul neu übersetzen. Der Stapelcompiler verwendet die Konfigurationsparameter der JSP-Konfigurationsparameter, die Sie in der Datei ibm-web-ext.xmi bzw. ibm-web-ext.xml definiert haben, sofern Sie sie nicht individuell überschreiben. Der Artikel "Konfigurationsparameter der JSP-Engine" beschreibt die Parameter, die sich auf den generierten Java-Quellcode auswirken.

Beispiel

Es folgt ein Beispiel für die Datei WEB-INF/ibm-web-ext.xmi. Die Zeilen in Fettdruck sind Konfigurationsparameter der JSP-Engine.
<?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>
Es folgt ein Beispiel für die Datei WEB-INF/ibm-web-ext.xml. Die Zeilen in Fettdruck sind Konfigurationsparameter der JSP-Engine.
<?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>
Achtung: Das n in JSPattribute_n muss in der Datei eindeutig sein.

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tweb_jspengine
Dateiname:tweb_jspengine.html