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
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.
Sie setzen die Eigenschaft
org.apache.el.parser.COERCE_TO_ZERO mit der Administrationskonsole.
|
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
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
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 |