Web-Container-Konfiguration für den Zugriff auf JSP- und statische Dateien

Je nach Anwendungskonfiguration sucht der Web-Container an bis zu vier Positionen nach statischen Dateien und JSP-Dateien. Dieser Suchvorgang ist wichtig, um die Ressource zu lokalisieren, die benötigt wird, um eine eingehende Anforderung bedienen und Ergebnisse von den folgenden APIs erhalten zu können:
URL ServletContext.getResource(String path)
Set ServletContext.getResourcePaths(String path)
Achtung: Statische Dateien werden nur durchsucht, wenn die Eigenschaft fileServing aktiviert ist und die Anwendung keine /* -Servletzuordnung enthält. Außerdem enthalten JSP-Dateien zusätzlich zu anderen Mustern, die in der Datei "web.xml" definiert sind, Dateien mit den folgenden Erweiterungen:
  • .jsp
  • .jspx
  • .jsw
  • .jsv
Die vier Positionen sind, nach Priorität geordnet, folgende:
Verzeichnis der Anwendungs-WAR-Dateien
Zuerst durchsucht der Web-Container das Verzeichnis "WAR" der Anwendung nach einer angeforderten Ressource. Sie können jedoch keine Ressourcen unter den Verzeichnissen "WEB-INF" oder "META-INF" für eingehende Ressourcen bereitstellen, obwohl sie über die Methoden "getResource()" und "getResourcePaths()" zugänglich sind.
Dokumentstammverzeichnisse vom Typ "preFragmentExtendedDocumentRoot"
Als Zweites durchsucht der Web-Container alle Dokumentstammverzeichnisse vom Typ "preFragmentExtendedDocumentRoot". Definieren Sie ein Dokumentstammverzeichnis vom Typ "preFragmentExtendedDocumentRoot" in der Datei ibm-web-ext.xmi im Verzeichnis WEB-INF der Anwendung. Gehen Sie wie folgt vor, um ein Dokumentstammverzeichnis vom Typ "preFragmentExtendedDocumentRoot" für statische oder JSP-Dateien zu erstellen:
Static files:
<fileServingAttributes xmi:id="<user-provided name>"
 name="preFragmentExtendedDocumentRoot"
 value="<user provided value>"/>

JSP files:
<jspAttributes xmi:id="<user provided name>" name="preFragmentExtendedDocumentRoot"
 value=<user provided value>"/>
Der <user provided name> kann eine Liste von Verzeichnissen und/oder eine Liste von JAR-Dateien sein. Beispiel:
<fileServingAttributes name="extendedDocumentRoot"
      value="C:\EDR_directory,C:\my\path\to\jarEDR.jar"/>
Wenn <user provided name> nur eine Liste eines Verzeichnisses enthält und dieses Verzeichnis JAR-Dateien enthält, wird nicht in diesen JAR-Dateien gesucht. Es wird nur in diesem Verzeichnis und nicht in JAR-Dateien nach statischen Dateien und JSP-Dateien gesucht. Wenn sich die statischen Dateien oder JSP-Dateien in einer JAR-Datei befinden, können sich die statischen Dateien oder JSP-Dateien nicht im Ordner META-INF der JAR-Datei befinden, da es sich um einen eingeschränkten Ordner handelt, und <user provided name> sollte einen vollständigen Pfad zur JAR-Datei enthalten.
Achtung: Dokumentstammverzeichnisse für Vorfragmente sind eine neue Funktion in WebSphere® Application Server Version 9.0.
Verzeichnisse vom Typ "META-INF/resources" für Fragmente unterhalb des Verzeichnisses "WEB-INF/Lib" in der Anwendungs-WAR-Datei
Nachdem der Web-Container die Dokumentstammverzeichnisse vom Typ "preFragmentExtendedDocumentRoot" durchsucht hat, durchsucht er Webfragmente. Ein Webfragment umfasst eine JAR-Datei in einem Verzeichnis vom Typ "WEB-INF/lib" der Anwendung. Die JAR-Datei kann statische Ressourcen in einem Verzeichnis vom Typ "META-INF/resources" enthalten, die in der JAR-Datei definiert sind. Um zu verhindern, dass der Web-Container Verzeichnisse vom Typ "META-INF/resource" durchsucht, setzen Sie die angepasste Eigenschaft "com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing" des Web-Containers auf true. Der Standardwert für diese angepasste Eigenschaft ist "false".
com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing = true
Achtung: META-INF/resources-Verzeichnisse von Fragmenten unter dem Verzeichnis WEB-INF/Lib in der Anwendungs-WAR-Datei sind eine neue Funktion in WebSphere Application Server Version 9.0.
Dokumentstammverzeichnisse vom Typ "extendedDocumentRoot"
Zum Schluss durchsucht der Web-Container alle Anwendungen, die als Dokumentstammverzeichnisse vom Typ "extendedDocumentRoot" definiert sind. Dokumentstammverzeichnisse vom Typ "extendedDocumentRoot" waren in früheren Releases verfügbar und sind in der Datei ibm-web-ext.xmi im Verzeichnis "WEB-INF" der Anwendung definiert. Gehen Sie wie folgt vor, um ein Dokumentstammverzeichnis vom Typ "extendedDocumentRoot" für statische oder JSP-Dateien zu erstellen:
Static files:
<fileServingAttributes xmi:id="<user provided name>" name="extendedDocumentRoot"
 value="<user provided value>"/>
JSP files:
<jspAttributes xmi:id="<user provided name>" name="extendedDocumentRoot"
 value=<user provide value>"/>
com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing = true
Der <user provided name> kann eine Liste von Verzeichnissen und/oder eine Liste von JAR-Dateien sein. Beispiel:
<fileServingAttributes name="extendedDocumentRoot"
      value="C:\EDR_directory,C:\my\path\to\jarEDR.jar"/>
Wenn <user provided name> nur eine Liste eines Verzeichnisses enthält und dieses Verzeichnis JAR-Dateien enthält, wird nicht in diesen JAR-Dateien gesucht. Es wird nur in diesem Verzeichnis und nicht in JAR-Dateien nach statischen Dateien und JSP-Dateien gesucht. Wenn sich die statischen Dateien oder JSP-Dateien in einer JAR-Datei befinden, können sich die statischen Dateien oder JSP-Dateien nicht im Ordner META-INF der JAR-Datei befinden, da es sich um einen eingeschränkten Ordner handelt, und <user provided name> sollte einen vollständigen Pfad zur JAR-Datei enthalten.
Achtung: Sie können die angepasste Eigenschaft com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot auf true setzen, um die Bereitstellung statischer Begrüßungsseiten aus einem erweiterten Dokumentstammverzeichnis für statische Dateien zu aktivieren. Der Standardwert für diese angepasste Eigenschaft ist false.
com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot = true
Wenn die Eigenschaft "com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot" auf true gesetzt ist, sucht der Web-Container in einem Dokumentstammverzeichnis vom Typ "extendedDocumentRoot" für statische Dateien nach einer statischen Begrüßungsdatei, die im Falle einer Anforderung mit einem gültigen partiellen URL bereitgestellt werden kann. Wenn in einer Anforderung beispielsweise nur der Anwendungskontext angegeben ist und eine Begrüßungsdatei als "index.html" definiert ist, muss die Eigenschaft gesetzt werden, vorausgesetzt, die Datei "index.html" soll aus einem Dokumentstammverzeichnis vom Typ "extendedDocumentRoot" für statische Dateien bereitgestellt werden.
com.ibm.ws.webcontainer.enablepartialurltoextendeddocumentroot = true
Der Standardwert ist false.

Ist die Eigenschaft auf true gesetzt, schließt der Web-Container den Inhalt eines Dokumentstammverzeichnisses vom Typ "extendedDocumentRoot" für statische Dateien ein, wenn er angibt, ob eine eingehende Anforderung sich auf einen gültigen partiellen URL bezieht. Wenn eine Anforderung beispielsweise eine URL angibt, die mit /<application context>/<text> endet, und <text> keiner Servlet-oder statischen Datei zugeordnet ist, betrachtet der Web-Container diese URL nur dann als gültige partielle URL, wenn <text> ein gültiges Verzeichnis der Anwendung ist. Daher muss diese Eigenschaft, wenn das Verzeichnis <text> nur in einem Dokumentstammverzeichnis vom Typ "extendedDocumentRoot" für statische Dateien vorhanden ist, gesetzt werden, damit der URL als gültiger partieller URL behandelt wird.

Wichtig: Diese Eigenschaften sind für Dokumentstammverzeichnisse vor Fragmenten für statische Dateien nicht erforderlich. Analog dazu berücksichtigt der Web-Container beim Definieren des gültigen partiellen URL keine Dokumentstammverzeichnisse vom Typ "preFragmentExtendedDocumentRoot" und keine Dokumentstammverzeichnisse vom Typ "extendedDocumentRoot" für JSP-Dateien.