Index

wrapper.app.property.<n>

Kompatibel :3.5.57
Editionen :Professional EditionStandard EditionCommunity Edition
Betriebssysteme :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Liste der anwendungsspezifischen Eigenschaften, die vom Wrapper über ein Backend-Pipe oder ein Socket an die JVM geschickt werden, sobald die Verbindung hergestellt wurde.

Die Benutzeranwendung wird gestartet, nachdem alle Eigenschaften empfangen und Java-seits eingestellt wurden. Dadurch wird sichergestellt, dass bei Start der Anwendung alle Eigenschaften verfügbar sind.

Es ist sicherer, die Eigenschaften wrapper.app.property.<n> zu verwenden, als wrapper.java.additional.<n> einzurichten, wodurch sie für Prozessauflistungstools in Klartext dargestellt werden. Wir empfehlen daher dringend, für Passwörter und sensible Daten Anwendungseigenschaften zu verwenden, die von Ihrer Anwendung verwendet werden.

Um die in Ihrer Konfigurationsdatei gespeicherten Daten zu schützen, ist es ein bewährtes Vorgehen, die Eigenschaften wrapper.app.property.<n>, welche die sensiblen Daten enthalten, in einer separaten "Datei einschließen" zu isolieren und dieser beschränkte Leserechte zu zuweisen (z. B. nur für Admin oder Eigentümer).

Verwenden Sie bitte zusätzlich die Syntax %...|mask%, um zu verhindern, dass Passwörter oder sensible Daten in der Wrapper-Log-Ausgabe als Klartext gedruckt werden.

<n> Komponente:
Jedes Element hat einen Eigenschaftsnamen, der mit "wrapper.app.property." beginnt und die "<n>"-Komponente des Eigenschaftsnamen ist eine Integer-Zahl, die von "1" hochzählt. Standardmäßig sollte das Nummerieren aufeinanderfolgend und lückenlos sein". Die Eigenschaft wrapper.ignore_sequence_gaps kann optional so eingestellt werden, dass Lücken in der Reihenfolge zugelassen werden.

Beispiel:
wrapper.app.property.1=mypassword=%secret|mask%

WARNING

Im Gegensatz zu Eigenschaften, die über die Java-Befehlszeile eingestellt werden und verfügbar sind, sobald die JVM gestartet wird, sind diese Eigenschaften erst eingestellt, wenn sie durch die vom Wrapper erstellten Backend-Kanäle empfangen werden. Eigenschaften, die mit wrapper.app.property.<n> referenziert werden, sind daher nur für die Verwendung innerhalb des Kontextes Ihrer Java-Anwendung vorgesehen.

Es werden mehrere System-Klassen geladen, bevor der Backend-Kanal erstellt wird. Soll eine Systemeigenschaft von einer dieser Klassen verwendet werden, muss sie in wrapper.java.additional.<n> referenziert werden, damit sie als Befehlszeilenargument übergeben wird.

wrapper.app.property.<n>.java_version.min

Kompatibel :3.5.57
Editionen :Professional EditionStandard EditionCommunity Edition (Not Supported)
Betriebssysteme :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Diese Eigenschaft kann nur verwendet werden, um die Eigenschaft mit Index 'n' anzuhängen, wenn die Java-Version größer oder gleich dem angegebenen Wert ist.

Der Standardwert ist '1.4'. Dies ist die älteste vom Wrapper unterstützte JVM-Version. Jeder niedrigere Wert ist ungültig und sorgt dafür, dass der Wrapper beendet wird.

Der Wert kann, unabhängig von der Java-Version, in den Formaten '1.major[.minor[_revision]]' oder 'major[.minor[.revision]]' sein. Auf diese Weise werden beide Nummerierungssysteme unterstützt, die von 'java -version' ausgegeben werden: vor Java 9 wurde das erste Format verwendet, wohingegen Java 9 und neuere Versionen das zweite Format verwenden.

Die Klammern zeigen an, dass die Nebenbestandteil- und Revisionskomponenten optional sind. Werden eine oder beide nicht angegeben, bedeutet dies, dass diese Platzhalter jede Zahl akzeptieren.

