Optionen für die Kompilierung von JavaServer Pages angeben

Verwenden Sie diese Seite, um Optionen für den JSP-Compiler (JavaServer Pages) anzugeben.

Diese Seite der Administrationskonsole ist ein Schritt in den Assistenten für Anwendungsinstallation und -aktualisierung. Zum Aufrufen dieser Seite müssen Sie auf der Seite Installationsoptionen auswählen die Option JSP-Dateien vorkompilieren auswählen. Klicken Sie deshalb zum Anzeigen dieser Seite auf Anwendungen > Neue Anwendung > Neue Unternehmensanwendung > Anwendungspfad > Weiter > Detailliert - Alle Installationsoptionen und -parameter anzeigen > Weiter > Weiter oder auf Weiter > JSP-Dateien vorkompilieren > Weiter > Schritt: Optionen für die Kompilierung von JSP-Dateien angeben.

Sie können auf dieser Seite nur Optionen für den JSP-Compiler angeben, wenn Sie eine Anwendung installieren oder aktualisieren, die Webmodule enthält. Nach der Installation der Anwendung müssen Sie die Konfigurationsparameter der JSP-Engine in der Datei WEB-INF/ibm-web-ext.xmi eines Webmoduls bearbeiten, um die Optionen für den JSP-Compiler zu ändern.

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 der 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

Webmodul

Gibt den Namen eines Moduls in der Anwendung an.

URI

Gibt die Position des Moduls relativ zum Stammverzeichnis der Anwendung (EAR-Datei) an.

JSP-Klassenpfad

Gibt einen temporären Klassenpfad an, den der JSP-Compiler für die Kompilierung von JSP-Dateien während der Anwendungsinstallation verwenden soll. Dieser Klassenpfad wird nicht gespeichert, wenn die Anwendungsinstallation abgeschlossen ist, und nicht verwendet, wenn die Anwendung ausgeführt wird. Dieser Klassenpfad wird nur verwendet, um Ressourcen außerhalb der Anwendung anzugeben, die für die JSP-Kompilierung erforderlich sind und die nach der Installation der Anwendung mit anderen Mitteln (z. B. gemeinsam genutzten Bibliotheken) angegeben werden. In Network-Deployment-Konfigurationen ist dieser Klassenpfad für die Deployment-Manager-Maschine spezifisch.

Sie können wie folgt angeben, dass mehrere Webmodule denselben Klassenpfad verwenden:

Wählen Sie in der Liste der Webmodule das Kontrollkästchen Auswählen der Webmodule aus, die einen bestimmten Klassenpfad verwenden sollen.
Erweitern Sie den Eintrag Mehrere Zuordnungen anwenden.
Geben Sie den gewünschten Klassenpfad an.
Klicken Sie auf Anwenden.

Vollständige Paketnamen verwenden

Gibt an, ob die JSP-Engine JSP-Klassen mit vollständigen Paketnamen generiert und lädt.

Wenn vollständige Paketnamen verwendet werden, können vorkompilierte JSP-Klassendateien als Servlets in der Datei web.xml konfiguriert werden, ohne das Attribut jsp-file verwenden zu müssen. Werden keine vollständigen Paketnamen verwendet, werden alle JSP-Klassen in demselben Paket generiert, was den Vorteil kürzerer Dateisystempfad hat.

Wenn die Optionen useFullPackageNames und disableJspRuntimeCompilation beide den Wert true haben, wird ein einziger Klassenlader verwendet, um alle JSP-Klassen zu laden, selbst wenn die JSP-Dateien in der Datei web.xml nicht als Servlets konfiguriert sind.

Diese Option entspricht dem Parameter useFullPackageNames der JSP-Engine.

JDK-Quellenebene

[Aktualisierung März 2013] Gibt die Quellenebene an, auf der der Java-Compiler JSP-Java-Quellen kompiliert. Die gültigen Werte sind 13, 14, 15,16 und 17. Der Standardwert für Webmodule vor Java EE 5 ist 13 (gibt die Quellenversion 1.3 an), der Standardwert für Webmodule ab Java EE Version 5 ist 16. [Aktualisierung März 2013]

JSP-Laufzeitkompilierung inaktivieren

Gibt an, ob JSP-Dateien zur Laufzeit nicht übersetzt und kompiliert werden sollen, selbst wenn keine Datei mit der Erweiterung .class vorhanden ist.

Wenn diese Option auf true gesetzt ist, übersetzt und kompiliert die JSP-Engine keine JSP-Dateien zur Laufzeit. Die JSP-Engine lädt nur vorkompilierte Klassendateien. Es müssen keine JSP-Quellendateien vorhanden sein, damit Klassendateien geladen werden. Sie können eine Anwendung ohne JSP-Quelle installieren, aber die Anwendung muss vorkompilierte Klassendateien enthalten.

Damit ein einzelner Klassenlader der Webanwendung alle JSP-Klassen lädt, müssen diese Compiler-Option und die Option Vollständige Paketnamen verwenden beide auf true gesetzt sein.

Diese Option entspricht dem Parameter disableJspRuntimeCompilation der JSP-Engine.

Dateiname: uweb_jspcompile.html