• propriété wrapper.app.property.<n>
• propriété wrapper.app.property.<n>.quotable
• propriété wrapper.app.property.<n>.java_version.min
• propriété wrapper.app.property.<n>.java_version.max
• propriété wrapper.app.property_file
• propriété wrapper.app.property_file.required
• propriété wrapper.app.property_file.quotable

Compatibilité :	3.5.57
Éditions :
Plateformes :

Liste de propriétés spécifiques à l'application qui sont envoyées du Wrapper à la JVM via le pipe ou socket backend une fois la connexion établie.

L'application utilisateur sera lancée une fois que toutes les propriétés auront été reçues et définies côté Java. Cela garantit que toutes les propriétés seront disponibles au démarrage de l'application.

L'utilisation des propriétés wrapper.app.property.<n> est plus sécurisée que de définir wrapper.java.additional.<n>, qui les exposent en clair aux outils de listage des processus. Pour cette raison, il est fortement recommandé d'utiliser les propriétés d'application pour les mots de passe ou toute donnée sensible que votre application pourrait utiliser.

Pour protéger les données stockées dans votre fichier de configuration, une bonne pratique consiste à isoler les propriétés wrapper.app.property.<n> contenant des valeurs sensibles dans un « fichier include » distinct et à lui attribuer des permissions de lecture restrictives (p. ex. administrateur ou propriétaire uniquement).

De plus, pour empêcher que les mots de passe ou les données sensibles ne s'affichent en clair dans la sortie du journal du Wrapper, veuillez utiliser la syntaxe %...|mask%.

Composant <n> :

Chaque élément possède un nom de propriété commençant par « wrapper.app.property. » et le composant « <n> » du nom de propriété est un nombre entier incrémenté à partir de « 1 ». Par défaut, la numérotation doit être séquentielle, sans lacune. La propriété wrapper.ignore_sequence_gaps peut éventuellement être définie pour autoriser des lacunes dans la séquence.

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

Compatibilité :	3.6.0
Éditions :
Plateformes :

Si la valeur d'une propriété doit inclure des espaces de fin, vous pouvez les conserver en entourant la valeur de guillemets. Ces guillemets seront supprimés si vous définissez la propriété correspondante wrapper.app.property.<n>.quotable à TRUE.

La valeur par défaut de cette propriété est « FALSE ».

Lorsqu'une propriété « quotable » est définie à TRUE, les guillemets réellement à conserver dans la valeur correspondante doivent alors être échappés avec un caractère « \ », et les barres obliques inverses doivent être doublées (« \\ »). Aucun autre caractère ne peut être échappé.

Les remplacements suivants seront effectués lors de la suppression des guillemets.

• '\\' deviendra '\',
• '\"' deviendra '"'
• '"' deviendra ''

wrapper.app.property.1=prop1="value with trailing spaces   "
wrapper.app.property.1.quotable=TRUE

Compatibilité :	3.5.57
Éditions :
Plateformes :

Cette propriété peut être utilisée pour ajouter la propriété d'index « n » uniquement si la version de Java est supérieure ou égale à la valeur spécifiée.

La valeur par défaut est « 1.4 », qui correspond à la plus ancienne version de JVM prise en charge par le Wrapper. Toute valeur inférieure est invalide et entraînera l'arrêt du Wrapper.

La valeur peut être au format « 1.major[.minor[_revision]] » ou « major[.minor[.revision]] », quelle que soit la version de Java. Cela permet de prendre en charge les deux schémas de numérotation renvoyés par « java -version » : avant Java 9, le premier format était utilisé, tandis que Java 9 et versions ultérieures utilisent le second format.

Les crochets indiquent que les composants mineur et de révision sont facultatifs. Laisser l'un ou les deux non spécifiés signifie que ces espaces réservés accepteront n'importe quel nombre.

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

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

Compatibilité :	3.5.57
Éditions :
Plateformes :

Cette propriété peut être utilisée pour ajouter la propriété d'index « n » uniquement si la version de Java est inférieure ou égale à la valeur spécifiée.

La valeur par défaut est « UNLIMITED ».

La valeur peut être au format « 1.major[.minor[_revision]] » ou « major[.minor[.revision]] », quelle que soit la version de Java. Cela permet de prendre en charge les deux schémas de numérotation renvoyés par « java -version » : avant Java 9, le premier format était utilisé, tandis que Java 9 et versions ultérieures utilisent le second format.

