Angepasste Eigenschaften des Web-Containers

Sie können Name/Wert-Paare konfigurieren, in denen der Name für einen Eigenschaftsschlüssel und der Wert für einen Zeichenfolgewert steht, mit denen Sie interne Systemkonfigurationseigenschaften definieren können. Durch die Definition neuer Eigenschaften können Sie Einstellungen konfigurieren, die nicht in der Administrationskonsole verfügbar sind. Die folgende Liste enthält einige der verfügbaren angepassten Eigenschaften für Web-Container.

Gehen Sie wie folgt vor, um angepasste Eigenschaften für den Web-Container festzulegen:

  1. Klicken Sie in der Administrationskonsole auf Server > Servertypen > WebSphere-Anwendungsserver > Servername > Einstellungen des Web-Containers > Web-Container.
  2. Wählen Sie unter "Weitere Eigenschaften" die Option Angepasste Eigenschaften aus.
  3. Klicken Sie auf der Seite "Angepasste Eigenschaften" auf Neu.
  4. Geben Sie auf der Seite mit den Einstellungen im Feld Name den Namen der angepassten Eigenschaft ein, die Sie konfigurieren möchten, und im Feld Wert den Wert für diese Eigenschaft.
  5. Klicken Sie auf Anwenden oder OK.
  6. Klicken Sie in der Taskleiste der Konsole auf Speichern, um Ihre Konfigurationsänderungen zu sichern.
  7. Starten Sie den Server erneut.

In der folgenden Liste sind die angepassten Eigenschaften aufgeführt, die mit Application Server bereitgestellt werden. JSP-spezifische angepasste Eigenschaften des Web-Containers und angepasste Eigenschaften des HTTP-Transports werden in gesonderten Artikeln aufgelistet.

Sie können auf der Seite "Angepasste Eigenschaften" die folgenden Eigenschaften für die Java Virtual Machine definieren.

BodyContentBuffSize

Die Puffergröße für den Body-Inhalt, die für eine JSP-Datei (JavaServer Pages) festgelegt ist, kann die Leistung einiger Anwendungen beeinträchtigen. Standardmäßig beträgt die Puffergröße 512 Bytes. Sie können aber die angepasste Eigenschaft BodyContentBuffSize verwenden, um einen anderen Pufferwert festzulegen.

Name Standardwert
BodyContentBuffSize 512

com.ibm.ws.jsf.disablealternatefacesconfigsearch

Inaktiviert die Suche nach "META-INF/*.faces-config.xml" auf MyFaces für alle Webanwendungen in einem Server.

Name Standardwert
com.ibm.ws.jsf.disablealternatefacesconfigsearch false

com.ibm.ws.jsp.doNotEscapeWhitespaceCharsInExpression

Normalerweise werden Ausdrücke der Expression Language (EL) in Befehlsdateien ausgewertet, bevor die Befehlsdateien einer JSP (JavaServer Page) kompiliert werden. Um sicherzustellen, dass ein EL-Ausdruck, dessen Syntax Zeichen für Rücklauf (\r), für neue Zeile (\n) oder für Tabulatortaste (\t) enthält, keine Ausnahme des Typs "javax.el.Exceptionable" enthält, müssen Sie die angepasste Eigenschaft "com.ibm.ws.jsp.expressionistic" in der Datei ibm-web-ext.xml auf true setzen.

Name Standardwert
com.ibm.ws.jsp.doNotEscapeWhitespaceCharsInExpression false

com.ibm.ws.jsp.enableDefaultIsELIgnoredInTag

Normalerweise werden Ausdrücke der Expression Language (EL) in Befehlsdateien ausgewertet, bevor die Befehlsdateien einer JSP (JavaServer Page) kompiliert werden. Unter bestimmten Bedingungen werden diese EL-Ausdrücke in einer Befehlsdatei nicht ausgewertet, wenn das Attribut <el-ignored> auf "true" gesetzt ist.

Um sicherzustellen, dass EL-Ausdrücke immer ausgewertet werden, setzen sie die angepasste Eigenschaft com.ibm.ws.jsp.enableDefaultIsELIgnoredInTag auf true. Der Standardwert für diese Eigenschaft ist "false".

Name Standardwert
com.ibm.ws.jsp.enableDefaultIsELIgnoredInTag false

com.ibm.ws.jsp.expressionreturnemptystring

Mit dieser Eigenschaft können Sie angeben, ob der JSP-Container eine leere Zeichenfolge oder null für nicht definierte Werte in einem Ausdruck zurückgeben soll.

Ein Ausdruck wie der folgende kann null zurückgeben, wenn testValue in testBean null ist:
<input type='text' name='test' value='<%=testBean.getTestValue()%>'maxlength="16"> 

Einige Anwendungen erwarten die Rückgabe einer leeren Zeichenfolge anstelle von null in diesen Situationen. Wenn die Anwendungen, die Sie auführen, die Rückgabe einer leeren Zeichenfolge erwarten, fügen Sie diese angepasste Eigenschaft den Einstellungen Ihres Web-Containers mit dem Wert true hinzu.

Name Standardwert
com.ibm.ws.jsp.expressionreturnemptystring false

com.ibm.ws.jsp.getWriterOnEmptyBuffer

Der dynamische Cacheservice verwendet Flush-Operationen, um festzustellen, wann ein Webfragment, das zwischengespeichert werden kann, z. B. ein JSP include oder c:import, endet und das nächste Webfragment beginnt. Wenn Sie die angepasste Eigenschaft com.ibm.wsspi.jsp.usecdatatrim für Ihre JSP-Engine auf true setzen, werden alle Leerzeichen und zusätzlichen Zeilen im generierten Java-Code herausgefiltert. In dieser Situation gibt es vor der ersten Flush-Operation möglicherweise keinen Inhalt zum Schreiben. Wenn der generierte Java-Code vor der ersten Flushoperation Text oder anderen Code enthält, wird die normale Verarbeitung des dynamischen Cache-Service ausgeführt.

Wenn Sie die angepasste Eigenschaft com.ibm.wsspi.jsp.usecdatatrim auf den Wert true setzen und den dynamischen Cache-Service verwenden, müssen Sie auch die angepasste Eigenschaft com.ibm.ws.jsp.getWriterOnEmptyBuffer auf den Wert true setzen. Diese angepasste Eigenschaft legt fest, dass die JSP-Engine die Flush-Funktion aufruft, wenn sie das Ende des ersten Webfragments, das zwischengespeichert werden kann, erreicht, selbst wenn keine Daten vorhanden sind, für die eine Flush-Operation ausgeführt werden kann. Der Standardwert für diese Eigenschaft ist "false".

Name Standardwert
com.ibm.ws.jsp.getWriterOnEmptyBuffer false

com.ibm.ws.jsp.limitBuffer

Die Puffergröße für den Body-Inhalt, die für die Tag-Bodys für eine JSP-Datei verwendet wird, wird wiederverwendet, um die Leistung zu optimieren. Wenn die Größe eines Tag-Bodys die Standardpuffergröße für den Body-Inhalt überschreitet, wird der Puffer entsprechend der Größe des Tag-Bodys angepasst. Allerdings wird die Puffergröße nicht auf die Standardgröße zurückgesetzt, nachdem eine Anforderung bedient wurde. Daher kann die Größe des Heapspeichers, der von der Implementierung org.apache.jasper.runtime.BodyContentImpl verwendet wird, im Laufe der Zeit ansteigen. Sie können die Puffergröße für den Body-Inhalt konfigurieren, indem Sie einen ganzzahligen Wert für die angepasste Eigenschaft BodyContentBuffSize angeben. Weitere Informationen finden Sie im Artikel BodyContentBuffSize.

Verwenden Sie die angepasste Eigenschaft com.ibm.ws.jsp.limitBuffer, um große Puffergrößen für Body-Inhalt freizugeben und einen Puffer mit der Standardgröße zu erstellen.

Name Standardwert
com.ibm.ws.jsp.limitBuffer false

com.ibm.ws.jsp.throwExceptionForAddELResolver

Setzen Sie die Eigenschaft com.ibm.ws.jsp.throwExceptionForAddELResolver auf den Wert true, wenn ein ELResolver nicht über ein Servlet oder einen Filter registriert werden soll, nachdem die Anwendung eine Anforderung vom Client empfangen hat. Wird diese Eigenschaft auf "true" gesetzt, wird gemäß JSP-Spezifikation (Java™ Server Pages) für die Methode "addELResolver()" der Schnittstelle JspApplicationContext eine Ausnahme vom Typ "IllegalStateException" ausgelöst.

Der Standardwert für diese Eigenschaft ist "false".

Name Standardwert
com.ibm.ws.jsp.throwExceptionForAddELResolver false
[z/OS]

com.ibm.ws.jsp.zosFileLockRetrying

Verwenden Sie die Eigenschaft com.ibm.ws.jsp.zosFileLockRetrying, um anzugeben, wie lange (in Sekunden) ein Thread versucht, eine Sperre für eine JSP-Datei anzufordern.

Eine JSP-Datei wird vor dem Start des Kompilierungsprozesses gesperrt. Nach Abschluss des Kompilierungsprozesses wird die Sperre wieder freigegeben. Wenn ein Thread eine JSP-Datei nicht sperren kann, setzt der Thread 240 Sekunden lang seine Versuche fort, die Dateisperre für diese JSP-Datei anzufordern. Wenn der Thread in diesem Zeitraum keine Sperre für die JSP-Datei erhält, wird eine Fehlernachricht ausgegeben. Der Thread unternimmt keine weiteren Versuche, eine Sperre für die JSP-Datei anzufordern.

Name Standardwert
com.ibm.ws.jsp.zosFileLockRetrying 240
[z/OS]

com.ibm.ws.jsp.zosReCompile

Verwenden Sie die Eigenschaft com.ibm.ws.jsp.zosReCompile, um festzulegen, wie oft ein Thread versuchen soll, eine Sperre für eine JSP-Datei anzufordern.

Nachdem ein Thread die Sperre für eine JSP-Datei erhalten hat, bestimmt der Thread, ob die JSP-Datei bereits kompiliert wurde. Wenn die JSP-Datei noch nicht kompiliert wurde, versucht der Thread, die JSP-Datei zu kompilieren.

Falls der Thread die JSP-Datei auch nach der mit dieser Eigenschaft festgelegten Anzahl an Wiederholungen nicht kompilieren kann, wird eine Fehlernachricht ausgegeben. Der Thread unternimmt keine weiteren Versuche, die JSP-Datei zu kompilieren.

Name Standardwert
Standardwert 5

com.ibm.ws.webcontainer.allowDotsinName

Wenn der Name der angeforderten statischen Datei mehrere aufeinanderfolgende Punkte enthält, wird die Anforderung vom Server als verbotene Anforderung zurückgewiesen.

Wenn Sie diese Eigenschaft auf true setzen, wird die angeforderte Datei bereitgestellt.

Name Standardwert
com.ibm.ws.webcontainer.allowDotsinName false

com.ibm.ws.webcontainer.allowPrivAccessGetResource

Der Pfad zu der mit der Option für das erweiterte Dokumentstammverzeichnis definierten Datei wird nicht als Teil der installierten Anwendungsartefakte betrachtet. Daher sind für den Zugriff auf die Datei Sonderberechtigungen erforderlich. Die Ausnahme "Java.security.AccessControlException: Access denied (java.io.FilePermission)" wird ausgelöst, wenn die erforderlichen Berechtigungen für diese Datei nicht in der Webanwendung bereitgestellt werden.

Wenn Sie diese Eigenschaft auf true setzen, ist die Anwendung berechtigt, auf die Datei, deren Pfad im erweiterten Dokumentstammverzeichnis definiert ist, zuzugreifen.

Name Standardwert
com.ibm.ws.webcontainer.allowPrivAccessGetResource false

com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual

Wenn der Abfrageparameter in einer URL nur die Zeichenfolge "name" anstelle des erwarteten Formats "name=value" enthält, gibt der Server null als Wert für die Abfrage "request.getParameter("name")" zurück.

Wenn Sie diese Eigenschaft auf true setzen und der Abfrageparameter in einer URL nur die Zeichenfolge "name" enthält, gibt der Server eine leere Zeichenfolge als Wert für die Abfrage "request.getParameter("name")" zurück.

Name Standardwert
com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual false

com.ibm.ws.webcontainer.appendMetaInfResourcesInLooseLib

Diese Eigenschaft entfernt den zusätzlichen Pfad bei der Implementierung einer Anwendung in einer ungebundenen Konfiguration und wird hauptächlich in einer Entwicklungsumgebung oder einem Server verwendet.

Name Standardwert
com.ibm.ws.webcontainer.appendMetaInfResourcesInLooseLib false

com.ibm.ws.webcontainer.asyncmaxsizetaskpool

Diese angepasste Eigenschaft gibt die maximale Taskwarteschlangengröße an, die verwendet wird, um das zugeteilte asynchrone Servlet zu speichern.

Name Standardwert
com.ibm.ws.webcontainer.asyncmaxsizetaskpool 5000

com.ibm.ws.webcontainer.asyncpurgeinterval

Diese angepasste Eigenschaft gibt das Intervall an, in dem der Web-Container die Taskwarteschlange löschen soll, um die Ressource der abgebrochenen Tasks freizugeben.

Name Standardwert
com.ibm.ws.webcontainer.asyncpurgeinterval 30000

