wrapper.system.library.path.<n>

Kompatibel :3.6.0
Editionen :Professional EditionStandard EditionCommunity Edition
Betriebssysteme :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Einige native Bibliotheken verweisen auf andere dynamisch verknüpfte Bibliotheken. Java lokalisiert die initiale JNI-Bibliothek über den Java-Bibliothekspfad, aber die sekundären Bibliotheken werden über den Standardmechanismus des Betriebssystems geladen.

Diese Eigenschaften werden verwendet, um eine Liste von Verzeichnissen anzugeben, in denen nach sekundären Bibliotheken gesucht wird, die über den Standardmechanismus des Betriebssystems geladen werden. Die konfigurierten Pfade gelten für alle Unterprozesse des Wrappers.

<n>-Komponente:

Jedes Element hat einen Eigenschaftsnamen, der mit "wrapper.system.library.path." beginnt, und die "<n>"-Komponente des Eigenschaftsnamens ist eine ganze Zahl, die bei "1" beginnt. Standardmäßig sollte die Nummerierung fortlaufend ohne Lücken sein. Die wrapper.ignore_sequence_gaps-Eigenschaft kann optional gesetzt werden, um Lücken in der Sequenz zuzulassen.

Beispiel:
wrapper.system.library.path.1=../lib

NOTE

Die wrapper.system.library.path.<n>-Eigenschaften wurden erstmals in Wrapper-Version 3.6.0 eingeführt. Frühere Versionen des Wrappers konnten den Pfad für sekundäre Bibliotheken durch manuelles Setzen von Umgebungsvariablen festlegen.

Unter Windows sucht das System zuerst im aktuellen Arbeitsverzeichnis (dem Speicherort von wrapper.exe), dann im Verzeichnis Windows System32 und im Windows-Verzeichnis. Schließlich wird der gesamte System-PATH durchsucht. Wenn sich beide DLLs im lib-Verzeichnis Ihrer Anwendung befinden, kann es notwendig sein, dessen Speicherort wie folgt zum Systempfad hinzuzufügen. set.PATH ist für Windows, und set.LD_LIBRARY_PATH macht die Konfigurationsdatei plattformübergreifend, sodass sie auch auf UNIX-Systemen funktioniert. macOS verwendet außerdem die Variable set.DYLD_LIBRARY_PATH.

set.PATH=..%WRAPPER_FILE_SEPARATOR%lib%WRAPPER_PATH_SEPARATOR%%PATH%
set.LD_LIBRARY_PATH=..%WRAPPER_FILE_SEPARATOR%lib%WRAPPER_PATH_SEPARATOR%%LD_LIBRARY_PATH%
set.DYLD_LIBRARY_PATH=..%WRAPPER_FILE_SEPARATOR%lib%WRAPPER_PATH_SEPARATOR%%DYLD_LIBRARY_PATH%

Beachten Sie, dass das Ablegen der sekundären Bibliothek im PATH statt im aktuellen Arbeitsverzeichnis das Risiko birgt, dass zuerst eine alte Version der Bibliothek im Verzeichnis Windows System32 gefunden wird, falls diese von einer anderen Anwendung installiert wurde. Dies liegt an der Reihenfolge, in der das System nach der Datei sucht.

Dieses Problem wurde beim Arbeiten mit den JCO-Bibliotheken von SAP beobachtet, wenn auch andere SAP-Anwendungen auf dem System installiert sind.

Plattformspezifische native Bibliotheken

Die meisten Bibliotheken erwarten, dass ihre nativen Bibliotheken auf allen Plattformen gleich benannt sind. Dies führt in der Regel dazu, dass plattformspezifische Distributionen einer Anwendung veröffentlicht werden müssen. Wenn der Bibliothekspfad jedoch wie folgt definiert wird, verweist der Wrapper zur Laufzeit dynamisch auf das korrekte plattformspezifische Verzeichnis, sodass alle unterstützten Plattformen in einer einzigen Distribution des Wrappers enthalten sein können.

Beispiel:
wrapper.system.library.path.1=../lib
wrapper.system.library.path.2=../lib/native/%WRAPPER_OS%-%WRAPPER_ARCH%-%WRAPPER_BITS%

Dies wird wie folgt aufgelöst:

Windows:
wrapper.system.library.path.1=../lib
wrapper.system.library.path.2=../lib/native/windows-x86-32
Linux:
wrapper.system.library.path.1=../lib
wrapper.system.library.path.2=../lib/native/linux-x86-32
Solaris:
wrapper.system.library.path.1=../lib
wrapper.system.library.path.2=../lib/native/solaris-sparc-32

Verweis: Bibliothek