Les crochets indiquent que les composants mineur et de révision sont facultatifs. Laisser l'un ou les deux non spécifiés signifie que ces espaces réservés accepteront n'importe quel nombre.

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

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

Compatibilité :	3.5.57
Éditions :
Plateformes :

Cette propriété permet de spécifier un fichier pouvant contenir une ou plusieurs propriétés à transmettre à l'application Java. Cela peut s'avérer très utile lorsque la liste des propriétés doit être générée dynamiquement ou via un installateur.

Toute propriété définie dans ce fichier apparaîtra après celles définies à l'aide des propriétés standard wrapper.app.property.<n>.

À partir de la version 3.5.23 du Wrapper, toute référence à une variable d'environnement dans le fichier sera développée.

Format du fichier :

Le format du fichier est simple.

• Il doit commencer par une ligne de directive d'encodage tout comme le fichier de configuration du Wrapper. Cela est nécessaire pour indiquer au Wrapper quel encodage utiliser lors de la lecture du fichier. Si cette ligne est absente, le Wrapper tentera de poursuivre après avoir consigné un avertissement. L'encodage utilisé dans le fichier peut être différent de celui utilisé dans les autres fichiers de configuration.
• Le caractère « # » est interprété comme un caractère de commentaire. Pour inclure un caractère « # » dans une valeur de propriété, la valeur doit soit être entre guillemets ("#"), soit être échappée par un second caractère « # ».
• Par défaut, une seule propriété peut être écrite par ligne. Ce comportement peut être modifié en définissant la propriété wrapper.app.property_file.quotable à TRUE. Dans ce mode, les arguments sont délimités par tout espace non entre guillemets. Cela permet de lister plusieurs paramètres sur la même ligne. Les valeurs contenant des espaces doivent être entourées de guillemets ; ces guillemets seront supprimés lors de l'analyse du fichier.

@encoding=UTF-8
# Example properties: One property per line
prop1=Value1
prop2=Value2 with space
prop3=Value3 with space
prop4=Value4

@encoding=UTF-8
# Example properties: Multiple properties in one line
prop1=Value1 prop2="Value2 with space" "prop3=Value3 with space"

# More arguments
prop4=Value4

Compatibilité :	3.5.57
Éditions :
Plateformes :

Indique si le fichier de propriétés est requis ou non. S'il est requis et introuvable, le Wrapper s'arrêtera sans démarrer la JVM. S'il n'est pas requis, le fichier sera ignoré s'il est introuvable.

La valeur par défaut est TRUE.

wrapper.app.property_file.required=FALSE

Compatibilité :	3.6.0
Éditions :
Plateformes :

Lorsqu'elle est définie à TRUE, les guillemets contenus dans le fichier de propriétés seront supprimés. Cela vous permet d'utiliser les guillemets comme délimiteurs pour les valeurs et ainsi de lister plusieurs paramètres sur une seule ligne.

De plus, les guillemets peuvent être utilisés comme délimiteurs pour conserver les espaces en début ou en fin de valeur des propriétés.

La valeur par défaut de cette propriété est « FALSE ».

Lorsqu'une propriété « quotable » est définie à TRUE, les guillemets réellement à conserver dans la valeur correspondante doivent alors être échappés avec un caractère « \ », et les barres obliques inverses doivent être doublées (« \\ »). Aucun autre caractère ne peut être échappé.

Les remplacements suivants seront effectués lors de la suppression des guillemets.

• '\\' deviendra '\',
• '\"' deviendra '"'
• '"' deviendra ''

wrapper.app.property_file.quotable=TRUE

@encoding=UTF-8
prop1=Value1 prop2="Test Value with spaces."

• wrapper.app.parameter.<n> (1.0.0)

  Définit les paramètres de votre application Java.

• wrapper.app.parameter.<n>.quotable (3.6.0)

  Permet d'utiliser des guillemets comme délimiteurs dans les paramètres d'application.

• wrapper.app.parameter.backend (3.6.0)

  Permet de transmettre les paramètres d'application via le backend plutôt que par la ligne de commande.