com.ibm.ws.webcontainer.channelwritetype

Standardmäßig verwendet der Web-Container asynchrone Schreibvorgänge, um Antwortdaten in Blöcken zu schreiben, die maximal die Größe des Antwortpuffers haben können. Für Antworten, die die Größe des Antwortpuffers überschreiten, setzt der Web-Container die Pufferung von Antwortdaten im Hauptspeicher fort, während er auf den Abschluss eines asynchronen Schreibvorgangs für einen Antwortdatenblock wartet. Dieser Prozess kann dazu führen, dass ein Teil einer großen Antwort im Hauptspeicher gehalten wird, was eine hohe Speicherbelegung und möglicherweise Fehler aufgrund abnormaler Speicherbedingungen zur Folge haben kann. Ein Anwendungsserver kann blockieren, wenn ein Server mehr Anforderungen gleichzeitig verarbeitet, als Threads für den Web-Container definiert sind.

Wenn die Eigenschaft com.ibm.ws.webcontainer.channelwritetype auf sync gesetzt ist, werden synchrone Schreibvorgänge verwendet, andernfalls werden standardmäßig asynchrone Schreibvorgänge verwendet. Bei synchronen Schreibvorgängen werden die Antwortdaten synchron in Blöcken geschrieben, die maximal die Größe des Antwortpuffers haben können, und keine Antwortdaten im Hauptspeicher gepuffert, während auf den Abschluss eines synchronen Schreibvorgangs für einen Antwortdatenblock gewartet wird. Deshalb entspricht die maximale Menge an Antwortdaten, die im Hauptspeicher gehalten werden, in etwa dem Wert von "responsebuffersize", multipliziert mit der Anzahl der Web-Container-Threads. Die maximale Anzahl an Anforderungen, die vom Web-Container gleichzeitig verarbeitet werden können, ist durch die Anzahl der Web-Container-Threads begrenzt. Weitere Anforderungen werden in die Warteschlange eingereiht und müssen warten, bis die Verarbeitung einer in Bearbeitung befindlichen Anforderung abgeschlossen ist.

Die angepasste Eigenschaft "responsebuffersize" des Web-Containers definiert die maximale Menge an Antwortdaten, die der Web-Container in einem einzigen Block schreiben kann. Der Standardwert ist 32 KB. Sie wird verwendet, um die Anzahl der Schreibvorgänge zu ändern, die der Web-Container benötigt, um vollständige Antwortdaten zu senden. Wenn eine Anwendung jedoch eine Flush-Operation für Antwortdaten ausführt, werden alle vom Web-Container gehaltenen Antwortdaten sofort, d. h. unabhängig von der Eigenschaft "responsebuffersize", geschrieben.

Verwenden Sie das folgende Name/Wert-Paar, um Datenblöcke in synchronen Schreibvorgängen zu schreiben:

Name Standardwert
com.ibm.ws.webcontainer.channelwritetype async

com.ibm.ws.webcontainer.checkEDRinGetRealPath

Die Java-Servlet-API "ServletContext.getRealPath()" gibt nicht den richtigen Pfad für eine angeforderte Ressource zurück, wenn die Ressource in einem extendedDocumentRoot-Pfad und nicht im Pfad der installierten Anwendung enthalten ist. Wenn die Java-Servlet-API "ServletContext.getRealPath()" die angeforderte Ressource im extendedDocumentRoot-Pfad suchen soll, falls die Ressource nicht im Pfad der installierten Anwendung gefunden wird, setzen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.checkEDRinGetRealPath auf true.

Wenn Sie diese Eigenschaft auf "true" setzen und die angeforderte Ressource auch nicht im extendedDocumentRoot-Pfad gefunden wird, wird ein Nullwert zurückgegeben.

Name Standardwert
com.ibm.ws.webcontainer.checkEDRinGetRealPath false

com.ibm.ws.webcontainer.copyattributeskeyset

Diese angepasste Eigenschaft ist für Situationen bestimmt, in denen die Methode "request.getAttributeNames" eine Liste mit Werten zurückgibt. Wenn ein Servlet die Liste mit der Methode "request.removeAttribute" ändert, verursachen nachfolgende Aufrufe der Methode "nextElement" eine Ausnahme vom Typ "java.util.ConcurrentModificationException". Um einem Servlet die Änderung der Liste zu ermöglichen, legen Sie den Wert "true" für die angepasste Eigenschaft com.ibm.ws.webcontainer.copyattributeskeyset fest. Wenn Sie den Wert "true" für diese angepasste Eigenschaft festlegen, wird eine Kopie der Attributliste zurückgegeben. Dies ermöglicht dem Servlet, die Liste zu ändern, ohne dass beim Aufruf der Methode "nextElement" eine Ausnahme vom Typ "java.util.ConcurrentModificationException" ausgelöst wird.

Name Standardwert
com.ibm.ws.webcontainer.copyattributeskeyset false

com.ibm.ws.webcontainer.decodeParamViaReqEncoding

Wenn die URI nicht in UTF-8 codiert ist, die Anforderungscodierung jedoch auf UTF-8 eingestellt ist, werden die Zeichen, deren codierte Werte in ISO-8859 abweichen, in der Antwort falsch angezeigt. Wenn die Anforderung beispielsweise mit Microsoft Internet Explorer gesendet wird, werden die Zeichen als N mit Tilde (Ñ) angezeigt. Um sicherzustellen, dass die Zeichen basierend auf dem Codierungssatz der Anforderung richtig codiert und decodiert werden, fügen Sie die angepasste Web-Container-Eigenschaft com.ibm.ws.webcontainer.decodeParamViaReqEncoding zu Ihren Einstellungen des Web-Containers hinzu, und setzen Sie sie auf "true".

Name Standardwert
com.ibm.ws.webcontainer.decodeParamViaReqEncoding false

com.ibm.ws.webcontainer.deferServingRequestsUntilEarStarted

Diese angepasste Eigenschaft verzögert die Verarbeitung von Anforderungen, bis die EAR-Datei (Enterprise Archive) gestartet ist.

Name Standardwert
com.ibm.ws.webcontainer.deferServingRequestsUntilEarStarted false

com.ibm.ws.webcontainer.deferServletRequestListenerDestroyOnError

Wenn diese angepasste Eigenschaft auf true gesetzt ist, aktiviert der Web-Container CDI für die ordnungsgemäße Verarbeitung von angepassten Fehlerseiten.

Name Standardwert
com.ibm.ws.webcontainer.deferServletRequestListenerDestroyOnError false

com.ibm.ws.webcontainer.disableSetCharacterEncodingAfterParametersRead

Der Web-Container verarbeitet eine Methode vom Typ "setCharacterEncoding(String)" der API ServletRequest auch dann, wenn sie nach dem Parsen der gesendeten Daten aufgerufen wird. Gemäß der Java-Servletspezifikation ignoriert der Web-Container eine Methode vom Typ "setCharacterEncoding(String)", wenn diese nach dem Parsen der Daten aufgerufen wird.

Soll der Web-Container eine Methode vom Typ "setCharacterEncoding(String)" ignorieren, wenn diese Methode nach dem Parsen der Daten aufgerufen wird, fügen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.disableSetCharacterEncodingAfterParametersRead den Konfigurationseinstellungen des Web-Containers hinzu, und legen Sie den Wert true für diese Eigenschaft fest.

Der Standardwert für diese Eigenschaft ist false.

Name Standardwert
com.ibm.ws.webcontainer.disableSetCharacterEncodingAfterParametersRead false

com.ibm.ws.webcontainer.disableStaticMappingCache

Die angepasste Eigenschaft "com.ibm.ws.webcontainer.disableStaticMappingCache" erlaubt dem Benutzer, das statische Caching zu inaktivieren. Die Eigenschaft kann in der Administrationskonsole oder über den Kontextparameter in der Datei "web.xml" gesetzt werden.

Zum Inaktivieren des statischen Caching für alle implementierten Anwendungen verwenden Sie einen Stern. Wenn Sie das statische Caching für bestimmte Anwendungen inaktivieren möchten, verwenden Sie ein Komma.

Beispielsweise inaktiviert die Einstellung com.ibm.ws.webcontainer.disableStaticMappingCache=* das statische Caching für alle implementierten Anwendungen. com.ibm.ws.webcontainer.disableStaticMappingCache=SpecialApp,RareApp inaktiviert das statische Caching nur für diese zwei Anwendungen.

Sie können auch einen Kontextparameter in der Datei web.xml festlegen, um das statische Caching für die Anwendung zu inaktivieren. Geben Sie den Parameternamen com.ibm.ws.webcontainer.DISABLE_STATIC_MAPPING_CACHE an, und setzen Sie den Parameterwert auf true.

Für diese Eigenschaft gibt es keine Standardeinstellung.

Name Standardwert
com.ibm.ws.webcontainer.disableStaticMappingCache Ohne

com.ibm.ws.webcontainer.disableSystemAppGlobalListenerLoading

Wenn eine Systemanwendung die erste Anwendung ist, die gestartet wird, und versucht, einen globalen Listener in einer gemeinsam genutzten Bibliothek zu laden, die dem Klassenlader des Servers zugeordnet ist, wird dieser Listener von der Anwendung nicht geladen und kann auch von einer später gestarteten Anwendung, die keine Systemanwendung ist, nicht geladen oder aufgerufen werden. Setzen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.disableSystemAppGlobalListenerLoading auf "true", um zu verhindern, dass Systemanwendungen globale Listener laden. Wenn diese Eigenschaft auf true gesetzt ist, versucht die Systemanwendung nicht, globale Listener zu laden, und Anwendungen, die später gestartet werden und keine Systemanwendungen sind, können den Listener aus der gemeinsam genutzten Bibliothek laden, die einem Serverklassenlader zugeordnet ist.

Name Standardwert
com.ibm.ws.webcontainer.disableSystemAppGlobalListenerLoading false

com.ibm.ws.webcontainer.disablexPoweredBy

Wenn Sie die Serversicherheit konfigurieren, können Sie den Header "X-Powered-By" inaktivieren, wenn Sie den Server, mit dem Sie arbeiten, nicht offenlegen möchten. Verwenden Sie diese angepasste Eigenschaft, um den Header "X-Powered-By" zu inaktivieren, was verhindert, dass der Header in der HTTP-Antwort gesendet wird. Der Standardwert ist "false". Setzen Sie diese Eigenschaft jedoch auf true, wenn Sie diesen Header inaktivieren möchten.

Name Standardwert
com.ibm.ws.webcontainer.disablexPoweredBy false

com.ibm.ws.webcontainer.disallowAllFileServing

Verwenden Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.disallowAllFileServing, um den Dateiservice in allen Anwendungen eines bestimmten Anwendungsservers zu inaktivieren.

Sie können den Dateiservice auf globaler Ebene für einen bestimmten Anwendungsserver mit der angepassten Eigenschaft "fileServingEnabled" aktivieren. Die Eigenschaft "fileServingEnabled" wird jedoch von bestimmten Implementierungsinformationen in jeder Anwendung überschrieben. Die aktuelle angepasste Eigenschaft "fileServingEnabled" dient nur als Ausweicheinstellung, falls in einer Anwendung die Einstellung "fileServingEnabled" nicht definiert ist.

Wenn Sie diese Einstellung für einen bestimmten Anwendungsserver global überschreiben möchten, um zu verhindern, dass der Anwendungsserver statische Dateien, unabhängig von deren individuellen Implementierungseinstellungen, überschreibt, legen Sie den Wert true für die angepasste Eigenschaft com.ibm.ws.webcontainer.disallowAllFileServing des Web-Containers fest. Verwenden Sie dazu das folgende Name/Wert-Paar:

Name Standardwert
com.ibm.ws.webcontainer.disallowAllFileServing false

com.ibm.ws.webcontainer.disallowServeServletsByClassname

Wenn die Eigenschaft "ServeServletsByClassnameEnabled" aktiviert ist, ist ein direkter Zugriff auf Servlets möglich, was ein potenzielles Sicherheitsrisiko darstellen kann. Definieren Sie die folgende angepasste Eigenschaft, um die Verwendung der Eigenschaft "ServeServletsByClassnameEnabled" auf Anwendungsserverebene global zu untersagen.

Name Standardwert Gültiger Wert
com.ibm.ws.webcontainer.disallowserveservletsbyclassname true false
Anmerkung: Für IBM® WebSphere Application Server Version 8.5.5.6 lautet der Standardwert true. Für ältere Versionen ist der Standardwert false festgelegt, sofern nicht ein vorläufiger Fix für PI31622 installiert wurde.

com.ibm.ws.webcontainer.discernUnavailableServlet

Wenn der Web-Container eine Ausnahme vom Typ "UnavailableException" empfängt, kann er gewöhnlich nicht feststellen, ob die Ausnahme von einem Servlet oder von einer zugeteilten Ressource ausgegeben wurde. Deshalb markiert der Web-Container das Servlet automatisch als nicht verfügbar, selbst wenn es die zugeteilte Ressource ist, die nicht verfügbar ist.

Wenn Sie mit Version 7.0.0.5 oder höher arbeiten und die angepasste Eigenschaft com.ibm.ws.webcontainer.discernUnavailableServlet auf "true" gesetzt haben, wird jede Ausnahme vom Typ "UnavailableException", die von einer zugeteilten Ressource ausgegeben wird, in einen Wrapper eingeschlossen. Dieser Wrapper ermöglicht dem Web-Container festzustellen, ob die Ausnahme vom Servlet oder von einer zugeteilten Ressource ausgegeben wurde. Falls die Ausnahme nicht vom Servlet ausgegeben wurde, markiert der Web-Container das Servlet auch nicht als nicht verfügbar.

