Konfigurationsparameter der JSF-Engine

In WebSphere Application Server können Sie die Parameter der JSF-Engine (JavaServer Faces) in einer Produktionsserverumgebung und in einer Entwicklungsumgebung konfigurieren, um eine optimale Leistung zu erzielen.

Bei den Parametern für die JSF-Engine wird zwischen Groß-/Kleinschreibung unterschieden. Wenn der für einen Parameter angegebene Wert zwei oder mehr durch Leerzeichen voneinander getrennte Wörter enthält, müssen Sie den Wert in Anführungszeichen setzen.

JSF-Optionen für MyFaces

Tabelle 1. JSF-Optionen für MyFaces. Die folgende Tabelle enthält Parameternamen, Beschreibungen und Standardwerte für JSF:
Parametername in JSF Beschreibung Standardwert
org.apache.myfaces.PRETTY_HTML Wenn Sie diesen Parameter auf "true" setzen, wird der zurückgegebene Wert so formatiert, dass er lesbar ist. Es werden zusätzliche Zeilentrennzeichen und Leerzeichen eingefügt, die den HTML-Code nicht beeinflussen. true
org.apache.myfaces.ALLOW_JAVASCRIPT Dieser Parameter teilt MyFaces mit, ob JavaScript-Code in der wiedergegebenen HTML-Ausgabe zulässig ist. Wenn JavaScript zulässig ist, enthalten command_link-Anker JavaScript-Code, der das entsprechende Format übermittelt. Ist JavaScript nicht zulässig, werden die Informationen zur Statusspeicherung und die verschachtelten Parameter als URL-Parameter hinzugefügt. true
org.apache.myfaces.DETECT_JAVASCRIPT   false
org.apache.myfaces.AUTO_SCROLL Wenn Sie diesen Parameter auf "true" setzen, wird eine JavaScript-Funktion bereitgestellt, die das frühere vertikale Blättern für jede Anforderung wiederherstellen kann. Dieses Feature ist hilfreich, wenn Sie Seiten mit sehr langen Listen haben und nicht möchten, dass die Browserseite an den Anfang der Seite springt, wenn Sie einen Link oder eine Browseraktion auslösen, die auf derselbe Seite bleibt. false
org.apache.myfaces.ADD_RESOURCE_CLASS   org.apache.myfaces.renderkit.html.util.DefaultAddResource
org.apache.myfaces.CHECK_EXTENSIONS_FILTER Dieser Parameter sucht nach einem ordnungsgemäß formatierten Extensions-Filter, wenn dieser von der Webanwendung benötigt wird. true
org.apache.myfaces.COMPRESS_STATE_IN_SESSION Setzen Sie diese Option auf true, um den serialisierten Status zu komprimieren, bevor er in die Sitzung geschrieben wird. Wenn Sie diese Option auf false setzen, wird der Status nicht komprimiert. Diese Option ist nur gültig, wenn die Methode für die Statusspeicherung auf "Server" und org.apache.myfaces.SERIALIZE_STATE_IN_SESSION auf true gesetzt ist. true
org.apache.myfaces.DISABLE_FLASH_SCOPE Setzen Sie diesen Kontextparameter auf true, um den Flash-Bereich zu inaktivieren, was zur Folge hat, dass das Cookie nicht gesendet wird. false
org.apache.myfaces.NUMBER_OF_VIEWS_IN_SESSION Definiert die Anzahl letzter Sichten, die in der Sitzung gespeichert werden. Diese Option ist nur gültig, wenn die Methode für die Statusspeicherung auf "Server" eingestellt ist. 20
org.apache.myfaces.READONLY_AS_DISABLED_FOR_SELECTS   true
org.apache.myfaces.SERIALIZE_STATE_IN_SESSION Setzen Sie diese Option auf true, um den Status in einen Bytestrom zu serialisieren, bevor er in die Sitzung geschrieben wird. Wenn Sie diese Option auf false setzen, wird der Status nicht in einen Bytestrom serialisiert. Diese Option ist nur gültig, wenn die Methode für die Statusspeicherung auf "Server" eingestellt ist. true
org.apache.myfaces.STRICT_JSF_2_CC_EL_RESOLVER Mit diesem Parameter wird sichergestellt, dass beim Aufruf von getType() über den Quellen-EL-Ausdruck die Komponenten, die verkettete EL-Ausdrücke verwenden, die mit composite:attribute hinzugefügten Metadaten verwenden können. Wird diese Eigenschaft auf true gesetzt, wird diese Funktion inaktiviert. false