• wrapper.app.parameter_file (3.5.17)

  Spécifie le chemin du fichier de paramètres, qui contient les arguments utilisés au démarrage de l'application.

• wrapper.app.parameter_file.quotable (3.6.0)

  Permet d'utiliser des guillemets comme délimiteurs pour les valeurs listées dans le fichier de paramètres.

• wrapper.app.parameter_file.required (3.5.17)

  Spécifie si le fichier de paramètres est requis ou non.

• wrapper.app.stop.parameter.<n> (3.7.0)

  Définit les paramètres utilisés lors de l'arrêt de l'application.

• wrapper.app.stop.parameter.<n>.quotable (3.7.0)

  Permet d'utiliser des guillemets comme délimiteurs dans les paramètres d'arrêt de l'application.

• wrapper.app.stop.parameter_file (3.7.0)

  Spécifie le chemin du fichier de paramètres d'arrêt, qui contient les arguments utilisés lors de l'arrêt de l'application.

• wrapper.app.stop.parameter_file.quotable (3.7.0)

  Permet d'utiliser des guillemets comme délimiteurs pour les valeurs listées dans le fichier de paramètres d'arrêt.

• wrapper.app.stop.parameter_file.required (3.7.0)

  Spécifie si le fichier de paramètres d'arrêt est requis ou non.

• wrapper.app.property.<n> (3.5.57)

  Configure des propriétés spécifiques à l'application à envoyer via un pipe ou un socket.

• wrapper.app.property.<n>.java_version.min (3.5.57) ( Standard/Professionnel )  ⇧

  Ajoute la propriété d'application d'index 'n' uniquement si la version de Java est supérieure ou égale à la valeur spécifiée.

• wrapper.app.property.<n>.java_version.max (3.5.57) ( Standard/Professionnel )  ⇧

  Ajoute la propriété d'application d'index 'n' uniquement si la version de Java est inférieure ou égale à la valeur spécifiée.

• wrapper.app.property.<n>.quotable (3.6.0)  ⇧

  Permet d'utiliser des guillemets comme délimiteurs dans les propriétés d'application.

• wrapper.app.property_file (3.5.57)  ⇧

  Spécifie le chemin du fichier de propriétés, qui contient les propriétés système destinées à l'application.

• wrapper.app.property_file.quotable (3.6.0)  ⇧

  Permet d'utiliser des guillemets comme délimiteurs pour les valeurs listées dans le fichier de propriétés.

• wrapper.app.property_file.required (3.5.57)  ⇧

  Spécifie si le fichier de propriétés est requis ou non.

• wrapper.java.additional.<n> (1.0.0)

  Configure des paramètres supplémentaires à transmettre à la JVM.

• wrapper.java.additional.<n>.java_version.max (3.5.36) ( Standard/Professionnel )

  Ajoute l'option d'index 'n' uniquement si la version de Java est inférieure ou égale à la valeur spécifiée.

• wrapper.java.additional.<n>.java_version.min (3.5.36) ( Standard/Professionnel )

  Ajoute l'option d'index 'n' uniquement si la version de Java est supérieure ou égale à la valeur spécifiée.

• wrapper.java.additional.<n>.quotable (3.6.0)

  Permet d'utiliser des guillemets comme délimiteurs dans les paramètres JVM.

• wrapper.java.additional_file (3.5.16)

  Spécifie le chemin du fichier additionnel, qui contient les options à transmettre à la JVM.

• wrapper.java.additional_file.quotable (3.6.0)

  Permet d'utiliser des guillemets comme délimiteurs pour les valeurs listées dans le fichier additionnel.

• wrapper.java.additional_file.required (3.5.36)

  Spécifie si le fichier additionnel est requis ou non.

• wrapper.java.mainclass (1.0.0)

  Définit la classe contenant la méthode main appelée lorsque le Wrapper démarre la JVM.

• wrapper.java.tmpdir.<x> (3.5.0)
• wrapper.java.tmpdir.required (3.5.0)

  Spécifie si le Wrapper doit se terminer lorsque le répertoire temporaire Java n'est pas accessible en écriture.

• wrapper.java.tmpdir.warn_silently (3.5.0)

  Spécifie si un message doit être journalisé au niveau DEBUG ou WARN lorsque le répertoire temporaire Java n'a pas pu être écrit.