Name Standardwert
com.ibm.ws.webcontainer.discernUnavailableServlet false

com.ibm.ws.webcontainer.dispatcherRethrowSER

Der RequestDispatcher gibt die Ausnahmen der zugeteilten Servlets zurück an die Servlets. Dieses Verhalten unterscheidet sich von dem früherer Releases. Wenn Sie nicht möchten, dass Ausnahmen an das Servlet zurückgegeben werden, das die Zuteilung ausführt, fügen Sie die angepasste Eigenschaft "com.ibm.ws.webcontainer.dispatcherRethrowSER" zu den Konfigurationseinstellungen des Web-Containers hinzu, und setzen Sie die Eigenschaft auf false.

Name Standardwert
com.ibm.ws.webcontainer.dispatcherRethrowSER true
Unterstützte Konfigurationen Unterstützte Konfigurationen: Die angepasste Eigenschaft com.ibm.ws.webcontainer.dispatcherRethrowSError setzt die angepasste Eigenschaft com.ibm.ws.webcontainer.dispatcherRethrowSER außer Kraft. Wenn Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.dispatcherRethrowSError auf true setzen, wird die angepasste Eigenschaft "com.ibm.ws.webcontainer.dispatcherRethrowSER" ebenfalls auf "true" gesetzt. sptcfg

com.ibm.ws.webcontainer.dispatcherRethrowSError

Wenn eine JSP-Datei einen Kompilierungsfehler enthält, wird der Laufzeitfehler vom Container abgefangen und direkt bearbeitet. Ausnahmen werden von der zugeteilten JSP-Ressource nicht weitergeleitet und berücksichtigt. Mit der angepassten Eigenschaft com.ibm.ws.webcontainer.dispatcherRethrowSError werden Ausnahmebedingungen wieder an die zugeteilte JSP-Ressource übergeben.

Name Standardwert
com.ibm.ws.webcontainer.dispatcherRethrowSError false
Unterstützte Konfigurationen Unterstützte Konfigurationen: Die angepasste Eigenschaft com.ibm.ws.webcontainer.dispatcherRethrowSError setzt die angepasste Eigenschaft "com.ibm.ws.webcontainer.dispatcherRethrowSER" außer Kraft. Wenn Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.dispatcherRethrowSError auf true setzen, wird die angepasste Eigenschaft com.ibm.ws.webcontainer.dispatcherRethrowSER ebenfalls auf "true" gesetzt. sptcfg
[z/OS]

com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog

Wenn ein rekursiver Fehler in einer Anwendung auftritt, wird eine Ausnahmenachricht von der Traceprüfmethode protokolliert, die die Nachricht an die Systemkonsole weiterleitet. Wenn die Nachricht stattdessen im Fehlerprotokoll aufgezeichnet werden soll, fügen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog den Konfigurationseinstellungen des Web-Containers hinzu und legen Sie den Wert true für diese Eigenschaft fest. Wird die Eigenschaft com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog auf true gesetzt, werden Ausnahmenachrichten statt an die Systemkonsole an das Fehlerprotokoll gesendet.

Name Standardwert
com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog false

com.ibm.ws.webcontainer.donotservebyclassname

Die angepasste Eigenschaft com.ibm.ws.webcontainer.donotservebyclassname gibt eine Liste mit Klassen an, die nicht nach Klassenname bereitgestellt werden können.

Name Standardwert
com.ibm.ws.webcontainer.donotservebyclassname Ohne

com.ibm.ws.webcontainer.emptyServletMappings

Wenn diese Eigenschaft auf true gesetzt ist, gibt die angepasste Eigenschaft com.ibm.ws.webcontainer.emptyServletMappings eine leere Sammlung zurück, wenn die Methode getMappings() Servletzuordnungen anfordert und noch keine Zuordnungen hinzugefügt wurden.

Name Standardwert
com.ibm.ws.webcontainer.emptyServletMappings false

com.ibm.ws.webcontainer.enabledefaultservletrequestpathelements

Um eine Anforderung einem Standardservlet ordnungsgemäß zuordnen zu können, müssen Sie die richtigen ServletPath- und PathInfo-Werte bestimmen. In der folgenden Tabelle sind die Auswirkungen der ServletPath- und PathInfo-Werte beschrieben, wenn Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.enabledefaultservletrequestpathelements auf "true" oder "false" setzen.
Tabelle 1. ServletPath- und PathInfo-Werte. Werte für ServletPath und PathInfo
Wert ServletPath-Wert PathInfo-Wert
true Auf den Inhalt des URI hinter dem Kontextpfad gesetzt Auf einen Nullwert gesetzt
false (Standardeinstellung) Auf eine leere Zeichenfolge gesetzt Auf der Basis des URI-Inhalts hinter dem Kontextpfad gesetzt

com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst

Wenn eine Ausnahme eintritt, sucht der Web-Container eine Fehlerseite, die diese Ausnahme behandelt. Die Standardsuchreihenfolge ist folgende:
  1. Übereinstimmende Fehlerseite für den Fehlercode
  2. Übereinstimmende Fehlerseite für den Ausnahmetyp

Die übereinstimmende Seite für den Fehlercode wird immer zurückgegeben, wenn auch eine übereinstimmende Fehlerseite für den Ausnahmetyp in der Datei web.xml definiert ist. Damit der Web-Container die Fehlerseite für den Ausnahmetyp vor der Fehlerseite für den Fehlercode sucht und verwendet, setzen Sie diese Eigenschaft auf true.

Name Standardwert
com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst false

com.ibm.ws.webcontainer.enableExactMatchJSecurityCheck

Geben Sie diese Eigenschaft an, wenn Sie die Verwendung des Schlüsselworts j_security_check im Namen einer Ressource zulassen möchten. Wenn ein URI das Schlüsselwort j_security_check enthält, wird gewöhnlich der Anmeldeprozess eingeleitet.

Name Standardwert
com.ibm.ws.webcontainer.enableExactMatchJSecurityCheck false

com.ibm.ws.webcontainer.enableJspMappingOverride

Wenn ein "url-pattern" in der "jsp-property-group" der Datei "web.xml" definiert wird, wird dieses normalerweise einer JSP-Engine zugeordnet und von dieser verarbeitet. Wenn Sie Anwendungen verwenden, die diese Zuordnung außer Kraft setzen müssen, damit sie den JSP-Inhalt selbst verarbeiten und bereitstellen können, müssen Sie die Eigenschaft com.ibm.ws.webcontainer.enableJspMappingOverride auf true setzen.

Name Standardwert
com.ibm.ws.webcontainer.enableJspMappingOverride false

com.ibm.ws.webcontainer.enableMultiReadOfPostData

Setzen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.enableMultiReadOfPostData auf true, wenn Sie mehrere Lesevorgänge gesendeter Daten möglich sein sollen. Wenn diese Eigenschaft auf "true" gesetzt ist, können die gesendeten Daten entweder als InputStream oder als Reader und als Parameter mehrere Male gelesen werden.

Wenn der Web-Container mehrere Lesevorgänge der gesendeten Daten unterstützt, können Sie eine Anwendung definieren, die die folgenden Aktionen ausführt, falls die gesendeten Daten als InputStream oder Reader erneut von Anfang an gelesen werden sollen:
  1. InputStream oder Reader abrufen
  2. Daten lesen
  3. InputStream oder Reader schließen

Wenn die erste oder dritte Aktion nicht stattfindet, wird der nächste Lesevorgang der gesendeten Daten nicht auf den Anfang dieser Daten eingestellt.

Der Web-Container durchläuft diese Reihenfolge automatisch, wenn eine Anwendung die gesendeten Daten als Parameter erneut liest.

Name Standardwert
com.ibm.ws.webcontainer.enableMultiReadOfPostData false

com.ibm.ws.webcontainer.excludehandledtypesclasses

Verwenden Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.excludehandledtypesclasses, um zu verhindern, dass die Handle-Typklassen an die Methode "onStartup" der Implementierungsklasse "ServletContainerInitializer" übergeben wird.

Name Standardwert
com.ibm.ws.webcontainer.excludehandledtypesclasses false

com.ibm.ws.webcontainer.extractHostHeaderPort and trusthostheaderport

Die Methode "getServerPort" stützt sich auf die Methode "getVirtualPort" des Kanals, die eine Portnummer in der folgenden Reihenfolge zurückgibt:
  1. Portnummer aus dem Anforderungs-URL
  2. Portnummer aus dem Host-Header der Anforderung
Diese Reihenfolge entspricht HTTP/1.1 RFC, aber nicht der API der Java Servlet Specification Version 2.4, die erfordert, dass zuerst die Portnummer aus dem Host-Header, sofern vorhanden, bzw. der Anforderungs-URL zurückgegeben wird. Die korrekt zurückgegebene URL für das vorherige Beispiel ist http://ProxyServer:8888. Der Web-Container wurde so geändert, dass eine Portnummer aus dem Host-Header, sofern vorhanden, bzw. der URL-Port zurückgegeben wird, an dem die Clientverbindung akzeptiert wurde. Sie müssen trusthostheaderport und die angepasste Eigenschaft com.ibm.ws.webcontainer.extractHostHeaderPort auf "true" setzen, damit zuerst die Portnummer aus dem Host-Header der Anforderung zurückgegeben wird. Mit der Administrationskonsole würden Sie diese Eigenschaften wie folgt festlegen:
trusthostheaderport = true     
com.ibm.ws.webcontainer.extractHostHeaderPort = true
Fehler vermeiden Fehler vermeiden: Sie können diese Eigenschaften NICHT in web.xml so festlegen, dass Sie die gewünschten Auswirkungen haben. gotcha
Sie können diese Eigenschaften als angepasste Eigenschaften des Web-Containers über die Administrationskonsole definieren, indem Sie die folgenden beiden Name/Wert-Paare verwenden:
Name Standardwert
com.ibm.ws.webcontainer.extractHostHeaderPort false
trusthostheaderport false
[z/OS]

com.ibm.ws.webcontainer.fileWrapperEvents

Statische Dateien werden von einem Dateiwrapper verarbeitet, der keine SMF- und PMI-Daten für statische Dateien generiert. In Version 5.1 wurde die Verarbeitung statischer Dateien vom Servlet "SimpleFileServlet" durchgeführt, das sowohl SMF- als auch PMI-Daten generiert. Wenn Sie eine Migration von Version 5.1 durchführen und beim Bereitstellen statischer Dateien SMF- und PMI-Daten generieren müssen, fügen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.fileWrapperEvents den Konfigurationseinstellungen des Web-Containers hinzu und legen Sie den Wert true für diese Eigenschaft fest.

Name Standardwert
com.ibm.ws.webcontainer.fileWrapperEvents false
[z/OS]

com.ibm.ws.webcontainer.FileWrapperEventsLessDetail

Der der SMF-Datensatz Typ 120 zeigt im Namensfeld des Berichts zur statischen Datei den Namen der statischen Ressource anstatt "FileServletWrapper" an. Wenn Sie eine Migration von einer früheren Version des Produkts durchgeführt haben und wenn Sie möchten, dass der SMF-Datensatz Typ 120 im Namensfeld des Berichts zur statischen Datei "FileServletWrapper" anzeigen soll, fügen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.FileWrapperEventsLessDetail Ihren Einstellungen des Web-Containers hinzu und legen Sie den Wert true für sie fest.

Name Standardwert
com.ibm.ws.webcontainer.FileWrapperEventsLessDetail false

com.ibm.ws.webcontainer.finishresponseonclose

Verwenden Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.finishresponseonclose, um anzugeben, dass der Web-Container eine Verbindung schließen soll, wenn ein Servlet für ein Ausgabeprogramm oder einen Ausgabedatenstrom die Methode "close()" aufruft.

Ruft ein Servlet für ein Ausgabeprogramm oder einen Ausgabedatenstrom die Methode "close()" auf, sendet der Web-Container normalerweise die in das Ausgabeprogramm oder den Ausgabedatenstrom geschriebenen Daten an den Client und wartet, bis die Servletmethode "service()" beendet wurde, bevor er die Verbindung schließt. Diese Verzögerung könnte als Antwortverzögerung interpretiert werden, insbesondere dann, wenn die Servletmethode "service()" erst nach dem Schließen des Ausgabeprogramms oder -datenstroms beendet wird.

Name Standardwert
com.ibm.ws.webcontainer.finishresponseonclose false

com.ibm.ws.webcontainer.ForceDifferentCookiePaths

Wenn Sie eine Anwendung für die Verwendung eines Cookies für die Sitzungsverfolgung konfigurieren, wird der Standardpfad für das Cookie auf das Kontextstammverzeichnis der Anwendung gesetzt. Deshalb wird das Cookie nur an Anforderungen gesendet, die an diese Anwendung gestellt werden. Zum Ändern des Standardpfads in "/" (Schrägstrich), sodass das Cookie an Anforderungen für jede Anwendung in dieser Domäne gesendet wird, setzen Sie die angepasste Eigenschaft "ForceDifferentCookiePaths" des Sitzungsmanagers.

Name Standardwert
com.ibm.ws.webcontainer.ForceDifferentCookiePaths false

