wrapper.java.library.path.append_system_path
Compatibilité :3.1.0 (Removed in version 3.7.0)
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

AVERTISSEMENT

Cette propriété n'est plus prise en charge depuis la version 3.7.0. Ce changement s'aligne sur le comportement de Java 7+, qui n'ajoute plus le chemin de recherche des bibliothèques natives par défaut du système à java.library.path.

Les emplacements contenant des bibliothèques natives chargées directement par le code Java doivent désormais être définis explicitement à l'aide des propriétés wrapper.java.library.path.<n>. L'utilisation de wrapper.java.library.path.append_system_path entraînera désormais une erreur de configuration invalide et empêchera le Wrapper de continuer. Cela garantit que les bibliothèques sont chargées uniquement depuis des emplacements prévus et stables.

Le Java Service Wrapper inclut un composant de bibliothèque native, et nécessite donc que l'emplacement de cette bibliothèque soit spécifié en le transmettant à la JVM à l'aide de la propriété système java.library.path.

Normalement, lorsque Java est lancé et qu'aucun chemin de bibliothèque n'est spécifié, la JVM utilisera par défaut le PATH système sous Windows et LD_LIBRARY_PATH sous UNIX pour localiser les bibliothèques natives chargées par l'application. Cela s'apparente à ce qui se produit avec la variable d'environnement CLASSPATH lorsqu'aucun classpath spécifique n'est spécifié au lancement de la JVM. L'utilisation de la variable d'environnement CLASSPATH est tombée en désuétude en raison de tous les problèmes de conflits pouvant survenir lorsque plusieurs applications Java sont installées sur la même machine. Les mêmes problèmes existent également avec le chemin des bibliothèques. Cependant, certaines applications utilisent encore par défaut le PATH système ou LD_LIBRARY_PATH.

En général, il est conseillé d'éviter les problèmes potentiels lors du déploiement de votre application en étant prudent quant aux répertoires qui seront inclus dans le chemin des bibliothèques Java. Cependant, s'il est nécessaire de parcourir l'intégralité du PATH, cette propriété fera en sorte que le Wrapper ajoute le contenu du PATH système ou de LD_LIBRARY_PATH au chemin des bibliothèques Java utilisé pour lancer la JVM. Il est ajouté à la fin plutôt qu'au début afin que les répertoires configurés à l'aide des propriétés wrapper.java.library.path.<n> aient la priorité. La valeur par défaut est « FALSE ».

Exemple : 
wrapper.java.library.path.append_system_path=FALSE

NOTE

Certaines bibliothèques natives font référence à d'autres bibliothèques liées dynamiquement. Java localisera la bibliothèque JNI initiale à l'aide du chemin des bibliothèques Java, mais les bibliothèques secondaires sont chargées à l'aide du mécanisme par défaut de la plateforme.

Veuillez utiliser les propriétés wrapper.system.library.path.<n> pour configurer les chemins où se trouvent les bibliothèques secondaires.

Référence : Bibliothèque