Imbrication du serveur Liberty dans vos applications
Vous pouvez utiliser les interfaces de programmation de système (SPI) fournies par Liberty pour configurer, contrôler et surveiller un serveur Liberty dans vos applications.
Pourquoi et quand exécuter cette tâche
Liberty fournit les interfaces de programmation de système (SPI) suivantes pour démarrer ou arrêter un serveur Liberty :
- com.ibm.wsspi.kernel.embeddable.Server
- com.ibm.wsspi.kernel.embeddable.ServerBuilder
De plus, vous pouvez recevoir des notifications asynchrones lorsque le serveur démarre, a démarré ou s'est arrêté, en créant votre propre classe qui implémente l'interface com.ibm.wsspi.kernel.embeddable.ServerEventListener.
Remarque : Pour créer une instance de serveur imbriqué dans votre application, vous devez procéder comme suit :
- Incluez le fichier ws-server.jar dans le chemin d'accès aux classes. Le fichier ws-server.jar se trouve dans le répertoire ${rép.install.wlp}/bin/tools de l'installation Liberty.
- Spécifiez le nom du serveur cible. Ce serveur doit exister.
- Facultatif : Configurez le fichier ws-javaagent.jar avec l'option JVM -javaagent. Le fichier ws-javaagent.jar se trouve dans le répertoire ${rép.install.wlp}/bin/tools de l'installation Liberty. Il est recommandé de configurer le fichier ws-javaagent.jar, mais ceci n'est pas obligatoire si vous n'utilisez pas de fonctions du serveur qui l'exigent, comme le contrôle ou le traçage. Si vous devez contacter le support IBM®, des informations de trace vous seront peut-être réclamées, auquel cas vous devrez démarrer le serveur avec le fichier ws-javaagent.jar, même si vous ne l'utilisez pas habituellement.
Remarque : Dans un environnement imbriqué :
- Les variables d'environnement ne sont pas vérifiées et les fichiers jvm.options et server.env ne sont pas lus.
- La gestion de la machine virtuelle Java et de l'environnement est censée être assurée par l'appelant.