com.ibm.ws.webcontainer.handlingRequestWithOverridenPath

Wenn eine Anwendung den pathinfo-Wert für den URI überschreibt, verwendet der Server nicht den überschriebenen Wert, um die Anforderung zu bedienen, sondern den ursprünglichen pathinfo-Wert für den URI der Anforderung. Wenn der Server den überschriebenen URI-Pfad verwenden soll, setzen Sie com.ibm.ws.webcontainer.handlingRequestWithOverridenPath auf true. Wenn eine Anwendung den URI-Pfad der Anforderung überschreibt, wird der URI-Pfad gewöhnlich von der Anwendung und nicht vom Server verwendet.

Name Standardwert
com.ibm.ws.webcontainer.handlingRequestWithOverridenPath false

com.ibm.ws.webcontainer.HTTPOnlyCookies

Die angepasste Eigenschaft com.ibm.ws.webcontainer.HTTPOnlyCookies bietet eine gewisse Verteidigung gegen ein clientseitiges Script, das auf ein geschütztes Cookie zugreift und dessen Inhalt übernimmt. Wenn Sie diese angepasste Eigenschaft verwenden, können Sie verhinden, dass Java-Scripts, die in einem Browser ausgeführt ewrden, auf alle Cookie oder auf eine bestimmte Liste ausgewählter Cookies zugreifen. Jedem in dieser angepassten Eigenschaft angegebenen Cookie wird das Attribut "HTTPOnly" hinzugefügt, das Schutz vor dem Zugriff durch ein clientseitiges Script bietet.
Fehler vermeiden Fehler vermeiden: Wenn Sie com.ibm.ws.webcontainer.HTTPOnlyCookies ohne Operanden angeben, bedeutet dies, dass das Attribut "HTTPOnly" keinem Cookie hinzugefügt wird und dass ein clientseitiges Java-Script, das in einem Browser ausgeführt wird, auf den Inhalt aller Cookies zugreifen kann.gotcha
Sie können die folgenden Werte für diese Eigenschaft angeben.
  • * - Ein Stern bedeutet, dass alle Cookies das Attribut "HTTPOnly" erhalten.
  • eine durch Kommas begrenzte Liste der Cookies, die das Attribut "HTTPOnly" erhalten. Cookies dürfen Platzhalterzeichen enthalten. Das Attribut "HTTPOnly" wird nur für die in der Liste enthaltenen Cookies festgelegt.
Die folgenden Beispiel veranschaulichen, wie diese beiden Einstellungen angegeben werden:
com.ibm.ws.webcontainer.HTTPOnlyCookies=*
com.ibm.ws.webcontainer.HTTPOnlyCookies=cookieName1,Account3Cookie,JsessionID 
Achtung: Für Cookienamen, die mit der Eigenschaft com.ibm.ws.webcontainer.HTTPOnlyCookies angegeben werden, muss die Groß-/Kleinschreibung nicht beachtet werden.
Wichtig: Das Attribut "HTTPOnly" für JSESSIONID- und LTPA-Cookies ist standardmäßig aktiviert. Vor WebSphere Application Server Version 8.0 war die angepasste Eigenschaft com.ibm.ws.security.addHttpOnlyAttributeToCookies standardmäßig auf false gesetzt. Für WebSphere Application Server Version 8.5 ist die Standardeinstellung true.
Hinweis zur Umstellung Hinweis zur Umstellung: Das Attribut "HTTPOnly" für JSESSIONID- und LTPA-Cookies ist standardmäßig aktiviert. Vor WebSphere Application Server Version 8.0 war die angepasste Eigenschaft com.ibm.ws.security.addHttpOnlyAttributeToCookies standardmäßig auf false gesetzt. Der aktuelle Standardwert ist true.

Da das Attribut "HTTPOnly" jetzt mit dem Feld Sitzungscookies auf HTTPOnly setzen, um Cross-Site-Scripting-Attacken zu verhindern in der Administrationskonsole gesetzt wird, müssen Sie zum Inaktivieren dieser Funktion in der Administrationskonsole auf Servertypen > Anwendungsserver > Sitzungsmanagement > Cookies klicken und das Feld Sitzungscookies auf HTTPOnly setzen, um Cross-Site-Scripting-Attacken zu verhindern abwählen.

trns

Weitere Informationen zur Interaktion dieser zwei angepassten Eigenschaften finden Sie in den Cookieeinstellungen und den Hinweisen zur Aktivierung und Migration von Funktionen für die Abschottung des Systems zur Sicherheit.

Name Standardwert
com.ibm.ws.webcontainer.HTTPOnlyCookies Ohne

com.ibm.ws.webcontainer.ignoreinjectionfailure

Wenn eine Ressourcen- oder EJB-Injektion (Enterprise JavaBeans) während des Prozesses der Servletinitialisierung fehlschlägt, wird eine Fehlernachricht in die Serverprotokolldateien geschrieben. Allerdings wird diese Fehlernachricht nicht an den Client weitergegeben. Außerdem wird das Servlet in Betrieb genommen und erst nach dem Neustart der zugehörigen Anwendung reinitialisiert. Wenn während dieser Zeit eine Anforderung empfangen wird, die diese Ressource, deren Injektion fehlgeschlagen ist, referenziert, wird eine Ausnahme vom Typ "NullPointerException" ausgelöst. Dieses Problem kann in ähnlicher Weise auch während der Prozesse der Filter- und Listenerinitialisierung auftreten.

Mit der angepassten Eigenschaft com.ibm.ws.webcontainer.ignoreinjectionfailure können Sie angeben, ob diese Fehlernachrichten weitergegeben werden sollen und ob ein Servlet in Betrieb genommen werden soll. Standardmäßig hat die angepasste Eigenschaft den Wert false, d. h., das zuvor beschriebene Verhalten wird beibehalten. Damit die Ausnahmen, die bei der Injektion auftreten, an den Client weitergegeben werden und das Servlet nicht in Betrieb genommen wird, müssen Sie den Wert false für diese angepasste Eigenschaft beibehalten.

Name Standardwert
com.ibm.ws.webcontainer.ignoreinjectionfailure false

com.ibm.ws.webcontainer.ignoreInvalidQueryString

Wenn der Web-Container ein Codierungszeichen in einem Abfragezeichenfolgenpaar findet, das nicht gültig ist, löst er eine Ausnahme vom Typ "IllegalArgumentException" aus und ignoriert standardmäßig die gesamte Abfragezeichenfolge. In Anwendungen, in denen jedes Feld in der Abfragezeichenfolge eine wichtige Ressource ist, kann es nicht erwünscht sein, dass die gesamte Abfragezeichenfolge ignoriert wird. Wenn Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.ignoreInvalidQueryString auf true setzen, ignoriert der Web-Container Abfragezeichenfolgepaare, die nicht gültig sind, und fährt mit der Verarbeitung gültiger Abfragezeichenfolgepaare fort.

Name Standardwert
com.ibm.ws.webcontainer.ignoreInvalidQueryString false

com.ibm.ws.webcontainer.ignorePostConstructOverriddenMethod

Wenn die annotierte Methode "@PostConstruct" einer übergeordneten Klasse von einer Unterklasse außer Kraft gesetzt wird und die annotierte Methode der Zielunterklasse aufgerufen wird, ruft der Web-Container die Zielunterklasse zweimal auf. Wenn Sie die angepasste Eigenschaft "com.ibm.ws.webcontainer.ignorePostConstructOverriddenMethod" auf true setzen, ruft der Web-Container die Methode der Zielunterklasse nur einmal auf und alle außer Kraft gesetzten Methoden der übergeordneten Klasse werden ignoriert.

Name Standardwert
com.ibm.ws.webcontainer.ignorePostConstructOverriddenMethod false

com.ibm.ws.webcontainer.ignoreSemiColonOnRedirectToWelcomePage

Wenn Sie diese Eigenschaft auf true setzen, ignoriert der Web-Container das Semikolon und alle nachfolgenden Zeichen bei der Umleitung zur Begrüßungsseite.

Name Standardwert
com.ibm.ws.webcontainer.ignoreSemiColonOnRedirectToWelcomePage false

com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest

Der Web-Container ruft für statische Dateianforderungen, die Filter erfordern, eine Sitzung auf. Diese Aktion kann zu Leistungseinbußen führen, z. B. wenn die Persistenz der Datenbanksitzung festgelegt ist. Wenn Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest auf den Wert true setzen, kann der Web-Container keine Sitzung für statische Dateien, die Filter erfordern, aufrufen.

Name Standardwert
com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest false

com.ibm.ws.webcontainer.initFilterBeforeInitServlet

Setzen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.initFilterBeforeInitServlet auf true, damit Filter initialisiert werden, bevor die beim Start zu ladenden Servlets während des Startprozesses einer Anwendung initialisiert werden.

Fehler vermeiden Fehler vermeiden: Damit die Filter beim Anwendungsstart zuerst initialisiert werden, muss sowohl die Eigenschaft com.ibm.ws.webcontainer.invokeFilterInitAtStartup als auch die Eigenschaft com.ibm.ws.webcontainer.initFilterBeforeInitServlet auf true gesetzt sein.gotcha
Name Standardwert
com.ibm.ws.webcontainer.initFilterBeforeInitServlet false

com.ibm.ws.webcontainer.invokeFilterAfterService

Die angepasste Eigenschaft com.ibm.ws.webcontainer.invokeFilterAfterService stellt sicher, dass der Web-Container die fehlgeschlagene Operation flush() nicht aufruft, wenn OutputStream geschlossen ist.

Name Standardwert
com.ibm.ws.webcontainer.invokeFilterAfterService true

com.ibm.ws.webcontainer.invokeFilterInitAtStartup

Die angepasste Eigenschaft com.ibm.ws.webcontainer.invokeFilterInitAtStartup ermöglicht es dem Web-Container, während des Startvorgangs für eine Anwendung die Initialisierungsmethode (init) aufzurufen und einen Filter zu initialisieren.

Name Standardwert
com.ibm.ws.webcontainer.invokeFilterInitAtStartup false

com.ibm.ws.webcontainer.KeepUnreadPostDataAfterResponseSentToClient

Diese Eigenschaft zeigt an, ob gesendete Daten zum Lesen verfügbar sind, nachdem die Antwort des Clients auf eine Anforderung vom Typ "forward" bzw. auf die Rückgabe einer Anforderung vom Typ "sendRedirect" abgesetzt wurde. Wenn diese Eigenschaft auf true gesetzt ist, sind gesendete Daten zum Lesen verfügbar, nachdem die Antwort des Clients auf eine Anforderung vom Typ "forward" bzw. auf die Rückgabe einer Anforderung vom Typ "sendRedirect" abgesetzt wurde. Die Rückgabe erfolgt, falls der Wert true für die angepasste Eigenschaft com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect festgelegt ist. Wenn diese Eigenschaft jedoch auf true gesetzt wird, müssen ungelesene gesendete Daten im Speicher behalten werden, bis die Zielressource ihren Verarbeitungsprozess abgeschlossen hat. Außerdem nimmt die Speicherbelegung zu.

Name Standardwert
com.ibm.ws.webcontainer.KeepUnreadPostDataAfterResponseSentToClient false

com.ibm.ws.webcontainer.logServletContainerInitializerClassloadingErrors

Wenn die Klassen einer Anwendung daraufhin untersucht werden, ob sie den mit der Annotation "HandlesTypes" eines ServletContainerInitializer angegebenen Kriterien entsprechen, können beim Laden der Klassen Probleme im Container auftreten, wenn optionale Anwendungs-JAR-Dateien fehlen. Da der Container nicht entscheiden kann, ob diese Typen von Klassenladefehlern eine ordnungsgemäße Funktionsweise der Anwendung verhindern, ignoriert er die Fehler und stellt eine Konfigurationsoption bereit, über die diese Fehler protokolliert werden können.

Wenn Sie diese Eigenschaft auf "true" setzen, wird die Protokollierung aktiviert.

Name Standardwert
com.ibm.ws.webcontainer.logServletContainerInitializerClassloadingErrors false

com.ibm.ws.webcontainer.mapFiltersToAsterisk

Wenn eine Anforderung verarbeitet wird, setzt der Web-Container Servletzuordnungen zu "*" mit Servletzuordnungen zu "/*" gleich. Wenn dasselbe Verhalten für die Filterzuordnung gelten soll, legen Sie den Wert true für die angepasste Eigenschaft com.ibm.ws.webcontainer.mapFiltersToAsterisk fest. Wenn Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.mapFiltersToAsterisk auf true setzen, erkennt der Web-Container Filterzuordnungen zu "*" als Filterzuordnungen zu "/*". Bei dieser angepassten Eigenschaft muss die Groß-/Kleinschreibung nicht beachtet werden.

Name Standardwert
com.ibm.ws.webcontainer.mapFiltersToAsterisk false

com.ibm.ws.webcontainer.maxParamPerRequest

Sie können diese Eigenschaft verwenden, um die maximal zulässige Parameteranzahl in Ihren eingehenden Anforderungen basierend auf Ihren Anwendungen und Ihrer Umgebung zu ändern. Die maximal zulässige Anzahl Parameter pro eingehender Anforderung (GET oder POST) ist standardmäßig 10000.

Sie können diese Eigenschaft auf -1 setzen, wenn Sie die Anzahl der Parameter, die in eine Anforderung eingschlossen werden, nicht beschränken möchten.