Die Option mit Index 'n' wird für jede Java-Version niedriger als 1.7 ignoriert:
wrapper.app.property.<n>.java_version.min=1.7
Die Option mit Index 'n' wird für jede Java-Version niedriger als 8.0.40 ignoriert:
wrapper.app.property.<n>.java_version.min=8.0.40

WARNING

wrapper.app.property.<n>.java_version.max

Kompatibel :3.5.57
Editionen :Professional EditionStandard EditionCommunity Edition (Not Supported)
Betriebssysteme :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Diese Eigenschaft kann nur verwendet werden, um die Eigenschaft mit Index 'n' hinzuzufügen, wenn die Java-Version niedriger oder gleich dem angegebenen Wert ist.

Der Standardwert ist 'UNLIMITED'.

Der Wert kann im Format '1.major[.minor[_revision]]' oder 'major[.minor[.revision]]' sein, unabhängig von der Java-Version. Auf diese Weise werden beide Nummerierungssysteme unterstützt, die von 'java -version' ausgegeben werden: vor Java-Version 9 wurde das erste Format benutzt, seit Version 9 das zweite Format.

Die Klammern zeigen an, dass die Nebenbestandteil- und Revisionskomponenten optional sind. Werden eine oder beide nicht angegeben, bedeutet dies, dass diese Platzhalter jede Zahl akzeptieren.

Die Option mit Index 'n' wird für alle Java-Versionen über 9.0.1 ignoriert:
wrapper.app.property.<n>.java_version.max=9.0.1
Die Option mit Index 'n' wird für alle Java-Versionen über 9 ignoriert:
wrapper.app.property.<n>.java_version.max=9

WARNING

wrapper.app.property_file

Kompatibel :3.5.57
Editionen :Professional EditionStandard EditionCommunity Edition
Betriebssysteme :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

In bestimmten Fällen kann es unpraktisch sein, Ihre Anwendungseigenschaften in der Wrapper-Konfigurationsdatei aufzulisten. Diese Eigenschaft bietet eine Möglichkeit, eine Datei zu spezifizieren, die eine oder mehrere Eigenschaften enthalten kann, die an Ihre Java-Anwendung weitergegeben werden. Dies kann sehr nützlich sein, wenn die Eigenschaftenliste dynamisch oder über ein Installationsprogramm generiert werden muss.

Parameterdateiformat:

Das Dateiformat ist einfach.

  • Es muss mit einer Zeile mit Kodierungsanweisung beginnen, ebenso wie die Wrapper-Konfigurationsdatei. Dies ist notwendig, damit dem Wrapper mitgeteilt wird, welche Kodierung beim Lesen der Datei verwendet werden muss. Wenn diese Zeile fehlt, wird der Wrapper versuchen fortzufahren, nachdem eine Warnung geloggt wurde. Die in dieser Datei verwendete Kodierung kann von der in anderen Konfigurationsdateien verwendeten Kodierung abweichen.
  • Im Gegensatz zu wrapper.java.additional_file und wrapper.app.parameter_file kann diese Datei nur eine Eigenschaft pro Zeile enthalten.
  • Das '#'-Zeichen wird als Zeichen für einen Kommentar interpretiert. Um ein '#'-Zeichen in einen Eigenschaftenwert einzuschließen, muss der Wert entweder in Anführungsstrichen stehen ("#") oder durch ein zweites '#'-Zeichen getrennt werden.
Beispiel der Parameterdatei UTF-8:
#encoding=UTF-8
# Einige Eigenschaften
prop1=value
prop2=value mit Leerzeichen

wrapper.app.property_file.required

Kompatibel :3.5.57
Editionen :Professional EditionStandard EditionCommunity Edition
Betriebssysteme :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Gibt an, ob die Eigenschaftendatei erforderlich ist oder nicht. Wenn sie erforderlich ist und nicht gefunden wird, beendet sich der Wrapper ohne die JVM zu starten. Wenn sie nicht erforderlich ist, wird die Datei ignoriert, wenn sie nicht gefunden wird.

Der Standardwert ist TRUE.

Beispiel:
wrapper.app.property_file.required=FALSE

Verweis: Parameter