org.apache.el.parser.COERCE_TO_ZERO

Erlaubt der Ausdruckssprache, die von WebSphere Application Server verwendet wird, für Nullwerte und ganzzahlige Werte mit leeren Zeichenfolgen den Wert "0" zu erzwingen. Diese Erlaubnis kann mit demselben Parameter auch verweigert werden, was zur Folge hat, dass Nullwerte und ganzzahlige Werte mit leeren Zeichenfolgen bestehen bleiben. Der Standardwert ist true und ermöglicht es, für einen Nullwert oder einen ganzzahligen Wert mit leerer Zeichenfolge den Wert "0" zu erzwingen.
Wichtig: Wenn für einen Nullwert nicht der Wert "0" in einer MyFaces-Anwendung erzwungen werden soll, muss der folgende Kontextparameter in der Datei web.xml der Anwendung gesetzt werden. Damit wird sichergestellt, dass für keine gültigen Instanzen eines Nullwerts oder einer leeren Zeichenfolge der Wert "0" erzwungen wird.
<context-param>
		<param-name>javax.faces.
		INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL
		</param-name>
	<param-value>true</param-value>
</context-param>
Sie setzen die Eigenschaft org.apache.el.parser.COERCE_TO_ZERO mit der Administrationskonsole.
  1. Erweitern Sie Server und wählen Sie WebSphere-Anwendungsserver aus. Klicken Sie in der Liste auf den gewünschten Server.
  2. Klicken Sie unter "Serverinfrastruktur" auf "Java- und Prozessverwaltung > Prozessdefinition".
  3. Klicken Sie unter "Weitere Eigenschaften" auf "Java Virtual Machine".
  4. Klicken Sie unter "Weitere Eigenschaften" auf "Angepasste Eigenschaften".
  5. Klicken Sie auf Neu, und fügen Sie die Eigenschaft org.apache.el.parser.COERCE_TO_ZERO mit dem Wert false hinzu, wenn Sie nicht möchten, dass für einen Nullwert nicht der Wert "0" erzwungen wird.
  6. Klicken Sie auf Speichern, um die Änderung zu speichern, und starten Sie WebSphere Application Server erneut, um sicherzustellen, dass die Änderung übernommen wird.

true

org.apache.myfaces.DEBUG_PHASE_LISTENER Aktiviert den DebugPhaseListener während der Phase der Projektentwicklung. true

com.ibm.ws.jsf.disablealternatefacesconfigsearch

Inaktiviert die Suche nach "META-INF/*.faces-config.xml" in MyFaces ausschließlich für die Webanwendung, für die dieser Kontextparameter definiert ist. Wenn der Kontextparameter und die angepasste Eigenschaft des Web-Containers festgelegt sind, hat der Kontextparameter eine höhere Priorität.

false

Allgemeine JSF-Optionen

Tabelle 2. JSF-Optionen. Die folgende Tabelle enthält Parameternamen, Beschreibungen und Standardwerte für jede JSF-Implementierung:
Parametername in JSF Beschreibung Standardwert
javax.faces.STATE_SAVING_METHOD Gibt die Position an, an der Statusinformationen gespeichert werden. Die gültigen Wert sind "server" (Speicherung in der HTTP-Sitzung) und "Client" (Speicherung als verdecktes Feld im Formular). server
javax.faces.CONFIG_FILES Verwenden Sie diesen Parameter, um eine durch Kommas begrenzte Liste kontextbezogener Konfigurationsressourcen anzugeben, unter denen die JSF-Implementierung nach Konfigurationsressourcen für die Anwendung sucht, bevor sie eine Konfigurationsressource mit dem Namen /WEB-INF/facesconfig.xml lädt, sofern eine solche Ressource vorhanden ist. Nicht zutreffend
javax.faces.DEFAULT_SUFFIX Gibt das Standardsuffix für Ressourcen für Erweiterungen an, die JSF-Komponenten enthalten. .jsp
javax.faces.LIFECYCLE_ID Verwenden Sie diesen Parameter, um eine alternative Lebenszyklus-ID zu konfigurieren. Nicht zutreffend
com.ibm.ws.jsf.JSF_IMPL_CHECK Gibt an, dass die JSP-Dateien in einem Webmodul bei einem Neustart der Anwendung erneut kompiliert werden müssen, weil die verwendete JSF-Implementierung geändert wurde. Nach dem Neustart der Anwendung wird beim nächsten Zugriff auf eine JSP-Datei für dieses Modul die JSP-Datei für die über die Administrationskonsole ausgewählte Implementierung von JSF erneut kompiliert. Nachfolgende Aufrufe der JSP-Datei bewirken keine Neukompilierung. Die Standardeinstellung für diese Option ist "false". Verwenden Sie diese Option für Entwicklungsumgebungen und nicht in Produktionsumgebungen. Nicht zutreffend