Name Standardwert
com.ibm.ws.webcontainer.maxParamPerRequest 10000

com.ibm.ws.webcontainer.metainfresourcescachesize

Mit dieser Eigenschaft können Sie die Anzahl der Einträge im META-INF-Ressourcencache ändern. Die Standardeinstellung für diese Eigenschaft ist 20.

Name Standardwert
com.ibm.ws.webcontainer.metainfresourcescachesize 20

com.ibm.ws.webcontainer.modifiedFileNotFoundExceptionBehavior

Wenn eine nicht vorhandene Datei als Ziel für eine Einschluss- oder Weiterleitungsoperation des Anforderungsdispatchers angegeben ist, wird eine Ausnahme des Typs "FileNotFoundException" ausgelöst. Sie aktivieren diese Ausnahme des Typs "Datei nicht gefunden", indem Sie diese angepasste Eigenschaft auf true setzen und zulassen, dass die Ausnahme ausgelöst wird, wenn eine Datei nicht vorhanden ist. Wenn Sie diese Eigenschaft auf false setzen, wird die FileNotFoundException unterdrückt und der Fehler wird nicht protokolliert. Wenn eine solche Anforderung zu einer Ausnahme 404 führt, werden auch keine FFDCs mehr erstellt.

Name Standardwert
com.ibm.ws.webcontainer.modifiedFileNotfFoundExceptionBehavior true

com.ibm.ws.webcontainer.ModifiedSinceLaterThanFileTimeStamp

Wenn Sie diese Eigenschaft auf true setzen, gibt der Web-Container eine Antwort 304 zurück, wenn die If-Modified-Since-Zeitmarke der angeforderten Variante neuer ist als die Zeitmarke der Zielvariante.

Name Standardwert
com.ibm.ws.webcontainer.ModifiedSinceLaterThanFileTimeStamp false

com.ibm.ws.webcontainer.normalizerequesturi

Gewöhnlich treten keine Fehler vom Typ 404 für Anforderungs-URIs auf, wenn ein Anforderungs-URI von einem Browser übergeben wird, weil die meisten modernen Browser einen Anforderungs-URI vor dem Aufruf von WebSphere Application Server automatisch normalisieren. Deshalb normalisiert der Web-Container einen Anforderungs-URI standardmäßig nicht, bevor versucht wird, diesen URI in eine Anwendungs- und Servletzuordnung aufzulösen.

Ein Anforderungs-URI, der /./ oder /../ als Teil des Anwendungskontexts enthält, der nicht normalisiert wurde, kann mit einem Fehler vom Typ 404 fehlgeschlagen. Dasselbe geschieht bei einem Anforderungs-URI, der /./" oder /../ als Teil eines Servletpfads enthält, der nicht normalisiert wurde. Die Servletzuordnung schlägt fehl und es wird ein Fehler vom Typ 404 ausgegeben, obwohl der URI vor der Auflösung in eine JSP- oder statische Datei normalisiert wird.

Sie können die angepasste Eigenschaft com.ibm.ws.webcontainer.normalizerequesturi auf true setzen, damit der Web-Container diese Typen von Anforderungs-URIs normalisiert.

Name Standardwert
com.ibm.ws.webcontainer.normalizerequesturi false

com.ibm.ws.webcontainer.parseUTF8PostData

Wenn der Web-Container versucht, eine Anforderung zu verarbeiten, die gesendete, nicht mit einem URL codierte UTF-8-Daten enthält, greift die Zielressource auf die gesendeten Daten als Parameter zu. Die UTF-8-Daten werden jedoch falsch decodiert, und die Ergebnisdaten können verloren gehen.

Um dieses Problem zu beheben, müssen Sie den Wert "true" für die angepasste Eigenschaft com.ibm.ws.webcontainer.parseUTF8PostData festlegen. Wenn der Web-Container Parameter verarbeitet, ermittelt er gesendete, nicht mit einem URL codierte UTF-8-Daten und schließt diese in die Parameterwerte ein.

Zum Verwenden dieser Funktion müssen Sie den Wert auf "true" setzen.

Name Standardwert
com.ibm.ws.webcontainer.parseUTF8PostData false

com.ibm.ws.webcontainer.preserveRequestParameterValues

Verwenden Sie diese angepasste Eigenschaft, um die ursprünglichen in der Anforderung verwendeten Parameterwerte beizubehalten.

Die Methode javax.servlet.ServletRequest.getParameterValues() gibt einen String-Array der Anforderungsparameterwerte zurück. Wenn dieser String-Array direkt bearbeitet wird, können die ursprünglichen Anforderungsparameter verloren gehen. Alle nachfolgenden Aufrufe der Methode javax.servlet.ServletRequest.getParameterValues() geben die geänderten Werte zurück.

Zum Verwenden dieser Funktion müssen Sie den Wert auf true setzen.

Name Standardwert
com.ibm.ws.webcontainer.preserveRequestParameterValues false

com.ibm.ws.webcontainer.provideQStringToWelcomeFile

Wenn eine Anforderung zum ersten Mal an das Kontextstammverzeichnis einer Anwendung gesendet wird, wird die Anforderung an eine Begrüßungsdatei (Welcome-Datei) weitergeleitet. Ist eine Abfragezeichenfolge in der ersten Anforderung enthalten, ist sie für die Begrüßungsdatei nicht verfügbar, wenn das Attribut "request.getQueryString()" in die Begrüßungsdatei aufgenommen wurde. Die Abfragezeichenfolge ist jedoch für die Begrüßungsdatei verfügbar, wenn das Attribut "javax.servlet.forward.query_string" in die Begrüßungsdatei aufgenommen wurde.

Wenn Sie das Attribut "request.getQueryString()" anstelle des Attributs "javax.servlet.forward.query_string" verwenden müssen, um die Abfrage für die Begrüßungsdatei verfügbar zu machen, fügen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.provideQStringToWelcomeFile zur Konfiguration des Web-Containers hinzu und legen Sie den Wert true für diese Eigenschaft fest.

Name Standardwert
com.ibm.ws.webcontainer.provideQStringToWelcomeFile false

com.ibm.ws.webcontainer.RedirectWithPathInfo

Wenn die angegebene Umleitungsposition eine relative URL ohne führenden Schrägstrich ( / ) ist, entfernt der Server während der Konvertierung des Werts der relativen URL in eine absolute URL die pathInfo aus dem vorhandenen URI. Um sicherzustellen, dass die pathInfo beibehalten und nicht gelöscht wird, setzen Sie die Eigenschaft com.ibm.ws.webcontainer.RedirectWithPathInfo auf true.

Name Standardwert
com.ibm.ws.webcontainer.RedirectWithPathInfo false

com.ibm.ws.webcontainer.removeAttributeForNullObject

Standardmäßig kann die Methode getAttributeNames() einen Attributnamen zurückgeben, dessen Wert auf null gesetzt worden ist, wenn der Wert, der an die Methode ServletRequest.setAttribute() oder ServleContextt.setAttribute() übergeben wurde, ungültig ist. Dieses Standardverhalten stimmt nicht mit der API überein.

Soll der Web-Container das Attribut entfernen, wenn das Nullobjekt an die Methode ServletRequest.setAttribute() oder ServleContextt.setAttribute() übergeben wird, fügen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.removeAttributeForNullObject der Konfigurationseinstellungen des Web-Containers hinzu und legen Sie den Wert true für diese Eigenschaft fest.

Datentyp Standardwert
Boolean false

com.ibm.ws.webcontainer.returnDefaultContextPath

Verwenden Die die angepasste Eigenschaft com.ibm.ws.webcontainer.returnDefaultContextPath, damit der richtige Kontextpfad zurückgegeben wird, wenn eine Anwendung im Standardkontextstammverzeichnis installiert wird. Wird die Eigenschaft z. B. auf true gesetzt, wird der Kontextpfad für jede Anwendung, die im Standardkontextstammverzeichnis installiert wird, auf eine leere Zeichenfolge gesetzt.

Datentyp Standardwert
Boolean False

com.ibm.ws.webcontainer.searchMetaInfResourcesDuringAppStart

Verwenden Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.searchMetaInfResourcesDuringAppStart, um das erweiterte Feature zu inaktivieren, wenn Sie nach /META-INF/resources suchen.

Datentyp Standardwert
Boolean True

com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect

Diese Eigenschaft zeigt an, ob eine Antwort als Teil einer Anforderung vom Typ "sendRedirect" abgesetzt wird. Wenn für diese Eigenschaft der Wert true festgelegt ist, wird eine Antwort als Teil einer Anforderung vom Typ "sendRedirect" abgesetzt, und keine der Anforderung zugeordneten gesendeten Daten sind bei einer Rückgabe von sendRedirect zum Lesen verfügbar.

Der Standardwert ist "false".

Name Standardwert
com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect false

com.ibm.ws.webcontainer.SendResponseToClientWhenResponseIsComplete

Diese Eigenschaft zeigt an, ob eine Antwort bei der Rückgabe einer Anforderung vom Typ "forward" ausgeführt wird.

Wenn für diese Eigenschaft der Wert false festgelegt ist, wird bei der Rückgabe einer Anforderung vom Typ "forward" keine Antwort ausgeführt. Stattdessen wird die Antwort verschoben und erst abgesetzt, wenn die Zielressource ihren Verarbeitungsprozess abgeschlossen hat. Wenn die Anforderung vom Typ "forward" abgeschlossen ist, sind die gesendeten Daten zum Lesen verfügbar.

Name Standardwert
com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect true

com.ibm.ws.webcontainer.setAsyncDispatchRequestURI

Wenn Sie diese Eigenschaft auf true setzen, legt der Web-Container den aktuellen Anforderungs-URI als Ziel der asynchronen Zuteilung fest.

Name Standardwert
com.ibm.ws.webcontainer.setAsyncDispatchRequestURI false

com.ibm.ws.webcontainer.setcontenttypebysetheader

Wenn autoResponseEncoding aktiviert oder die Eigenschaft com.ibm.ws.webcontainer.contentTypeCompatibility gesetzt ist, legt der Anwendungsserver den Inhaltstyp der Antwort mit einer internen Methode fest. Wenn Sie die Einstellung des Inhaltstyps mit der Methode "ServletResponse.setContentType" aktivieren möchten, müssen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.setcontenttypebysetheader auf false setzen.

Name Standardwert
com.ibm.ws.webcontainer.setcontenttypebysetheader true

com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot

Wenn der Web-Container zum ersten Mal eine Anforderung nach einer statischen Begrüßungsseite, die keine JSP-Datei (JavaServer Pages) ist, verarbeitet, sucht er in der Regel nicht im Dokumentstammverzeichnis vom Typ ExtendedDocumentRoot nach der Begrüßungsdatei (Welcome), es sei denn, es wird eine vollständig qualifizierte Anforderung nach dieser Datei angegeben. Wenn eine vollständig qualifizierte Anforderung angegeben wird, stellt der Web-Container die Begrüßungsdatei bereit, und die Datei wird im Kontextstammverzeichnis der Anwendung angezeigt. Wird keine vollständig qualifizierte Anforderung nach der statischen Begrüßungsdatei angegeben, gibt der Web-Container den Fehler 404 zurück, der anzeigt, dass der Web-Container die Begrüßungsdatei nicht gefunden hat.

Nachdem der Web-Container eine Begrüßungsdatei erfolgreich bereitgestellt hat, erstellt er eine Zuordnung für diese Begrüßungsdatei. Anschließend verwendet der Web-Container diese Zuordnung, um künftige Anforderungen nach der Begrüßungsdatei zu verarbeiten, sodass für nachfolgende Anforderungen die Angabe als vollständig qualifizierte Anforderungen nicht mehr erforderlich ist.

Wenn der Web-Container immer in einem anwendungsdefinierten Dokumentstammverzeichnis vom Typ ExtendedDocumentRoot nach einer Begrüßungsdatei suchen soll, auch dann, wenn keine vollständig qualifizierte Anforderung gestellt wird, können Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot den Einstellungen des Web-Containers hinzufügen und den Wert true für diese Eigenschaft festlegen.

Name Standardwert
com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot false

com.ibm.ws.webcontainer.ServletDestroyWaitTime

Wenn eine Anwendung gestoppt wird, wartet der Web-Container standardmäßig bis zu 60 Sekunden auf die Fertigstellung jeder aktiven Anforderung für eine Ressource dieser Anwendung. Mit der angepassten Web-Container-Eigenschaft com.ibm.ws.webcontainer.ServletDestroyWaitTime können Sie jetzt steuern, wie lange der Web-Container auf die Fertigstellung einer aktiven Anforderung wartet, wenn die übergeordnete Anwendung gestoppt wird.

Setzen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.ServletDestroyWaitTime auf einen ganzzahligen Wert, der die Anzahl der Sekunden angibt, die der Web-Container auf die Fertigstellung einer Anforderung wartet. Der Standardwert ist 60 Sekunden.

Name Standardwert
com.ibm.ws.webcontainer.ServletDestroyWaitTime 60

com.ibm.ws.webcontainer.setUnencodedHTMLinsendError

Normalerweise verschlüsselt der Web-Container die angegebenen Fehlernachrichten, bevor er sie formatiert, um Cross-Site-Scripting-Attacken (XXS-Attacken) im Client zu verhindern, wenn die Anwendung diese Nachrichten nicht bereinigt. Die Java-Servletspezifikation für die Methode "sendError(int, String)" gibt jedoch an, dass der Server die Antwort so erstellen muss, dass sie wie eine in HTML formatierte Serverfehlerseite aussieht.

