Utilisez l'assistant Nouveau servlet SIP pour créer un servlet SIP (Session Initiation Protocol). Un servlet SIP est un composant d'application Java qui effectue des notifications SIP et est exécuté par un serveur d'applications SIP compatible Java.
Avant de commencer
Avant de créer un servlet SIP, vous devez effectuer les tâches suivantes :
- Créez un projet SIP.
- Accédez à la perspective de développement Web.
Conseil : [WebSphere Application Server Traditional]Pour les projets SIP destinés à
WebSphere Application Server, sur la page de préférences SIP (), vérifiez que l'option Toujours mettre à jour les descripteurs de déploiement est sélectionnée de sorte que le descripteur de déploiement Web (web.xml) soit mis à jour avec le nouveau servlet que vous créez.
Procédure
Pour créer un servlet SIP :
- Dans la vue Explorateur d'entreprise, cliquez avec le bouton droit sur le projet dans lequel vous souhaitez ajouter un servlet SIP, puis cliquez sur .
- Ouvrez le dossier SIP, cliquez sur Servlet SIP, puis cliquez sur Suivant.
- Sur la première page de l'assistant, entrez un package Java™ et un nom de classe ou sélectionnez une classe de servlet ou un fichier JSP existant, puis cliquez sur Suivant.
En règle générale, la superclasse par défaut est javax.servlet.sip.SipServlet.
- Sur la deuxième page de l'assistant, entrez les informations de déploiement telles que la description, les paramètres d'initialisation et les éventuels mappages de servlet.Pour les servlets SIP 1.1, vous pouvez choisir
d'Utiliser ce servlet comme servlet principal. Cliquez sur Suivant.
Conseil : Vous pouvez modifier les informations de déploiement ultérieurement à l'aide de l'éditeur de descripteur de déploiement.
Important : Les informations suivantes s'appliquent lorsque vous créez un servlet SIP
dans un projet SIP 1.1 avec facettes Web 3.0 ou version ultérieure :
- Tous les servlets créés par l'assistant comportent l'annotation @SipServlet.
- Si vous sélectionnez Utiliser ce servlet comme servlet principal, WebSphere Developer
Tools crée un servlet SIP annoté et un fichier package-info.java. Ce fichier contient la configuration
@SipApplication pour le servlet principal. Si vous lancez à nouveau l'assistant
Créer un servlet SIP, vous ne pouvez pas spécifier d'options de sélection de servlet
vu qu'un seul servlet principal peut exister dans une application SIP.
- Si vous sélectionnez Specify Servlet Mappings, WebSphere Developer Tools crée un servlet
SIP non annoté, puis le configure dans le fichier sip.xml.
- Sur la dernière page de l'assistant, indiquez les modificateurs, les interfaces et les modules de remplacement de méthode à générer, puis cliquez sur Terminer.
- Si vous êtes invité à mettre à jour le descripteur de déploiement Web, cliquez sur Oui.
Conseil : [WebSphere Application Server Traditional] Pour les projets SIP destinés à WebSphere Application Server, si vous cliquez sur Non ou si vous avez désactivé la préférence consistant à systématiquement mettre à jour les descripteurs de déploiement, vous pouvez mettre à jour le fichier descripteur de déploiement Web (web.xml) ultérieurement. (Cliquez avec le bouton droit sur le fichier sip.xml, puis cliquez sur ).
Résultats
L'assistant crée le nouveau servlet dans le dossier source indiqué et l'ouvre dans l'éditeur Java.