La première étape pour transformer notre classe HelloWorldServer en service consiste à configurer le Java Service Wrapper afin d'exécuter notre application. Pour la majorité des applications, cela peut être fait sans écrire de code Java.

%EXAMPLE_HOME%\
%EXAMPLE_HOME%\bin\
%EXAMPLE_HOME%\conf\
%EXAMPLE_HOME%\lang\
%EXAMPLE_HOME%\lib\
%EXAMPLE_HOME%\lib\classes\
%EXAMPLE_HOME%\logs\

Veuillez télécharger la dernière version du Java Service Wrapper pour votre système d'exploitation depuis la page Téléchargement, puis extraire l'archive dans un répertoire de votre choix. Nous appellerons le répertoire extrait %WRAPPER_HOME%.

Le Java Service Wrapper se compose de trois composants principaux. Le binaire Wrapper, un fichier jar et une bibliothèque native utilisée par le fichier jar. Veuillez copier ces trois fichiers comme suit :

%WRAPPER_HOME%\bin\wrapper.exe -> %EXAMPLE_HOME%\bin\wrapper.exe
%WRAPPER_HOME%\lib\wrapper.jar -> %EXAMPLE_HOME%\lib\wrapper.jar
%WRAPPER_HOME%\lib\wrapper.dll -> %EXAMPLE_HOME%\lib\wrapper.dll

Le Wrapper peut être contrôlé directement ou à l'aide de fichiers batch. Ces fichiers sont décrits en détail sur la page Lancement sous Windows. Dans cet exemple, nous exécuterons le Wrapper directement.

Internationalisation / Localisation :

Si vous souhaitez utiliser le Wrapper dans une langue autre que l'anglais, veuillez copier les ressources de localisation en copiant l'intégralité du répertoire lang.

%WRAPPER_HOME%\lang -> %EXAMPLE_HOME%\lang

Clé de licence :

Les éditions Standard et Professional du Java Service Wrapper nécessitent une clé de licence pour pouvoir s'exécuter. Le Wrapper est livré avec une clé de licence simple qui vous permettra d'exécuter le Wrapper pendant 15 minutes. Veuillez la copier pour le moment. Vous pouvez obtenir une licence d'essai à long terme en cliquant sur le bouton Essai gratuit en haut de la page.

%WRAPPER_HOME%\src\conf\wrapper-license-time.conf -> %EXAMPLE_HOME%\conf\wrapper-license.conf

Fichier de configuration du Wrapper :

Enfin, copiez le fichier de configuration par défaut du Wrapper. Nous le modifierons dans la section suivante.

%WRAPPER_HOME%\src\conf\wrapper.conf.in -> %EXAMPLE_HOME%\conf\wrapper.conf

Ouvrez le fichier %EXAMPLE_HOME%\conf\wrapper.conf dans l'éditeur de texte de votre choix. Le Bloc-notes conviendra parfaitement.

Veuillez localiser et modifier les propriétés suivantes.

wrapper.java.command=java
wrapper.java.command.loglevel=INFO

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
wrapper.app.parameter.1=HelloWorldServer

wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=../lib/classes

wrapper.java.library.path.1=../lib

wrapper.logfile=../logs/wrapper.log

wrapper.console.title=Hello World Server
wrapper.name=helloworldserver
wrapper.displayname=Hello World Server
wrapper.description=Hello World Server

• La propriété wrapper.java.command est utilisée pour spécifier l'emplacement de la commande Java qui sera utilisée. La valeur que nous avons spécifiée sera recherchée dans le chemin système. Il est également possible de spécifier un chemin absolu.

• La propriété wrapper.java.command.loglevel est facultative, mais elle est utile pour déboguer la ligne de commande Java générée par le Wrapper. Nous vous recommandons de l'inclure au début, mais elle peut être commentée une fois que votre application fonctionne.

• La propriété wrapper.java.mainclass est utilisée pour spécifier la classe principale transmise à Java lors de son lancement. C'est un point de confusion pour les nouveaux utilisateurs, mais dans la plupart des cas, il s'agira de l'une des classes d'aide du Wrapper plutôt que de la classe principale de votre application. Le Wrapper prend en charge plusieurs méthodes d'intégration, mais pour cet exemple, nous utilisons la méthode la plus simple appelée Méthode d'intégration n°1 (WrapperSimpleApp). Cette méthode utilise la classe d'aide org.tanukisoftware.wrapper.WrapperSimpleApp pour gérer le cycle de vie de la JVM et la communication avec le Wrapper. Pour l'instant, ne vous préoccupez pas de ce point.