Wenn Sie nicht möchten, dass der Web-Container die angegebenen Fehlernachrichten vor der Formatierung verschlüsselt, fügen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.setUnencodedHTMLinsendError zu den Konfigurationseinstellungen des Web-Containers hinzu, und legen Sie den Wert true für diese Eigenschaft fest.

Name Standardwert
com.ibm.ws.webcontainer.setUnencodedHTMLinsendError false

com.ibm.ws.webcontainer.skipInputStreamReadOnError

Wenn diese Eigenschaft auf true gesetzt ist, beendet der Web-Container das Lesen der verbleibenden POST-Daten, wenn vor oder während der syntaktischen Analyse der POST-Daten eine Ausnahme ausgelöst wurde.

Die angepasste Eigenschaft com.ibm.ws.webcontainer.skipInputStreamReadOnError muss zusammen mit der auf true gesetzten angepassten Kanaleigenschaft preventRequestBodyPurge verwendet werden.

Name Standardwert
com.ibm.ws.webcontainer.skipInputStreamReadOnError false

com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing

Der Web-Container sucht je nach Anwendungskonfiguration in unterschiedlichen Positionen nach statischen Dateien und nach JSP-Dateien (JavaServer Pages). Ein Webfragment umfasst eine JAR-Datei im WEB-INF/lib-Verzeichnis einer Anwendung. Die JAR-Datei kann statische Ressourcen in einem META-INF/resources-Verzeichnis enthalten, die innerhalb der JAR-Datei definiert sind. Wenn Sie verhindern möchten, dass der Web-Container die META-INF/resources-Verzeichnisse durchsucht, setzen Sie die angepasste Web-Container-Eigenschaft com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing auf true.

Der Standardwert für diese angepasste Eigenschaft ist false.

Name Standardwert
com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing false

com.ibm.ws.webcontainer.suppressheadersinrequest

Die angepasste Eigenschaft com.ibm.ws.webcontainer.suppressheadersinrequest kann verwendet werden, um die Aufnahme von Headern zu underdrücken, die mit Sonderzeichen wie "$" oder "_" beginnen. Einige Anwendungen verarbeiten keine Anforderungsheader, die mit Sonderzeichen beginnen.

Der für diese angepasste Eigenschaft angegebene Wert ist eine Liste der zu unterdrückenden Headerpräfixe mit Begrenzern.

Beispiel:

com.ibm.ws.webcontainer.suppressheadersinrequest=$WS,_WS
Name Standardwert
com.ibm.ws.webcontainer.suppressheadersinrequest Ohne

com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput

Bei einem rekursiven Fehler, der von einer anwendungsspezifischen Fehlerseite nicht behandelt werden kann, werden der Stack-Trace und die Fehlernachricht als HTML-Seite ausgegeben. Diese Informationen enthalten Klassennamen und Programminformationen, die der Anwendungsentwickler dem Benutzer nicht anzeigen möchte.

Sie können die angepasste Web-Container-Eigenschaft com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput setzen, um die HTML-Ausgabe des Fehlertextes zu unterdrücken, ohne die interne Protokollierung der Nachricht zu ändern. Setzen Sie die angepasste Eigenschaft com.ibm.ws. webcontainer.suppressHtmlRecursiveErrorOutput auf true, um die HTML-Ausgabe der Fehlernachricht zu inaktivieren und dem Benutzer eine leere Seite mit dem Fehlercode 500 anzuzeigen.

Name Standardwert
com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput false

com.ibm.ws.webcontainer.suppressLastZeroBytePackage

Normalerweise wird der letzte Null-Byte-Block verwendet, um einem Client bei einer in Blöcke aufgeteilten Übertragung das Ende der Antwortdaten anzuzeigen. Einige Anwendungen verwenden diese letzte Null, um festzulegen, wann die Antwortdaten vollständig empfangen wurden und sie anfangen können, diese zu verarbeiten. Wenn in der Anwendung ein Fehler auftritt, nachdem die Antwortheader gesendet wurden, wird der letzte Datenblock trotzdem an den Client gesendet. Der Client erkennt möglicherweise nicht, dass ein Fehler aufgetreten ist, und versucht, unvollständige Daten zu verarbeiten.

Wenn Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.suppressLastZeroBytePackage auf den Wert true setzen, wird der letzte Datenblock nicht an den Client gesendet.

Name Standardwert
com.ibm.ws.webcontainer.suppressLastZeroBytePackage false

com.ibm.ws.webcontainer.suppressLoggingFileNotFoundExceptions

Wird eine fehlende Datei angefordert, generiert der Web-Container eine Nachricht über einen schwerwiegenden Fehler mit dem Stack-Trace FileNotFoundException in den JVM-Protokollen. Dies ist möglicherweise kein schwerwiegender Fehler, falls unbeabsichtigt eine falsche Datei angefordert wurde. Setzen Sie diese Eigenschaft auf true, damit in den JVM-Protokollen eine Warnnachricht anstatt eine Nachricht über einen schwerwiegenden Fehler generiert wird, wenn eine Datei nicht gefunden wird.

Name Standardwert
com.ibm.ws.webcontainer.suppressLoggingFileNotFoundExceptions false

com.ibm.ws.webcontainer.suppressLoggingWebGroupVhostNotFound

Setzen Sie diese Eigenschaft auf true, um die Ausgabe der Nachricht SRVE0255E in der Datei SystemOut.log zu unterdrücken.

Diese angepasste Eigenschaft wird nur für Zeichenfolgen ohne Platzhalterzeichen (*) unterstützt.

Name Standardwert
com.ibm.ws.webcontainer.suppressLoggingWebGroupVhostNotFound Ohne

com.ibm.ws.webcontainer.suppressServletExceptionLogging

Wenn ein Servlet eine Ausnahme erstellt, wird diese in der Systemkonsole protokolliert. Wenn Sie nicht möchten, dass der Web-Container vom Servlet erstellte Ausnahmen protokolliert, fügen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.suppressServletExceptionLogging den Konfigurationseinstellungen des Web-Containers hinzu, und legen Sie den Wert true für diese Eigenschaft fest.

Name Standardwert
com.ibm.ws.webcontainer.suppressServletExceptionLogging false

com.ibm.ws.webcontainer.throwMissingJspException

Setzen Sie die angepasste Eigenschaft "com.ibm.ws.webcontainer.throwMissingJspException" auf true, um eine Ausnahme vom Typ "FileNotFoundException" zu erstellen, wenn eine Ressource, die von einer JSP-Datei eingeschlossen wird, fehlt. Wenn für diese Eigenschaft nicht der Wert true festgelegt ist, wird eine Fehlerseite angezeigt.

Name Standardwert
com.ibm.ws.webcontainer.throwMissingJspException false

com.ibm.ws.webcontainer.throwpostconstructexception

Setzen Sie die angepasste Eigenschaft com.ibm.ws.webcontainer.throwpostconstructexception auf true, damit angepaste Fehlernachrichten an die Datei error.xhtml weitergegeben werden.

Hinweis zur Umstellung Hinweis zur Umstellung: Der Standardwert für diese angepasste Eigenschaft hat sich in Version 7.0 geändert. In Version 7.0 ist der Standardwert für diese Eigenschaft false.trns
Name Standardwert
com.ibm.ws.webcontainer.throwpostconstructexception true
[AIX]

com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles

Wenn die folgenden Codierungen nicht übereinstimmen, wird vom Web-Container möglicherweise ein Fehler vom Typ "FileNotFound 404" zurückgegeben, und die Anforderung wird nicht bedient:
  • Die Codierung des Dateisystems, in dem die Anwendung installiert ist.
  • Die Codierung des Dateinamens, die in einem Anforderungs-URL gesendet wird

Beispiel: Wenn ein DBCS-codierter Dateiname angefordert wird und das Dateisystem die Ländereinstellung "en_US" hat, die der Codierung "ISO-8859" entspricht, besteht keine Übereinstimmung.

Um dieses Problem zu beheben, legen Sie den Wert true für die angepasste Eigenschaft com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles fest. Wenn Sie diese angepasste Eigenschaft definieren, toleriert der Web-Container eine Abweichung zwischen den Codierungen des Dateisystems und des angeforderten Dateinamens. Dann beantwortet der Server die Anforderung einer gültigen Datei.

Name Standardwert
com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles false

com.ibm.ws.webcontainer.useOriginalRequestState

Wenn eine Anforderung überschrieben wird oder wenn die Anwendung die Schnittstelle ServletRequest implementiert, kann die Anwendung die Anforderung möglicherweise nicht bereitstellen, weil das überschriebene oder implementierte Anforderungsobjekt und nicht das Anforderungsobjekt für die Verarbeitung der Anforderung verwendet wird. Um sicherzustellen, dass das Anforderungsobjekt für die Verarbeitung der Anforderung verwendet wird, müssen Sie die angepasste Eigenschaft "com.ibm.ws.webcontainer.useOriginalRequestState" den Konfigurationseinstellungen des Web-Containers hinzufügen, und auf "true" setzen.

Name Standardwert
com.ibm.ws.webcontainer.useOriginalRequestState false

com.ibm.ws.webcontainer.useSemiColonAsDelimiterInURI

Wenn Sie diese Eigenschaft auf true setzen, ignoriert der Web-Container das Semikolon und alle nachfolgenden Zeichen beim Aufrufen von javax.servlet.http.HttpServletRequest.getPathInfo().

Name Standardwert
com.ibm.ws.webcontainer.useSemiColonAsDelimiterInURI false

com.ibm.ws.webcontainer.webgroupvhostnotfound

Die Fehlernachricht SRVE0017W gibt Folgendes an: "Webgruppe nicht gefunden: {0}", und die Fehlernachricht SRVE0255 gibt Folgendes an: "Es wurde weder eine Webgruppe noch ein virtueller Host für die Bearbeitung von {0} definiert". Diese Nachrichten können zurückgegeben werden, wenn die Anwendung, die zum Verarbeiten der von IBM WebSphere Application Server bearbeiteten Anforderung aufgerufen wird, nicht gefunden wird. Sie können die angepasste Eigenschaft com.ibm.ws.webcontainer.webgroupvhostnotfound verwenden, um den Text dieser Nachrichten so zu ändern, dass er für Ihre Umgebung besser geeignet ist.

Name Standardwert
com.ibm.ws.webcontainer.webgroupvhostnotfound

Ohne

com.ibm.ws.webcontainer.xPoweredBy

Mit dieser angepassten Eigenschaft können Sie den Wert des Headers "X-Powered-By", der die Implementierungsinformationen des Servers enthält, konfigurieren.

Name Standardwert
com.ibm.ws.webcontainer.xPoweredBy Servlet/3.0

com.ibm.wsspi.jsp.allowMultipleAttributeValues

Setzen Sie diese Eigenschaft auf true, damit der Web-Container mehrere Werte für ein angepasstes Tagattribut speichern kann.

Name Standardwert
com.ibm.wsspi.jsp.allowMultipleAttributeValues false

com.ibm.wsspi.jsp.convertAttrValueToString

Setzen Sie die angepasste Web-Container-Eigenschaft com.ibm.wsspi.jsp.convertAttrValueToString auf true, um Anfangs- und Endattribute für das Tag "repeat" in Zeichenfolgen zu konvertieren, bevor sie verwendet werden.

Name Standardwert
com.ibm.wsspi.jsp.convertAttrValueToString false

com.ibm.wsspi.jsp.disableElCache

Legen Sie den Wert true für die angepasste Web-Container-Eigenschaft "com.ibm.wsspi.jsp.disableElCache" fest, um den Cache für commons-el-Ausdrücke zu inaktivieren, wenn es zu abnormalen Speicherbedingungen kommt, weil die Hash-Tabellen vom Auswertungsprogramm für die Ausdrücke gesperrt werden.

Name Standardwert
com.ibm.wsspi.jsp.disableElCache false

com.ibm.wsspi.jsp.disableResourceInjection

Das Feature der Ressourceninjektion ruft die Ressourcen in Anwendungen anders auf als in früheren Versionen des Produkts und bewirkt, dass die kompilierte Methodenausgabe größer ist als früher. Wenn Sie große JSP-Dateien verwenden, die in früheren Releases den Grenzwert von 65535 Byte in den übersetzten Servicemethoden erreichten, kann es sein, dass diese Dateien den Grenzwert jetzt überschreiten und die Kompilierung scheitern lassen.

Wenn diese Situation eintritt, können Sie entweder eine große JSP-Datei in kleinere JSP-Dateien aufteilen und diese nach der Kompilierung mittels Anweisungen vom Typ <jsp:include> verbinden oder Sie können die angepasste Eigenschaft com.ibm.wsspi.jsp.disableResourceInjection Ihren Einstellungen des Web-Containers hinzufügen, um die Funktion der Ressourceninjektion während des Prozesses der JSP-Übersetzung zu inaktivieren. Wenn die angepasste Eigenschaft com.ibm.wsspi.jsp.disableResourceInjection auf den Wert true gesetzt wird, ist die Funktion der Ressourceninjektion für alle Anwendungen inaktiviert.

Wenn Sie die Funktion der Ressourceninjektion nur für bestimmte Anwendungen inaktivieren möchten, können Sie das JSP-Attribut "disableResourceInjection" zu den "ibm-web-ext.xmi"-Dateien für diese Anwendungen hinzufügen.

