Imbrication du serveur de profil Liberty dans vos applications
Vous pouvez utiliser les interfaces de programmation de système (SPI) mises à disposition par le profil Liberty pour configurer, contrôler et surveiller un serveur de profil Liberty dans vos applications.
Pourquoi et quand exécuter cette tâche
Le profil Liberty met à disposition les interfaces de programmation de système (SPI) suivantes pour démarrer ou arrêter un serveur de profil 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 est situé sous le répertoire ${rép.install.wlp}/bin/tools de l'installation du profil 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 est situé sous le répertoire ${rép.install.wlp}/bin/tools de l'installation du profil 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.