Sun-RI-Kontextparameter mit entsprechendem Verhalten in MyFaces

Tabelle 3. Sun-RI-Kontextparameter und das entsprechende MyFaces-Verhalten. Die folgende Tabelle enthält Parameternamen für SUN RI und ihre Entsprechungen in MyFaces:
Parametername in SUN RI Beschreibung RI-Standardwert MyFaces-Entsprechung MyFaces-Standardwert
com.sun.faces.numberOfViewsInSession Definiert die maximale Anzahl serialisierter Sichten, die in der Sitzung gespeichert werden. Funkioniert mit Speicherung des Serverstatus. 15 org.apache.myfaces.NUMBER_OF_VIEWS_IN_SESSION 20
com.sun.faces.compressViewState Wenn Sie diesen Parameter auf "true" setzen, wird die Sicht nach der Serialisierung und vor der base64-Verschlüsselung komprimiert. Funktioniert mit Speicherung des Clientstatus. Seit Version 1.2_09 betrifft diese Option auch die serverseitige Statusspeicherung, wenn "com.sun.faces.serializeServerState" auf "true" gesetzt ist (dies hat umfangreiche Auswirkungen auf die Größe der Statusinformationen in der Sitzung, was zu Lasten der CPU geht). true org.apache.myfaces.COMPRESS_STATE_IN_CLIENT für clientseitige Statusspeicherung bzw. org.apache.myfaces.COMPRESS_STATE_IN_SESSION für serverseitige Statusspeicherung false für clientseitige Statusspeicherung, true für serverseitige Statusspeicherung
com.sun.faces.validateXml Wenn Sie diesen Parameter auf "true" setzen, validiert JSF die Konfigurationsdateien. false org.apache.myfaces.VALIDATE false
com.sun.faces.injectionProvider Dieser Parameter gibt eine Klasse an, die den InjectionProvider implementiert. Nicht zutreffend Der InjectionProvider wird von der Laufzeitumgebung von WebSphere Application Server bereitgestellt. Nicht zutreffend
com.sun.faces.serializationProvider Dieser Parameter gibt eine Klasse an, die den SerializationProvider implementiert. Diese Implementierung stellt einen Hook dar, den die JSF-Implementierung verwendet, um alternative Serialization-Implementierungen zu aktivieren. Nicht zutreffend org.apache.myfaces.SERIAL_FACTORY - Die Klasse muss die SPI "org.apache.myfaces.shared_impl.util.serial.SerialFactory" anstelle von "com.sun.faces.spi.SerializationProvider" implementieren. Nicht zutreffend
com.sun.faces.enabledJSStyleHiding Wenn Sie diesen Parameter auf "true" setzen, wird Inline-JavaScript von der HTML-ResponseWriter-Implementierung so wiedergegeben, dass das Script für ältere Browserimplementierungen verborgen bleibt. false org.apache.myfaces.WRAP_SCRIPT_CONTENT_WITH_XML_COMMENT_TAG true
com.sun.faces.serializeServerState Wenn Sie diesen Parameter auf "true" setzen, wird der Komponentenstatus (nicht die Baumstruktur) serialisiert, bevor er in der Sitzung gespeichert wird. Dies kann für Anwendungen hilfreich sein, die Probleme haben, wenn der Sichtstatus sensibel auf Modelländerungen reagiert. false org.apache.myfaces.SERIALIZE_STATE_IN_SESSION true

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_jsfengine
Dateiname:rweb_jsfengine.html