Name Standardwert
com.ibm.wsspi.jsp.disableResourceInjection false

com.ibm.wsspi.jsp.disableTldSearch

Die angepasste Eigenschaft "com.ibm.wsspi.jsp.disableTldSearch" kann verwendet werden, um die Startzeit von Anwendungen zu verbessern. Wenn eine Anwendung gestartet wird, durchsucht die JSP-Engine die Installationsverzeichnisse der Anwendung standardmäßig nach den TLD-Dateien (Taglib Descriptor, Deskriptor für Tag-Bibliotheken). Dieser Suchprozess kann die Startzeit für große Anwendungen mit sehr vielen Dateien und Verzeichnissen verlängern. Zum Inaktivieren dieses Suchprozesses setzen Sie diese Eigenschaft auf true.

Name Standardwert
com.ibm.wsspi.jsp.disableTldSearch false

com.ibm.wsspi.jsp.enabledoublequotesdecoding

Setzen Sie die angepasste Web-Container-Eigenschaft com.ibm.wsspi.jsp.enabledoublequotesdecoding, um ein codiertes Anführungszeichen, sofern es in einer Scriptfunktion in einer JSP-Datei eingebettet ist, zu decodieren.

Bei der Übersetzung einer JSP-Datei decodiert der JSP-Container keine codierten Anführungszeichen. Die Decodierung muss vom Browser durchgeführt werden. Allerdings ist der Browser nicht in der Lage, ein codiertes Anführungszeichen, das in der Scriptfunktion eines Tags enthalten ist, zu decodieren. Wird diese angepasste Eigenschaft also nicht gesetzt, bewirkt das codierte Anführungszeichen eine Fehlfunktion der Scriptfunktion.

Wenn Sie diese angepasste Eigenschaft setzen, wirkt sich der gesetzte Wert auf alle implementierten Anwendungen aus. Wenn Sie nur eine bestimmte Anwendung ansprechen möchten, legen Sie in der Datei ibm-web-ext.xmi in Ihrer Anwendung den Wert true für das JSP-Attribut enableDoubleQuotesDecoding fest.

Name Standardwert
com.ibm.wsspi.jsp.enabledoublequotesdecoding false

com.ibm.wsspi.jsp.removexmlnsfromoutput

Wenn der Web-Container HTML-Code aus einem JSP-Dokument generiert, entfernt er keine xmlns-Attribute, die für Tags im JSP-Dokument angegeben sind. Bei der Wiedergabe des JSP-Dokuments im Browser, verbleiben die xmlns-Attribute deshalb im generierten HTML-Code.

Um sicherzustellen, dass die xmlns-Attribute aus generiertem HTML-Code entfernt werden, fügen Sie den Konfigurationseinstellungen Ihres Web-Containers die angepasste Eigenschaft "com.ibm.wsspi.jsp.removexmlnsfromoutput" mit dem Wert true hinzu.

Wenn Sie diese angepasste Eigenschaft setzen, wirkt sich der gesetzte Wert auf alle implementierten Anwendungen aus. Wenn Sie nur eine bestimmte Anwendung ansprechen möchten, legen Sie in der Datei ibm-web-ext.xmi in Ihrer Anwendung den Wert true für das JSP-Attribut removeXmlnsFromOutput fest.

Name Standardwert
com.ibm.wsspi.jsp.removexmlnsfromoutput false
[z/OS]

ConnectionResponseTimeout

Verwenden Sie die Eigenschaft ConnectionResponseTimeout, um festzulegen, wie lange (in Sekunden) der Server maximal auf eine Antwort einer Anwendungskomponente auf eine HTTP-Anforderung wartet. Setzen Sie diese Variable für alle Definitionen des HTTP-Transportkanals auf dem Server. Sie müssen diese Eigenschaft für den SSL-Transport und den Nicht-SSL-Transport definieren. Wenn die Antwort nicht im angegebenen Zeitraum empfangen wird, wird der Servant möglicherweise mit ABEND-Signal EC3 und RSN=04130007 abnormal beendet. Wenn Sie diesen Zeitgeber definieren, müssen Clientanwendungen nicht mehr auf eine Antwort von einer Anwendungskomponente warten, die möglicherweise gesperrt ist, eine Schleife bildet oder andere Verarbeitungsfehler aufweist, die eine Blockierung der Anwendungskomponente bewirken.

Verwenden Sie die angepassten Servereigenschaften "protocol_http_timeout_output_recovery" und "protocol_https_timeout_output_recovery", um die Wiederherstellungsaktion anzugeben, die ausgeführt werden soll, wenn die zulässigen Zeitlimits für Anforderungen, die per HTTP oder HTTPS empfangen werden, überschritten werden.

Information Wert
Datentyp Integer
Standardwert 300 Sekunden
[AIX Solaris HP-UX Linux Windows][IBM i]

DebugSessionCrossover

Mit der angepassten Eigenschaft DebugSessionCrossover wird Code aktiviert, der durch zusätzliche Prüfungen sicherstellt, dass nur die Sitzung, die der Anforderung zugeordnet ist, aufgerufen oder referenziert wird. Wenn Diskrepanzen ermittelt werden, werden Nachrichten protokolliert.

Anmerkung: Die Verwendung der Eigenschaft DebugSessionCrossover als angepasste Eigenschaft für den Web-Container ist veraltet. Sie können diese Eigenschaft jetzt als angepasste Eigenschaft für die Sitzungsverwaltung definieren.

Setzen Sie diese Eigenschaft auf true, um die Crossover-Erkennung von Sitzungsdaten zu aktivieren:

Name Standardwert
DebugSessionCrossover false

Weitere Informationen finden Sie im Artikel zu den Problemen bei HTTP-Sitzungen.

DecodeUrlAsUTF8

Das Feature für in UTF-8 codierte URLs, das UTF-8-codierte Uniform Resource Locator (URLs) für die Unterstützung von Doppelbytezeichen in URLs verwendet, ist standardmäßig aktiviert. Sie können verhindern, dass der Web-Container URLs explizit in UTF-8 decodiert, und gemäß der aktuellen HTTP-Spezifikation die Verwendung von ISO-8859 als Standard festlegen, indem Sie diese angepasste Eigenschaft auf false setzen.

Name Standardwert
DecodeUrlAsUTF8 true

DisableMultiThreadedServletConnectionMgmt

Verwenden Sie diese Eigenschaft, damit Verbindungen in servletübergreifend wiederverwendet werden können. Gehen Sie wie folgt vor, eine angepasste Web-Container-Eigenschaft über die Administrationskonsole zu verwenden:
  1. Klicken Sie auf Anwendungsserver > Servername > Web-Container > Angepasste Eigenschaften.
  2. Erstellen Sie die Eigenschaft DisableMultiThreadedServletConnectionMgmt und setzen Sie ihren Wert auf true.

Wenn diese Eigenschaft aktiviert ist, die Verbindungskennung nicht geschlossen ist und das Servlet beendet wird, parkt der Web-Container (als Teil von postinvoke) die Verbindung und schließt die Verbindungskennung nicht.

Name Standardwert
DisableMultiThreadedServletConnectionMgmt false

com.ibm.ws.webcontainer.denyDuplicateFilterinChain

Wenn der URI einer eingehenden Anforderung mehreren URL-Filterzuordnungen zugeordnet ist, wird die Filterkette mehrmals mit demselben Filter aktualisiert. Dies führt dazu, dass der Filter für denselben URI mehrmals aufgerufen wird. Wenn Sie Ihren Einstellungen des Web-Containers die angepasste Eigenschaft "denyDuplicateFilterinChain" hinzufügen und diese Eigenschaft auf true setzen, wird der Filterkette kein Filter hinzugefügt, falls der Filter bereits in dieser Kette vorhanden ist.

Name Standardwert
com.ibm.ws.webcontainer.denyDuplicateFilterinChain false

enableInProcessConnections

Verwenden Sie die angepasste Eigenschaft enableInProcessConnections, um die Antwortzeiten und die Anzahl der Threads zu verringern, die für die Verarbeitung einer Anforderung verwendet werden. Auf diese Weise kann das Risiko von Deadlocks gemindert werden.

Es gibt einen optimierten Kommunikationspfad zwischen einer Web-Service-Clientanwendung und einem Web-Container, die beide im selben Anwendungsserverprozess angeordnet sind. Anforderungen vom Web-Service-Client, die normalerweise mit einer Netzverbindung an den Web-Container gesendet werden, werden über einen optimierten lokalen Pfad direkt an den Web-Container gesendet. Der lokale Pfad ist verfügbar, weil die Web-Service-Clientanwendung und der Web-Container im selben Prozess ausgeführt werden. Dieser optimierte Kommunikationspfad ist standardmäßig inaktiviert. Vergewissern Sie sich, bevor Sie diese Eigenschaft aktivieren, dass für die Web-Container-Ports keine Platzhalter angegeben sind. Sie müssen für den Web-Container spezifische Ports verwenden, wenn der optimierte Kommunikationspfad aktiviert ist.

Setzen Sie zum Aktivieren des optimierten Kommunikationspfads diese Eigenschaft auf true.

Name Standardwert
enableInProcessConnections false

Weitere Informationen finden Sie im Artikel zur optimierten Kommunikation zwischen dem Web-Service-Client und dem Web-Container.

Fehler vermeiden Fehler vermeiden: In einigen Web-Service-Anwendungen ist keine sichere gemeinsame Nutzung von Threads möglich. Wenn Fehler auftreten, setzen Sie die JVM-Eigenschaft jaxws.useSafeIPC auf true.gotcha

fileServingEnabled, directoryBrowsingEnabled und serveServletsByClassnameEnabled

"fileServingEnabled", "directoryBrowsingEnabled" und ähnliche Eigenschaften sind globale Einstellungen für interne Servlets. WAR-Dateien (Web Archive), die mit Tools von Fremdanbietern gepackt werden, können kein Verhalten für die Services angeben, die von den internen Servlets des Web-Containers bereitgestellt werden.

Sie können die Eigenschaften "fileServingEnabled", "directoryBrowsingEnabled" und "serveServletsByClassnameEnabled" verwenden, um die fileServing-, directoryBrowsing- und serveServletsByClassname-Funktionen für interne Servlets für alle Webanwendungen auf Web-Container-Ebene global zu aktivieren und zu inaktivieren.
  • Wenn Sie die Eigenschaft "fileServingEnabled" auf false setzen, wird die fileServing-Funktion inaktiviert.
  • Wenn Sie die Eigenschaft "directoryBrowsingEnabled" auf true setzen, wird die directoryBrowsing-Funktion aktiviert.
  • Wenn Sie die Eigenschaft "serveServletsByClassnameEnabled" auf true setzen, wird die serveServletsByClassnameEnabled-funktion aktiviert.
Name Standardwert
fileServingEnabled true
directoryBrowsingEnabled false
serveServletsByClassnameEnabled false

Einstellungen, die in einem Assembliertool definiert sind, haben Vorrang vor den globalen Einstellungen, die über angepasste Eigenschaften auf Web-Container-Ebene definiert werden.

Die Implementierungserweiterungen der Webanwendung enthalten weiterhin Konfigurationsdaten für die Services, die von internen Servlets bereitgestellt werden, und haben Vorrang vor den globalen Einstellungen, die über die angepassten Eigenschaften auf Web-Container-Ebene definiert werden.

ForceSessionIdLengthCheck

Neu generierte Sitzungs-IDs sind standardmäßig 23 Zeichen lang, sofern Sie mit der angepassten Eigenschaft "HttpSessionIdLength" keine andere maximale Länge für Ihre Sitzungs-IDs festlegen.

Wenn eine eingehende Anforderung eine Sitzungs-ID hat, die länger ist als die erwartete Sitzungs-ID-Länge und deren Präfix mit einer bereits vorhandenen Sitzungs-ID übereinstimmt, wird die längere ID verwendet, um eine neue Sitzung zurückzugeben. Falls der Wert für die Länge der Sitzungs-ID in der eingehenden Anforderung größer ist als der Wert für die maximale Länge, der für Ihr System definiert ist, sodass beispielsweise die Breite der Spalte "ID" in der Sitzungstabelle überschritten wird, die in der Datenbankpersistenz verwendet wird, wird ein Fehler vom Typ SQL0302 ausgegeben.

Um diese SQL0302-Fehler zu verhindern, können Sie den angepassten Eigenschaften Ihres Web-Containers die angepasste Eigenschaft "ForceSessionIdLengthCheck" mit dem Wert true hinzufügen. Wenn Sie diese angepasste Eigenschaft auf "true" setzen, darf eine Sitzungs-ID maximal 23 Zeichen lang sein. Wenn eine eingehende Anforderung eine Sitzungs-ID hat, die länger ist als 23 Zeichen, werden die ersten 23 Zeichen verwendet, um eine neue Sitzung zurückzugeben.

Name Standardwert
ForceSessionIdLengthCheck false

ForceSessionInvalidationMultiple