• La classe principale réelle de notre application HelloWorldServer est transmise en tant que premier paramètre à l'aide de la propriété wrapper.app.parameter.1. Il est possible de transmettre des paramètres supplémentaires à HelloWorldServer en ajoutant des propriétés supplémentaires avec des index croissants wrapper.app.parameter.2=P1, par exemple.

  Nous ne les montrons pas ici, mais il est également possible d'ajouter des paramètres Java supplémentaires à l'aide des propriétés wrapper.java.additional.<n>.

• L'étape suivante consiste à spécifier le classpath. Cela se fait à l'aide des propriétés wrapper.java.classpath.<n>. Nous avons besoin de deux entrées de classpath pour notre application. La première consiste à inclure le fichier wrapper.jar requis, qui contient les classes d'aide du Wrapper. La seconde inclut le répertoire lib/classes où se trouve notre classe HelloWorldServer.

• Le Wrapper utilise une bibliothèque native, wrapper.dll, pour implémenter certaines de ses fonctionnalités. Les bibliothèques natives ne sont pas utilisées par de nombreuses applications Java, il se peut donc que vous ne les ayez jamais rencontrées. Les propriétés wrapper.java.library.path.<n> sont utilisées pour spécifier l'emplacement de ces bibliothèques. Pour l'instant, ne vous préoccupez pas de ce point.

Nous avons maintenant indiqué au Wrapper comment exécuter notre application Java.

Il ne reste plus que quelques propriétés à configurer.

• La propriété wrapper.logfile est utilisée pour indiquer au Wrapper où écrire son fichier journal.

• Les propriétés wrapper.console.title, wrapper.name, wrapper.displayname, wrapper.description et wrapper.ntservice.starttype seront utilisées lorsque nous installerons le Wrapper en tant que service afin de définir le nom et la description du service.

Un point important à noter concernant toutes les valeurs de propriétés est qu'elles sont toujours spécifiées avec des chemins qui sont relatifs à l'emplacement du binaire wrapper.exe.

Outre les propriétés que nous configurons, il existe quelques autres éléments clés du fichier de configuration dont vous devez avoir connaissance.

• Le haut du fichier contient un encodage pour le fichier.

• La ligne @include ../conf/wrapper-license.conf utilise la fonctionnalité de fichier d'inclusion pour inclure les propriétés de la clé de licence. Notez que le # initial est obligatoire.

• La propriété wrapper.lang.folder est utilisée pour spécifier l'emplacement des fichiers de localisation du Wrapper.

Cela peut se faire en utilisant la commande -i du Wrapper comme suit.

bin\wrapper.exe -i ..\conf\wrapper.conf

Vous devriez voir quelque chose comme ce qui suit, confirmant que le service a été installé.

wrapper  | Hello World Server service installed.

Vous pouvez maintenant démarrer votre service comme n'importe quel autre service Windows. Cela peut se faire depuis le Panneau de configuration des services Windows [Panneau de configuration] - [Outils d'administration] - [Services].

La commande Windows net start peut également être utilisée :

net start helloworld

Il est également possible de démarrer le Wrapper à l'aide du binaire Wrapper comme suit :

bin\wrapper.exe -t ..\conf\wrapper.conf

Dans ce cas, vous verrez :

wrapper  | Starting the Hello World Server service...
wrapper  | Hello World Server started.

Vous pouvez maintenant confirmer que le service est en cours d'exécution en consultant le Panneau de configuration des services [Panneau de configuration] - [Outils d'administration] - [Services], le Gestionnaire des tâches et le fichier WRAPPER_HOME\logs\wrapper.log.

Lorsque vous êtes prêt à arrêter le service, vous pouvez le faire comme ci-dessus, ou en utilisant le Wrapper lui-même :

bin\wrapper.exe -p ..\conf\wrapper.conf

Le Wrapper est actuellement configuré pour redémarrer lorsque votre système est redémarré. Comme il s'agit d'un test, vous souhaiterez probablement supprimer le service comme suit :

bin\wrapper.exe -r ..\conf\wrapper.conf