Die angepasste Eigenschaft "ForceSessionInvalidationMultiple" zeigt an, ob der Sitzungsmanager ohne Zeitlimit auf die Ausführung einer Anforderung warten soll, bevor er versucht, die Sitzung zu invalidieren, oder ob er versuchen soll, nach Ablauf des angegebenen Zeitlimits eine Sitzung zu invalidieren.

  • Wenn Sie den Wert "0" (Null) für diese angepasste Eigenschaft angeben, wartet der Sitzungsmanager ohne Zeitlimit, bis eine Anforderung abgeschlossen ist, bevor er versucht, die Sitzung zu invalidieren.

    Wenn Ihre Anforderungen normalerweise nicht durch ein Zeitlimit für Anforderungen beschränkt sind, sollten Sie "0" für diese Eigenschaft angeben.

  • Geben Sie eine positive Ganzzahl für diese angepasste Eigenschaft an, wie z. B. 1, 2 oder 3, versucht der Sitzungsmanager, selbst wenn er keine Information darüber hat, ob eine Sitzung abgeschlossen ist, die Sitzung zu invalidieren, wenn der angegebene Zeitraum seit dem letzten Zugriff verstrichen ist. Dieser Zeitraum ergibt sich aus der Multiplikation des für diese Eigenschaft angegebenen Werts und des für die Eigenschaft "SessionTimeout" (Sitzungszeitlimit) angegebenen Werts. Wenn Sie z. B. 2 Minuten für die Eigenschaft "SessionTimeout" und 2 Minuten für die Eigenschaft "ForceSessionInvalidationMultiple" angeben, versucht der Sitzungsmanager nach 4 Minuten, die Sitzung zu inaktivieren.

    Wenn Sie Ihre Sitzungen invalidieren möchten, nachdem ein bestimmter Zeitraum verstrichen ist, geben Sie die positive Ganzzahl für diese Eigenschaft an.

Name Standardwert
ForceSessionInvalidationMultiple 1

httpsIndicatorHeader

Die angepasste Eigenschaft "httpsIndicatorHeader" verwaltet HTTPS-Anforderungen, die von einem SSL-Offloader, der WebSphere Application Server vorgelagert ist, an einen Anwendungsserver weitergeleitet werden. Wenn ein SSL-Offloader eine HTTPS-Anforderung empfängt, wird diese über HTTP an einen Anwendungsserver von WebSphere Application Server umgeleitet. Der SSL-Offloader muss so konfiguriert sein, dass er einen speziellen Header hinzufügt, in dem angegeben ist, dass die ursprüngliche Anforderung über HTTPS erfolgt ist. Die Eigenschaft "httpsIndicatorHeader" gibt den Headerschlüsselnamen an, der vom SSL-Offloader hinzugefügt wird. Der Anwendungsserver prüft diesen Anzeiger, um festzustellen, ob SSL erforderlich ist. Wenn er feststellt, dass die Anforderung eine SSL-over-HTTP-Anforderung ist, wird ein HTTPS-Schema ausgewählt.

Name Standardwert
httpsIndicatorHeader Ohne

HttpSessionIdReuse

Die angepasste Eigenschaft "HttpSessionIdReuse" bestimmt, ob der Sitzungsmanager die von einem Browser gesendete Sitzungs-ID verwenden kann, um die Sitzungsdaten für mehrere Webanwendungen aufzubewahren, die in einer Umgebung konfiguriert sind, in der die Sitzungspersistenz nicht konfiguriert ist. Wenn Sie diese Eigenschaft in einer Umgebung mit mehreren JVMs, in der die Sitzungspersistenz nicht konfiguriert ist, auf true setzen, kann der Sitzungsmanager dieselben Sitzungsdaten für alle Anforderungen eines Benutzers verwenden, selbst wenn die Webanwendungen, die diese Anforderungen bearbeiten, von unterschiedlichen JVM-Dateien gesteuert werden. Der Standardwert für diese Eigenschaft ist false.

Anmerkung: Die Verwendung der Eigenschaft "HttpSessionIdReuse" als angepasste Eigenschaft für den Web-Container ist veraltet. Sie müssen diese Eigenschaft jetzt als angepasste Eigenschaft für die Sitzungsverwaltung definieren.

Setzen Sie diese Eigenschaft auf true, um anzugeben, dass der Sitzungsmanager die von einem Browser gesendete Sitzungs-ID verwenden soll, um die Sitzungsdaten für mehrere Webanwendungen aufzubewahren, die in einer Umgebung konfiguriert sind, in der die Sitzungspersistenz nicht konfiguriert ist.

Name Standardwert
HttpSessionIdReuse false

Listener

Die Servletspezifikation unterstützt Anwendungen, die Listener für servletbezogene Ereignisse über den Deskriptor web.xml auf Anwendungsbasis registrieren. Wenn Sie jedoch die angepasste Eigenschaft "listeners" verwenden, kann der Server Servletereignisse in Webanwendungen überwachen.

Zur Implementierung der globalen Überwachung wird ein Listener auf Web-Container-Ebene registriert und an alle installierten und neuen Anwendungen verteilt. Dieses globale Verhalten interner Servlet-Listener wird mit der angepassten Eigenschaft "listeners" gesteuert. Verwenden Sie das folgende Format für das Name/Wert-Paar.
listeners=Listenerklasse
Name Standardwert
Listener Ohne

Der Wert für diese Eigenschaft ist eine Zeichenfolge, die eine durch Kommas getrennte Liste mit Listenerklassen darstellt. Der angegebene Listener muss Standardlistenerklassen aus der Java Servlet API oder Erweiterungsklassen für IBM Listener implementieren.

[z/OS]

MutualAuthCBindCheck

Diese Eigenschaft ist nur für die Plattform z/OS gültig. Mit der Eigenschaft "MutualAuthCBindCheck" geben Sie an, ob ein Clientzertifikat in einen SAF-Principal aufgelöst werden soll.

Mit der Eigenschaft "MutualAuthCBindCheck" geben Sie an, ob ein Clientzertifikat in einen SAF-Principal aufgelöst werden soll. Wenn diese Eigenschaft auf true gesetzt ist, müssen alle von einem Browser ausgehenden SSL-Verbindungen ein Clientzertifikat haben. Außerdem muss die Benutzer-ID, die diesem Clientzertifikat zugeordnet ist, die Berechtigung RACF CONTROL für CB.BIND.servername haben. Falls diese Bedingungen nicht erfüllt sind, wird die Verbindung geschlossen, unabhängig davon, ob die Clientzertifikatsauthentifizierung in einer SSL-Verbindung verwendet wird oder nicht. Setzen Sie den folgenden RACF-Befehl ab, um der Benutzer-ID, die dem Clientzertifikat zugeordnet ist, die Berechtigung RACF CONTROL zu erteilen:

PERMIT CB.BIND.<optionales Präfix für SAF-Profile>.clustername CLASS(CBIND) ID(clientCertUserid) ACCESS(CONTROL)
Name Standardwert
MutualAuthCBindCheck false

prependSlashToResource

WebSphere Application Server 5.x unterstützt Uniform Resource Locators (URLs) ohne führende Schrägstriche ( / ). Zur Bewahrung der Kompatibilität können Sie diese angepasste Eigenschaft auf true setzen. Wenn Sie diese Eigenschaft auf true setzen, ignoriert der Web-Container die Spezifikation und berücksichtigt URLs ohne den führenden Schrägstrich und verwendet das folgene Name/Wert-Paar.

Name Standardwert
prependSlashToResource false

com.ibm.ws.webcontainer.suppressLoggingServiceRuntimeExcep

Sie können diese Eigenschaft verwenden, um die Aufzeichnung einer RuntimeException zu unterdrücken, die während der Ausführung eines Servlets auftritt.

Standardmäßig protokolliert der Web-Container die Ausnahmebedingung vom Typ "RuntimeException" in den JVM-Protokollen, wenn die Ausnahmebedingung während der Ausführung eines Servlets auftritt. Wenn diese Eigenschaft auf true gesetzt ist, protokolliert der Web-Container keine RuntimeException, die während der Ausführung eines Servlets auftritt.

Fehler vermeiden Fehler vermeiden: Wenn Sie diese Eigenschaft auf true setzen, wird nur die Protokollierung von Ausnahmebedingungen vom Typ "RuntimeException" unterdrückt. Der Wert true löst keine Ausnahmebedingungen an den Caller aus. gotcha
Name Standardwert
com.ibm.ws.webcontainer.suppressLoggingServiceRuntimeExcep false

trusted

Die angepasste Eigenschaft "trusted" ermöglicht, dass der Anwendungsserver ankommende private Header aus dem Web-Server-Plug-in verwendet. Diese ankommenden privaten Header benachrichtigen den Anwendungsserver über die Verbindung zum Web-Server. Wenn Sie die angepasste Eigenschaft auf den Wert true setzen, verwendet der Anwendungsserver die zugesicherten Informationen in den Clientzertifikaten. Diese Clientzertifikate werden vom Benutzer verwendet, um eine Verbindung zum Web-Server herzustellen und die Clientinformationen anzugeben, die als Zertifikat für den Endbenutzer behandelt werden. Anschließend verwendet der Anwendungsserver die Zertifikatsinformationen für Authentifizierungszwecke, wenn die Clientzertifikatsauthentifizierung verwendet wird oder wenn der Anwendungscode auf die Zertifikate vom Typ "javax.net.ssl.peer_certificates" zugreift. Da diese Informationen zugesichert werden, sind sie nicht sicher und potenziell gefährdet durch Angreifer, die unter Umgehung des Web-Servers eine direkte Verbindung zum Anwendungsserver herstellen können.

Wichtig: Wenn Sie direkte Verbindungen zum Anwendungsserver ermöglichen und Clientzertifikate verwenden, müssen Sie diese angepasste Eigenschaft auf den Wert false setzen.
Name Standardwert
trusted true
[AIX Solaris HP-UX Linux Windows]

UseOracleBLOB

Die angepasste Eigenschaft "UseOracleBLOB" erstellt die Datenbanktabelle für HTTP-Sitzungen mit dem Datentyp "BLOB" (Binary Large Object) für die mittlere Spalte. Diese Eigenschaft verbessert die Leistung persistenter Sitzungen, wenn Oracle-Datenbanken verwendet werden.

Aufgrund einer Oracle-Einschränkung erfordert die BLOB-Unterstützung für mehr als 4000 Datenbytes die Verwendung des OCI-Datenbanktreibers. Außerdem müssen Sie sicherstellen, dass eine neue Sitzungstabelle erstellt wird, bevor der Server erneut gestartet wird. Dazu muss die alte Sitzungstabelle gelöscht oder die Datenquellendefinition so geändert werden, dass sie auf eine Datenbank verweist, die keine Sitzungstabelle enthält.

Setzen Sie zum Erstellen einer Sitzungstabelle mit dem Datentyp BLOB diese Eigenschaft auf true.

Anmerkung: Die Verwendung der Eigenschaft "UseOracleBLOB" als angepasste Eigenschaft für den Web-Container ist veraltet. Sie müssen diese Funktion jetzt als angepasste Eigenschaft für die Sitzungsverwaltung definieren.
Name Standardwert
UseOracleBLOB false
[AIX Solaris HP-UX Linux Windows]

setContentLengthOnClose

Auswählen, ob die Inhaltslänge gesetzt werden soll, wenn eine Anwendung die Antwort explizit schließt.

Der empfohlene Standardwert ist true. Geben Sie aber als Wert false an, wenn eine Anwendungsantwort Doppelbytezeichen enthält.

Name Standardwert
setContentLengthOnClose true

com.ibm.ws.webcontainer.servlet30compatibility

Wenn diese angepasste Eigenschaft auf true gesetzt ist, werden für Servlet 3.1 vorgenommene Verhaltensänderungen auf das folgende Servlet 3.0-Verhalten zurückgesetzt:

  • Wenn Sie AsyncContext.getRequest() oder AsyncContext.getResponse() nach AsyncContext.dispatch() oder AsyncContext.complete() aufrufen, löst der Server keine Ausnahme des Typs "IllegalStateException" aus.
  • Wenn Sie ServletResponse.reset() aufrufen, wird der Status der aufrufenden Methode getWriter() oder getOutputStream() nicht gelöscht.
  • Wenn Sie die folgenden ServletContext-Methoden aufrufen, löst der Server keine Ausnahme des Typs "UnsupportedOperationException" aus:
    • ServletContext.getClassLoader()
    • ServletContext.getEffectiveMajorVersion()
    • ServletContext.getEffectiveMinorVersion()
    • ServletContext.getFilterRegistration()
    • ServletContext.getFilterRegistrations()
    • ServletContext.getServletRegistration()
    • ServletContext.getServletRegistrations()
    • ServletContext.declareRoles()
    • ServletContext.getVirtualServerName()
  • Der Web-Container stoppt die Registrierung eines Servlets mit doppelter URL-Zuordnung nicht. Eine vorhandene Anwendung wird normal gestartet. Die Implementierung einer neuen Anwendung mit Konflikten bei mehreren Servlets, die demselben URL-Muster zugeordnet sind, schlägt aber weiterhin fehl.
  • Der für die angepasste Web-Container-Eigenschaft com.ibm.ws.webcontainer.RedirectWithPathInfo festgelegte Wert wird nicht ignoriert.
  • Wenn ein Servlet eine E/A-Ausnahme (IOException) auslöst und für die Anforderung ein Filter konfiguriert ist, löst der Web-Container eine Servletausnahme (ServletException) aus.

Der Standardwert und der empfohlene Wert ist false. Sie können aber auch den Wert true festlegen, um eine Zurücksetzung auf das 3.0-Verhalten zu erreichen.

Name Standardwert
com.ibm.ws.webcontainer.servlet30compatibility false

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



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